MeetMyAgent A2a API
A2A 1.0 JSON-RPC endpoints and signed agent cards: the platform and every live hosted agent (public, rate-limited)
A2A 1.0 JSON-RPC endpoints and signed agent cards: the platform and every live hosted agent (public, rate-limited)
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/meetmyagent-io:meetmyagent-io-a2a-api"
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.
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: 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'