{"uid":"cap_TRJhs6XerM1OwdQwpC8ue","slug":"vrsai-openapi-agent-readiness-assessor-e3ccaaa5","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/versions/1.0.0/execute","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_BnHQMdEAXZFSdMNB-0uUy","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":"Analyzes an OpenAPI description to score and report how well-suited it is for consumption by autonomous AI agents.","exampleAgentPrompt":"Can you assess this OpenAPI spec JSON for autonomous agent usability and tell me how ready it is for AI agents to consume it?","exampleUseCases":[{"title":"Pre-launch API agent readiness audit","prompt":"Before I publish this API, can you run our OpenAPI spec through the agent readiness checker and tell me what we need to fix so AI agents can actually use it reliably?"},{"title":"Evaluating third-party API for agent integration","prompt":"I'm thinking of integrating this external API into our agent pipeline — can you assess its OpenAPI description and let me know if it's suitable for autonomous agent use?"},{"title":"Iterative spec improvement workflow","prompt":"We just updated our OpenAPI spec after last week's feedback. Can you re-evaluate it for agent usability and show me if the readiness score improved?"}],"resultDescription":"Returns a structured assessment of the OpenAPI description's suitability for autonomous agent use, including a readiness score and specific feedback on usability gaps or strengths that affect how well AI agents can discover, understand, and call the API.","failureModes":["Malformed or incomplete OpenAPI body causes validation failure","Unsupported body type (non-json/form-data/text) returns error","Missing required input fields (type, method, bodyType, body) returns 400-style error","Payment not authorized or insufficient USDC balance causes 402 rejection","Very large OpenAPI specs may time out or exceed payload limits"],"whenToPreferThis":"Choose this endpoint when you need a programmatic, objective assessment of whether an OpenAPI spec is consumable by autonomous AI agents — especially during API development, before publishing an API to an agentic marketplace, or when onboarding a third-party API into an agent pipeline. It is purpose-built for the agentic usability dimension, not general spec linting or standards compliance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:36:17.259Z","isFirstParty":false}