{"uid":"cap_R8A5b9VjUyDwSm87xbK6n","slug":"agent402-tools-openapi-agent-readiness-linter-ee0335c9","name":"agent402.tools OpenAPI Agent-Readiness Linter","description":"Score an OpenAPI 3.x or Swagger 2.x spec on agent-readiness - i.e. does an LLM-driven caller have what it needs to call the API correctly without guessing. Returns a 0..100 score, severity counts, and a structured list of violations with stable rule codes. Checks: documented title/servers/paths, per-operation summary/description/operationId/tags, documented 2xx + error responses, param descriptions/schemas/examples, response descriptions, JSON response schemas.","url":"https://agent402.tools/api/openapi-lint","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"spec":{"description":"OpenAPI/Swagger document (object or JSON string)"}}},"responseSchema":{"type":"json","example":{"ok":true,"score":97,"counts":{"info":0,"error":0,"warning":1},"violations":[{"rule":"operation-missing-operationid","message":"Operation has no operationId - agents can't refer to this call by a stable name.","location":"GET /users","severity":"warning"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_g7tsij3D4Jrmvt-jTSiHN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scores an OpenAPI 3.x or Swagger 2.x spec on LLM-agent-readiness, returning a 0–100 score, severity counts, and a structured list of violations with stable rule IDs","exampleAgentPrompt":"Can you lint this OpenAPI spec for agent-readiness and tell me the score, what severity counts look like, and exactly which rules are being violated? Here's the spec: { ... }","exampleUseCases":null,"resultDescription":"Returns a 0–100 agent-readiness score, counts of violations by severity (error/warning/info), and a structured list of individual violations each with a stable rule ID, a description of the problem, and its location in the spec — giving a clear picture of what an LLM-driven caller would struggle with.","failureModes":["Invalid or unparseable JSON/YAML spec returns a parse error","Spec missing required OpenAPI/Swagger version field may be rejected","Malformed input schema (non-object, empty body) returns a 400-level error","Swagger 1.x or non-standard formats are not supported","Network timeout on very large specs"],"whenToPreferThis":"Use this endpoint when you need to evaluate whether an API specification is suitable for consumption by LLM-driven agents — specifically when you want a structured, rule-based score rather than a generic JSON schema validator. It is purpose-built for agent-readiness concerns (missing descriptions, ambiguous parameters, unclear response schemas) rather than general OpenAPI conformance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:14:05.682Z","isFirstParty":false}