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/allmcps:allmcps-a2a-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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: AllMCPs Directory A2a API
  description: 'Public API for querying and managing Model Context Protocol (MCP) servers listed on AllMCPs. Designed for AI agents, LLM tool callers, and developer integrations.


    **Versioning & deprecation policy**: this spec is URL-versioned (`/api/v1/...`). Endpoints are additive within v1 — existing fields are not removed or repurposed without a version bump. If an endpoint is ever deprecated, responses will carry a `Deprecation: true` header (and, once a removal date is set, a `Sunset: ` header) for at least 90 days before removal, and the change will be announced at https://allmcps.com/blog. There is currently no deprecated surface in v1.


    **Auth**: most endpoints are public/unauthenticated (see each operation). Listing-mutating agent actions require a scoped Bearer token — see `components.securitySchemes.agentBearerAuth` and https://allmcps.com/auth.md.'
  version: 1.0.0
  contact:
    name: AllMCPs Team
    url: https://allmcps.com/contact
    email: contact@allmcps.com
servers:
- url: https://allmcps.com
  description: Production Edge Server
tags:
- name: A2a
paths:
  /api/a2a:
    post:
      summary: A2A (Agent2Agent) JSON-RPC endpoint
      description: 'A2A 1.0 and 0.3 JSON-RPC binding; send `A2A-Version: 1.0` for 1.0. Each MCP tool is an A2A skill: SendMessage with a data part `{ "skill": "", "arguments": {...} }`, or a text part to search. Answers with a Message (no tasks are kept). Agent card: /.well-known/agent-card.json.'
      operationId: a2aJsonRpc
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - jsonrpc
              - method
              - id
              properties:
                jsonrpc:
                  type: string
                  enum:
                  - '2.0'
                id: {}
                method:
                  type: string
                  example: SendMessage
                params:
                  type: object
      responses:
        '200':
          description: JSON-RPC 2.0 response (errors use A2A codes).
          content:
            application/json:
              schema:
                type: object
      tags:
      - A2a
components:
  securitySchemes:
    agentBearerAuth:
      type: oauth2
      description: 'Bearer token minted via POST /api/v1/agent/register + /api/v1/agent/register/confirm (email-verified, no OAuth redirect flow). Send as `Authorization: Bearer amcp_...`. Also documented at /.well-known/oauth-protected-resource and /auth.md.'
      flows:
        clientCredentials:
          tokenUrl: https://allmcps.com/api/v1/agent/register/confirm
          scopes:
            listings:claim: 'Claim ownership of an existing MCP server listing via DNS TXT record, site verification badge, or GitHub README badge proof. Grants no other write access. Required by: POST /api/v1/agent/claim, MCP tool: verify_mcp_claim (with an agentToken).'
            checkout:write: 'Create, update, complete and cancel Agentic Commerce Protocol checkout sessions to buy listing boosts. Payment still needs a Stripe shared payment token the buyer granted; this scope alone cannot spend money. Required by: ACP: /api/acp/checkout_sessions (all endpoints).'