{"uid":"cap_8cVp9ZasFeTbuCzQY3e4h","slug":"agentspec-one-vercel-app-0018eed2","name":"AgentSpec OpenAPI Inspector","description":"Inspect an OpenAPI spec and return agent-readiness score, risks, recommendations, and x402 Bazaar candidates.","url":"https://agentspec-one.vercel.app/inspect/openapi","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","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}}}},"responseSchema":null,"example":{"request":{"query":"{\"openapi\": \"3.0.0\", \"info\": {\"title\": \"Test API\", \"version\": \"1.0.0\", \"description\": \"A minimal test API for agent-readiness inspection\"}, \"servers\": [{\"url\": \"https://api.example.com/v1\"}], \"paths\": {\"/items\": {\"get\": {\"summary\": \"Get items\", \"operationId\": \"getItems\", \"responses\": {\"200\": {\"description\": \"Success\", \"content\": {\"application/json\": {\"schema\": {\"type\": \"array\", \"items\": {\"type\": \"object\", \"properties\": {\"id\": {\"type\": \"integer\"}, \"name\": {\"type\": \"string\"}}}}}}}}}}}, \"components\": {\"schemas\": {}}}"},"response":{"name":"Untitled API","type":"openapi","grade":"F","risks":[],"score":11,"summary":"Untitled API has 0 inspected endpoint(s), an AgentSpec score of 11, 0 endpoint(s) below launch-ready quality, and 0 high-risk signal(s). It is ready for an x402 Bazaar metadata draft.","version":null,"warnings":["Missing `openapi` or `swagger` version.","No callable OpenAPI paths were found."],"endpoints":[],"endpointCount":0,"recommendations":["Add an explicit OpenAPI version so agents can choose the right parser.","Add `info.title` to make the service easier to identify in agent catalogs.","Add `info.description` with the API's value proposition and safe-use constraints.","Add at least one `servers` entry so agents know where to call the API.","Define at least one path operation before publishing this service."],"bazaarCandidates":[]}},"exampleRequest":{"query":"{\"openapi\": \"3.0.0\", \"info\": {\"title\": \"Test API\", \"version\": \"1.0.0\", \"description\": \"A minimal test API for agent-readiness inspection\"}, \"servers\": [{\"url\": \"https://api.example.com/v1\"}], \"paths\": {\"/items\": {\"get\": {\"summary\": \"Get items\", \"operationId\": \"getItems\", \"responses\": {\"200\": {\"description\": \"Success\", \"content\": {\"application/json\": {\"schema\": {\"type\": \"array\", \"items\": {\"type\": \"object\", \"properties\": {\"id\": {\"type\": \"integer\"}, \"name\": {\"type\": \"string\"}}}}}}}}}}}, \"components\": {\"schemas\": {}}}"},"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_Mzh86RlOVo0ygeLvju1H5","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":"Inspects an OpenAPI specification and returns an agent-readiness score, risk analysis, recommendations, and x402 Bazaar monetization candidates.","exampleAgentPrompt":"Can you inspect this OpenAPI spec and tell me its agent-readiness score, any risks I should know about, and which endpoints would make good x402 Bazaar candidates?","exampleUseCases":[{"title":"Evaluate API readiness before agent integration","prompt":"I'm about to add AI agent support to our API. Can you analyze our OpenAPI spec and tell me if there are any compatibility issues or risks we need to fix first?"},{"title":"Find monetization opportunities in existing endpoints","prompt":"We have a REST API with dozens of endpoints. Which ones would be most valuable to list on the x402 Bazaar marketplace, and what changes would make them more agent-friendly?"},{"title":"Audit spec quality for autonomous consumption","prompt":"Our API is used by humans today, but we want autonomous agents to call it reliably. Can you audit our OpenAPI definition and highlight what needs improvement for agent safety and discoverability?"}],"resultDescription":"Returns a structured report including: a numeric agent-readiness score, identified risks (e.g. missing schemas, ambiguous parameters, unsafe operations), actionable recommendations to improve agent compatibility, and a list of endpoint candidates suitable for listing on the x402 Bazaar marketplace.","failureModes":["Invalid or malformed OpenAPI spec returns a parse error","Missing required spec body returns 400 Bad Request","Spec too large may exceed processing limits","Payment not included or insufficient USDC triggers 402 Payment Required","Unsupported OpenAPI version may yield incomplete analysis"],"whenToPreferThis":"Use this endpoint when you have an OpenAPI specification and want to evaluate how well-suited it is for AI agent consumption — especially if you want to identify x402 monetization opportunities. Prefer this over the MCP inspector when the target is a REST/OpenAPI-defined API rather than an MCP tool manifest.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:35:25.474Z","isFirstParty":false}