{"uid":"cap_eNUDD2SWecYOsPFA3xlnT","slug":"agent-data-tools-revmesh2074-workers-dev-openapi-spec-summary-20b07210","name":"OpenAPI Spec Summary: Operations, Auth and Servers","description":"Read an OpenAPI 3 or Swagger 2 document (JSON or YAML, up to 2 MB) from a URL and summarise it for an agent: title, version, description, servers, auth schemes, operation count by method, tags, which operations are paid (402 or x-payment-info) or deprecated, and up to 150 operations with method, path, summary and operationId. Use before calling an unfamiliar API, to pick an endpoint, or to compare APIs.","url":"https://agent-data-tools.revmesh2074.workers.dev/openapi/summary?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","description":"URL of the OpenAPI or Swagger document"}}},"responseSchema":{"type":"object","properties":{"url":{"type":"string"},"auth":{"type":"array","items":{"type":"object","properties":{"in":{},"name":{"type":"string"},"type":{"type":"string"},"scheme":{}}}},"tags":{"type":"array","items":{"type":"string"}},"title":{"type":"string"},"format":{"type":"string"},"servers":{"type":"array","items":{"type":"string"}},"version":{"type":"string"},"byMethod":{"type":"object","properties":{"GET":{"type":"number"},"POST":{"type":"number"}}},"truncated":{"type":"boolean"},"operations":{"type":"array","items":{"type":"object","properties":{"paid":{"type":"boolean"},"path":{"type":"string"},"method":{"type":"string"},"summary":{"type":"string"},"deprecated":{"type":"boolean"},"operationId":{"type":"string"}}}},"description":{"type":"string"},"operationCount":{"type":"number"},"paidOperations":{"type":"number"},"deprecatedOperations":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U1DTM1lG-hYPgBtB-MmC2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Fetches and summarizes an OpenAPI 3 or Swagger 2 document from a URL, returning title, version, servers, auth schemes, operation counts, tags, and up to 150 operations with their metadata.","exampleAgentPrompt":"Can you summarize the OpenAPI spec at https://petstore3.swagger.io/api/v3/openapi.json — I want to know what endpoints it has, what auth it requires, and which operations might be paid or deprecated?","exampleUseCases":[{"title":"Explore an unfamiliar API before calling it","prompt":"Before I start using the Stripe API, can you fetch and summarize their OpenAPI spec at https://raw.githubusercontent.com/stripe/openapi/master/openapi/spec3.json and tell me what endpoints are available, what auth method they use, and how many operations there are?"},{"title":"Find paid or deprecated endpoints in a spec","prompt":"I'm integrating with this API — can you check https://api.example.com/openapi.yaml and tell me which of their operations are marked as paid (402) or deprecated so I know what to avoid?"},{"title":"Compare two APIs by their specs","prompt":"I'm trying to decide between two weather APIs. Can you summarize the OpenAPI docs at https://api.open-meteo.com/openapi.json and https://openweathermap.org/openapi.yaml so I can compare their available endpoints, auth schemes, and feature coverage?"}],"resultDescription":"Returns a structured JSON object with the API title, version, description, server URLs, auth schemes (type, location, name), operation count broken down by HTTP method, all tag names, total paid and deprecated operation counts, and a list of up to 150 operations each with method, path, summary, operationId, and flags for paid and deprecated status. Also indicates whether the operation list was truncated.","failureModes":["URL is not reachable or returns non-200 — fetch fails with an error","Document exceeds 2 MB limit — rejected with size error","URL points to a non-OpenAPI/Swagger document — parse error returned","Invalid or malformed YAML/JSON — parse error returned","More than 150 operations — list is truncated and truncated flag is set to true"],"whenToPreferThis":"Use this endpoint when an AI agent needs to understand an unfamiliar API before calling it, select the right endpoint from a large spec, or quickly compare two APIs. It is the right choice when you have an OpenAPI 3 or Swagger 2 document URL and need structured metadata about its capabilities, auth, and operations — especially before making live API calls. Prefer it over reading raw spec files directly since it normalizes both JSON and YAML formats and highlights paid and deprecated operations automatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-25T06:40:26.918Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-openapi-spec-summary-20b07210"}