{"uid":"cap_tlkRDf3OJf4sXI49z0IxF","slug":"vrsai-openapi-agent-readiness-assessor-5b7311bf","name":"vrsai OpenAPI Agent Readiness Assessor","description":"Assess an OpenAPI description for autonomous-agent usability.","url":"https://api.vrsai.tech/v1/capabilities/openapi_agent_readiness?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object"},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"score":100,"summary":{"paths":1,"schemas":0,"findings":0,"operations":1,"findings_truncated":false},"verdict":"ready","findings":[],"dimensions":[{"id":"structure_and_version","score":15,"max_score":15},{"id":"operation_semantics","score":20,"max_score":20},{"id":"request_contracts","score":20,"max_score":20},{"id":"response_contracts","score":20,"max_score":20},{"id":"authentication_and_access","score":10,"max_score":10},{"id":"machine_operability","score":15,"max_score":15}],"openapi_version":"3.1.0","ruleset_version":"1.1.1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7Lr_27QFz-oYQ2eLCHooF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores and audits an OpenAPI description across six dimensions to determine how well-suited it is for autonomous AI agent consumption.","exampleAgentPrompt":"Can you check if my OpenAPI spec is ready for AI agents to use? Here's the spec body as JSON — I want a score, a verdict, and a list of any issues found across structure, operation semantics, request/response contracts, auth, and machine operability.","exampleUseCases":[{"title":"Pre-publish API readiness gate","prompt":"Before I publish this OpenAPI spec to our developer portal, run it through the agent-readiness assessor and tell me the overall score, verdict, and any findings I need to fix — especially around response contracts and authentication."},{"title":"CI pipeline spec quality check","prompt":"I'm adding an automated check to our CI pipeline. Assess this OpenAPI JSON body for autonomous-agent usability and return the dimension-by-dimension scores so I can fail the build if the score drops below 80."},{"title":"Third-party API evaluation","prompt":"We're considering integrating a vendor's API into our agent workflow. Can you assess their OpenAPI description for agent readiness and tell me if it's marked 'ready', plus flag any gaps in operation semantics or machine operability?"}],"resultDescription":"Returns a numeric score (0–100), a verdict string (e.g. 'ready'), a summary of paths/operations/schemas/findings, an array of specific findings with details, and per-dimension scores for structure_and_version, operation_semantics, request_contracts, response_contracts, authentication_and_access, and machine_operability, along with the detected openapi_version and ruleset_version used.","failureModes":["Malformed or non-parseable OpenAPI body returns a validation error","Missing required 'input' object or incorrect bodyType causes a 400-level rejection","Specs with no defined paths may produce minimal scoring with low scores across most dimensions","Very large OpenAPI specs may trigger truncated findings (findings_truncated: true)","Wrong method enum value (not POST) will be rejected by input schema validation"],"whenToPreferThis":"Choose this endpoint when you need a structured, multi-dimensional, machine-readable quality score for an OpenAPI spec specifically from the perspective of autonomous agent consumption — not just syntactic validity. It is superior to generic OpenAPI linters when the goal is ensuring AI agents can reliably discover, authenticate, and call the API without human intervention.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:37:08.951Z","isFirstParty":false,"canonicalSlug":"vrsai-openapi-agent-readiness-assessor-e3ccaaa5"}