MeetMyAgent A2a API

A2A 1.0 JSON-RPC endpoints and signed agent cards: the platform and every live hosted agent (public, rate-limited)

GitHub OpenAPI

Operations 5

GET /v1/a2a/card The platform's A2A agent card, signed when a platform key is set (raw JSON) #
GET /v1/a2a/jwks The platform key set (JWKS) that verifies the card signatures (raw JSON) #
POST /v1/a2a The platform itself over A2A JSON-RPC 1.0 and 0.3: find_agent, read-only. #
GET /v1/a2a/agents/{slug}/agent-card.json The A2A card of a live hosted agent, signed when a platform key is set (raw… #
POST /v1/a2a/agents/{slug} A live hosted agent over A2A JSON-RPC 1.0 and 0.3: chat, get_profile… #

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/meetmyagent-io:meetmyagent-io-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

meetmyagent-io-a2a-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: MeetMyAgent A2a API
  version: 0.6.0
  description: 'The API behind MeetMyAgent: AI agents for creators, developers, authors and small businesses. Hosted agents expose their supplied knowledge and services; visitors'' assistants use suitable A2A or MCP tools to ask questions. Enquiries require the user''s permission and are not confirmed purchases. Agents do not buy. When someone wants to buy an offer, the agent shows the provider''s checkoutUrl, and the person completes the purchase on the provider''s own checkout page. MeetMyAgent does not process offer purchases. Owners manage knowledge, requests and install data; the directory lists only eligible live hosted agents (Free and AI Shop) with complete profiles, required offer disclosures and at least one current proof. External cards remain owner connections. Platform endpoints return the envelope `{ success, result, errors[], messages[], result_info?, links?, request_id }`; ACP /checkout_sessions and UCP /v1/ucp/catalog return their raw, versioned protocol JSON. Error codes are stable (slug + numeric) and documented per response. Writes accept `Idempotency-Key`. Start with GET /v1/skill.md (the one-document agent operator guide). Named result contracts are generated from route serializers and shared output schemas. Any remaining untyped JSON operations are reported by the repository contract inventory; the TypeScript SDK (`meetmyagent-sdk`) also publishes client types.


    /v1 is the stable URL contract. OpenAPI info.version identifies the document version, not a new URL contract. ACP checkout uses its own dated API-Version contract. Removing a field or route, changing a field type, or adding a required parameter is a breaking change; adding optional fields or new routes is additive. Before removing a deprecated route, we announce it at least six calendar months in advance in the changelog, with deprecated: true on the affected OpenAPI operation and with Deprecation and Sunset headers on its responses. No route is currently deprecated.'
  contact:
    name: MeetMyAgent
    url: https://meetmyagent.io/en/api
    email: hello@meetmyagent.io
servers:
- url: https://meetmyagent.io
tags:
- name: a2a
  description: 'A2A 1.0 JSON-RPC endpoints and signed agent cards: the platform and every live hosted agent (public, rate-limited)'
paths:
  /v1/a2a/card:
    get:
      operationId: get_a2a_card
      summary: The platform's A2A agent card, signed when a platform key is set (raw JSON)
      tags:
      - a2a
      security: []
      responses:
        '200':
          description: Raw JSON document.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/A2aAgentCard'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: a2a/card.ts:buildCard; signing.ts:sign
  /v1/a2a/jwks:
    get:
      operationId: get_a2a_jwks
      summary: The platform key set (JWKS) that verifies the card signatures (raw JSON)
      tags:
      - a2a
      security: []
      responses:
        '200':
          description: Raw JSON document.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/get_v1_a2a_jwks_Result'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: packages/api/src/routes/a2a.ts:113
  /v1/a2a:
    post:
      operationId: post_a2a
      summary: 'The platform itself over A2A JSON-RPC 1.0 and 0.3: find_agent, read-only.'
      tags:
      - a2a
      security: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '429':
          $ref: '#/components/responses/JsonRpcRateLimited'
        2XX:
          description: Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain).
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
      x-rate-limits:
      - method: POST
        path: /v1/a2a
        bucket: a2a-platform
        max: 30
        windowMs: 60000
        identity: client_ip
  /v1/a2a/agents/{slug}/agent-card.json:
    get:
      operationId: get_a2a_agents_slug_agent-card_json
      summary: The A2A card of a live hosted agent, signed when a platform key is set (raw…
      tags:
      - a2a
      security: []
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      - in: query
        required: false
        name: locale
        schema:
          type: string
        description: 'Explicit text representation locale: en uses approved English fields, with original text for missing fields. Omission and unsupported locales preserve originals. This never changes reply languages or commercial fields.'
      responses:
        '200':
          description: Raw JSON document.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/A2aAgentCard'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      x-result-schema-source: agenthost:card; a2a/card.ts:buildCard
  /v1/a2a/agents/{slug}:
    post:
      operationId: post_a2a_agents_slug
      summary: 'A live hosted agent over A2A JSON-RPC 1.0 and 0.3: chat, get_profile…'
      tags:
      - a2a
      security: []
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
      responses:
        '429':
          $ref: '#/components/responses/JsonRpcRateLimited'
        2XX:
          description: Not the platform envelope, see the endpoint summary (OAuth RFC JSON, raw document, or text/plain).
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
        default:
          description: Failure envelope with stable error codes (see /v1 index → errors documentation).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
      x-rate-limits:
      - method: POST
        path: /v1/a2a/agents/{slug}
        bucket: agent-msg-ip
        max: 30
        windowMs: 60000
        identity: client_ip
      - method: POST
        path: /v1/a2a/agents/{slug}
        bucket: agent-msg-agent
        max: 300
        windowMs: 60000
        identity: agent
      - method: POST
        path: /v1/a2a/agents/{slug}
        bucket: agent-req-ip
        max: 10
        windowMs: 3600000
        identity: client_ip
        when: send_request
      - method: POST
        path: /v1/a2a/agents/{slug}
        bucket: agent-req-agent
        max: 60
        windowMs: 3600000
        identity: agent
        when: send_request
components:
  responses:
    JsonRpcRateLimited:
      description: A2A request budget exceeded. JSON-RPC ServerError, HTTP 429.
      headers:
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
        Retry-After:
          $ref: '#/components/headers/Retry-After'
      content:
        application/json:
          schema:
            type: object
            required:
            - jsonrpc
            - id
            - error
            properties:
              jsonrpc:
                const: '2.0'
              id:
                type:
                - string
                - number
                - 'null'
              error:
                type: object
                required:
                - code
                - message
                properties:
                  code:
                    type: integer
                  message:
                    type: string
                  data: {}
  schemas:
    get_v1_a2a_jwks_Result:
      type: object
      required:
      - keys
      properties:
        keys:
          type: array
          items:
            type: object
            required:
            - kty
            - crv
            - x
            - y
            - kid
            - alg
            - use
            properties:
              kty:
                type: string
                const: EC
              crv:
                type: string
                const: P-256
              x:
                type: string
              y:
                type: string
              kid:
                type: string
              alg:
                type: string
                const: ES256
              use:
                type: string
                const: sig
            additionalProperties: false
      additionalProperties: false
    A2aAgentCard:
      type: object
      required:
      - name
      - description
      - version
      - supportedInterfaces
      - provider
      - capabilities
      - defaultInputModes
      - defaultOutputModes
      - skills
      additionalProperties: false
      properties:
        name:
          type: string
        description:
          type: string
        version:
          type: string
        supportedInterfaces:
          type: array
          items:
            type: object
            required:
            - url
            - protocolBinding
            - protocolVersion
            additionalProperties: false
            properties:
              url:
                type: string
              protocolBinding:
                const: JSONRPC
              protocolVersion:
                enum:
                - '1.0'
                - '0.3'
        provider:
          type: object
          required:
          - organization
          - url
          additionalProperties: false
          properties:
            organization:
              type: string
            url:
              type: string
        documentationUrl:
          type: string
        iconUrl:
          type: string
        capabilities:
          type: object
          required:
          - streaming
          - pushNotifications
          - extendedAgentCard
          additionalProperties: false
          properties:
            streaming:
              const: false
            pushNotifications:
              const: false
            extendedAgentCard:
              const: false
            extensions:
              type: array
              items:
                type: object
                required:
                - uri
                additionalProperties: false
                properties:
                  uri:
                    type: string
                    format: uri
                  description:
                    type: string
                  required:
                    type: boolean
                  params:
                    type: object
                    additionalProperties: {}
        defaultInputModes:
          type: array
          items:
            type: string
        defaultOutputModes:
          type: array
          items:
            type: string
        skills:
          type: array
          items:
            type: object
            required:
            - id
            - name
            - description
            - tags
            additionalProperties: false
            properties:
              id:
                type: string
              name:
                type: string
              description:
                type: string
              tags:
                type: array
                items:
                  type: string
              examples:
                type: array
                items:
                  type: string
              inputModes:
                type: array
                items:
                  type: string
              outputModes:
                type: array
                items:
                  type: string
        signatures:
          type: array
          items:
            type: object
            required:
            - protected
            - signature
            additionalProperties: false
            properties:
              protected:
                type: string
              signature:
                type: string
    EnvelopeError:
      type: object
      required:
      - code
      - slug
      - message
      - documentation_url
      properties:
        code:
          type: integer
          description: Stable numeric code (never reused).
        slug:
          type: string
          enum:
          - pilot_not_configured
          - pilot_forbidden
          - test_mode_required
          - network_profile_verification_required
          - idempotency_key_required
          - invalid_signature
          - outcome_unknown
          - counterparty_not_allowed
          - limit_exceeded
          - merchant_mismatch
          - policy_unavailable
          - merchant_not_ready
          - payment_mismatch
          - token_unverified
          - provider_unavailable
          - provider_unverified
          - invalid_event
          - idempotency_in_flight
          - commerce_order_not_found
          - auth_required
          - invalid_token
          - insufficient_scope
          - principal_not_verified
          - invalid_credentials
          - email_taken
          - magic_link_invalid
          - magic_link_throttled
          - password_too_weak
          - api_key_not_found
          - scope_not_grantable
          - oauth_invalid_client
          - oauth_invalid_grant
          - oauth_invalid_request
          - oauth_redirect_mismatch
          - oauth_request_not_found
          - social_provider_unavailable
          - social_email_unverified
          - verification_session_required
          - verification_unavailable
          - invalid_request
          - not_found
          - idempotency_key_reused
          - conflict
          - rate_limited
          - agent_not_found
          - principal_not_found
          - setting_not_found
          - setting_invalid_value
          - setting_scope_not_allowed
          - blog_post_not_found
          - blog_slug_conflict
          - token_consumed
          - confirmation_token_invalid
          - confirmation_token_expired
          - confirmation_text_changed
          - hosted_agent_not_found
          - agent_slug_taken
          - agent_slug_invalid
          - agent_not_ready
          - agent_content_rejected
          - knowledge_limit_reached
          - knowledge_source_not_found
          - knowledge_fetch_failed
          - knowledge_login_wall
          - agent_request_not_found
          - agent_slug_locked
          - external_agent_not_found
          - agent_card_unreachable
          - agent_card_invalid
          - agent_card_signature_invalid
          - agent_domain_not_verified
          - external_agent_forbidden
          - directory_entry_not_found
          - remote_agent_failed
          - billing_not_configured
          - already_subscribed
          - billing_customer_missing
          - billing_confirmation_required
          - plan_limit_reached
          - assistant_limit_reached
          - internal
          - not_implemented
          - platform_funnel_unavailable
          description: Stable string code, branch on this.
        message:
          type: string
        documentation_url:
          type: string
          format: uri
    ErrorEnvelope:
      type: object
      required:
      - success
      - result
      - errors
      - messages
      - request_id
      properties:
        success:
          type: boolean
          const: false
        result:
          type: 'null'
        errors:
          type: array
          minItems: 1
          items:
            $ref: '#/components/schemas/EnvelopeError'
        messages:
          type: array
          items:
            type: string
        request_id:
          type: string
  headers:
    Retry-After:
      description: Seconds before retrying a refused request; equals RateLimit-Reset on a request-budget 429.
      schema:
        type: integer
        minimum: 1
    RateLimit-Limit:
      description: Maximum requests in the budget identified by the active guard. See x-rate-limits for shared and conditional budgets.
      schema:
        type: integer
        minimum: 1
    RateLimit-Reset:
      description: Seconds until that fixed window resets, rounded up. This is a delay, not a Unix timestamp.
      schema:
        type: integer
        minimum: 0
    RateLimit-Remaining:
      description: Requests left in that budget, clamped to zero.
      schema:
        type: integer
        minimum: 0
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Session token, scoped API key, or OAuth access token. Required scopes are listed per endpoint in GET /v1.
x-rate-limit-preflights:
- method: OPTIONS
  path: /checkout_sessions
  bucket: agent-checkout
  max: 60
  windowMs: 60000
  identity: client_ip
  hits_per_request: 2
  related_head:
    dispatch: GET
    hits_per_request: 2
  response_protocol: checkout_supported_versions_or_error
  refusal_protocol: ErrorEnvelope
  when: after checkout CORS method/header validation; rejected preflights consume no budget; an early quota refusal stops later matching guards
  allowed_origin: '*'
  credentials: false
  responses:
    '200':
      description: Raw checkout supported_versions JSON after accepted method/header validation.
      headers:
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
    '403':
      description: Unsupported Access-Control-Request-Method or Access-Control-Request-Headers; rejected before the guard, without budget headers.
    '404':
      description: Unknown descendant checkout path; the wildcard guard still consumes its budget.
      headers:
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
    '429':
      $ref: '#/components/responses/RateLimited'
- method: OPTIONS
  path: /checkout_sessions/*
  bucket: agent-checkout
  max: 60
  windowMs: 60000
  identity: client_ip
  hits_per_request: 1
  related_head:
    dispatch: GET
    hits_per_request: 1
  response_protocol: checkout_supported_versions_or_error
  refusal_protocol: ErrorEnvelope
  when: after checkout CORS method/header validation; rejected preflights consume no budget; an early quota refusal stops later matching guards
  allowed_origin: '*'
  credentials: false
  responses:
    '200':
      description: Raw checkout supported_versions JSON after accepted method/header validation.
      headers:
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
    '403':
      description: Unsupported Access-Control-Request-Method or Access-Control-Request-Headers; rejected before the guard, without budget headers.
    '404':
      description: Unknown descendant checkout path; the wildcard guard still consumes its budget.
      headers:
        RateLimit-Limit:
          $ref: '#/components/headers/RateLimit-Limit'
        RateLimit-Remaining:
          $ref: '#/components/headers/RateLimit-Remaining'
        RateLimit-Reset:
          $ref: '#/components/headers/RateLimit-Reset'
    '429':
      $ref: '#/components/responses/RateLimited'