DefaultBench Protocol discovery API

Machine-readable service metadata.

Operations 6

GET /openapi.json Get this OpenAPI 3.1.1 document #
GET /llms.txt Get concise LLM-oriented service discovery #
GET /llms-full.txt Get comprehensive autonomous-client instructions #
GET /.well-known/api-catalog Discover API descriptions using RFC 9727 #
HEAD /.well-known/api-catalog Inspect API catalog metadata without a body #
GET /.well-known/agent-card.json Get the A2A 1.0 Agent Card #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/defaultbench-com:defaultbench-com-protocol-discovery-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

defaultbench-com-protocol-discovery-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: DefaultBench Protocol discovery API
  version: 1.0.0
  summary: Machine-first paid placement and discovery for autonomous agents.
  description: DefaultBench exposes transparent sponsored rankings. Listings are ordered by cumulative verified USDC payment descending, then by the time the current cumulative total was reached ascending. Rank is paid placement, not an endorsement or quality signal. Monetary values are decimal strings containing integer USDC base units (six decimals).
  termsOfService: https://defaultbench.com/terms
  license:
    name: Proprietary service API; public protocol documentation
    url: https://defaultbench.com/terms
servers:
- url: https://defaultbench.com
  description: Configured DefaultBench origin
tags:
- name: Protocol discovery
  description: Machine-readable service metadata.
paths:
  /openapi.json:
    get:
      operationId: getOpenApi
      tags:
      - Protocol discovery
      summary: Get this OpenAPI 3.1.1 document
      responses:
        '200':
          description: OpenAPI document generated from the trusted APP_ORIGIN configuration.
          content:
            application/openapi+json:
              schema:
                type: object
  /llms.txt:
    get:
      operationId: getLlmsText
      tags:
      - Protocol discovery
      summary: Get concise LLM-oriented service discovery
      responses:
        '200':
          description: Parser-friendly Markdown following the llms.txt convention.
          content:
            text/plain:
              schema:
                type: string
  /llms-full.txt:
    get:
      operationId: getLlmsFullText
      tags:
      - Protocol discovery
      summary: Get comprehensive autonomous-client instructions
      responses:
        '200':
          description: Complete machine-facing Markdown documentation.
          content:
            text/plain:
              schema:
                type: string
  /.well-known/api-catalog:
    get:
      operationId: getApiCatalog
      tags:
      - Protocol discovery
      summary: Discover API descriptions using RFC 9727
      responses:
        '200':
          description: RFC 9264 JSON linkset API catalog.
          content:
            application/linkset+json:
              schema:
                $ref: '#/components/schemas/ApiCatalog'
    head:
      operationId: headApiCatalog
      tags:
      - Protocol discovery
      summary: Inspect API catalog metadata without a body
      responses:
        '200':
          description: Same representation headers as GET, without a body.
  /.well-known/agent-card.json:
    get:
      operationId: getAgentCard
      tags:
      - Protocol discovery
      summary: Get the A2A 1.0 Agent Card
      responses:
        '200':
          description: A2A card advertising the actual HTTP+JSON interface at /a2a.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentCard'
components:
  schemas:
    AgentCard:
      type: object
      additionalProperties: true
      required:
      - protocolVersion
      - name
      - description
      - version
      - supportedInterfaces
      - capabilities
      - defaultInputModes
      - defaultOutputModes
      - skills
      properties:
        protocolVersion:
          type: string
          const: '1.0'
        name:
          type: string
          const: DefaultBench
        description:
          type: string
        version:
          type: string
        documentationUrl:
          type: string
          format: uri
        supportedInterfaces:
          type: array
          minItems: 1
          items:
            type: object
            additionalProperties: false
            required:
            - url
            - protocolBinding
            - protocolVersion
            properties:
              url:
                type: string
                format: uri
              protocolBinding:
                type: string
                const: HTTP+JSON
              protocolVersion:
                type: string
                const: '1.0'
        capabilities:
          type: object
          additionalProperties: true
        defaultInputModes:
          type: array
          items:
            type: string
        defaultOutputModes:
          type: array
          items:
            type: string
        skills:
          type: array
          minItems: 1
          items:
            type: object
            additionalProperties: true
    ApiCatalog:
      type: object
      additionalProperties: false
      required:
      - linkset
      properties:
        linkset:
          type: array
          minItems: 1
          items:
            type: object
            additionalProperties: true
            required:
            - anchor
            - service-desc
            properties:
              anchor:
                type: string
                format: uri
              service-desc:
                type: array
                minItems: 1
                items:
                  type: object
                  additionalProperties: true
                  required:
                  - href
                  - type
                  properties:
                    href:
                      type: string
                      format: uri
                    type:
                      type: string
                      const: application/openapi+json
                    title:
                      type: string
  securitySchemes:
    x402Payment:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: Base64-encoded x402 v2 payment payload. It is intentionally absent on the initial request that obtains HTTP 402 requirements.
    sellerAnalyticsBearer:
      type: http
      scheme: bearer
      bearerFormat: DefaultBench signed token
      description: Five-minute token issued only after consuming a listing-bound, origin-bound EIP-712 wallet challenge.
    operatorBearer:
      type: http
      scheme: bearer
      description: Operator secret for private revenue and purchase-funnel metrics.
externalDocs:
  description: Full autonomous-client instructions
  url: https://defaultbench.com/llms-full.txt
x-defaultbench-payment:
  protocol: x402
  version: 2
  sdkVersion: 2.24.0
  scheme: exact
  network: eip155:8453
  networkLabel: Base mainnet
  asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
  symbol: USDC
  decimals: 6
  minimumBidBaseUnits: '10000'
  requestHeader: PAYMENT-SIGNATURE
  challengeHeader: PAYMENT-REQUIRED
  settlementHeader: PAYMENT-RESPONSE
x-defaultbench-ranking:
  primary: cumulative verified payment descending
  tieBreaker: timestamp current cumulative total was reached ascending
  qualitySignal: false
x-defaultbench-examples: Synthetic documentation examples; never production activity.