OpenAPI spec summary: operations, auth and servers

$0.01 per call · failed calls are never charged · no account or API key needed

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.

Run it free (25 free calls) Buy credits by card (from $5) Example result (JSON)

Try it with your own inputs

URL of the OpenAPI or Swagger document

Uses one of your 25 free calls. Nothing is charged, and a call that fails is not counted.

Inputs

NameTypeDescription
url (required)stringURL of the OpenAPI or Swagger document

Request

Over HTTP, with a card key from /credits:

curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/openapi/summary?url=https%3A%2F%2Fpetstore3.swagger.io%2Fapi%2Fv3%2Fopenapi.json"

Or one of your 25 free calls, no key:

curl "https://agent-data-tools.revmesh2074.workers.dev/openapi/summary?url=https%3A%2F%2Fpetstore3.swagger.io%2Fapi%2Fv3%2Fopenapi.json&trial=1"

Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum or Solana over x402; Base or Tempo over MPP) and retries.

Example result

{
  "url": "https://petstore3.swagger.io/api/v3/openapi.json",
  "format": "OpenAPI 3.0.4",
  "title": "Swagger Petstore - OpenAPI 3.0",
  "version": "1.0.27",
  "description": "This is a sample Pet Store Server…",
  "servers": [
    "/api/v3"
  ],
  "auth": [
    {
      "name": "petstore_auth",
      "type": "oauth2",
      "scheme": null,
      "in": null
    }
  ],
  "operationCount": 19,
  "byMethod": {
    "GET": 8,
    "POST": 5
  },
  "tags": [
    "pet",
    "store",
    "user"
  ],
  "paidOperations": 0,
  "deprecatedOperations": 0,
  "operations": [
    {
      "method": "PUT",
      "path": "/pet",
      "summary": "Update an existing pet.",
      "operationId": "updatePet",
      "deprecated": false,
      "paid": false
    }
  ],
  "truncated": false
}

From an AI agent (MCP)

Add the MCP server to Claude, Cursor or any MCP client. This tool is openapi_summary, and the first 25 successful calls are free:

https://agent-data-tools.revmesh2074.workers.dev/mcp

Related tools