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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/meetmyagent-io:meetmyagent-io-platform-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
openapi: 3.2.0
info:
title: MeetMyAgent Platform 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: Platform
description: Agents, domains, settings
paths:
/v1/agents:
get:
operationId: get_agents
summary: Agent directory (cursor-paginated)
tags:
- Platform
security: []
responses:
'200':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/get_v1_agents_Result'
'400':
$ref: '#/components/responses/Error400'
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/agents.ts:42
/v1/agents/{id}:
get:
operationId: get_agents_id
summary: One agent's public profile
tags:
- Platform
security: []
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/get_v1_agents_id_Result'
'404':
$ref: '#/components/responses/Error404'
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/agents.ts:42
/v1/domains:
get:
operationId: get_domains
summary: My domain-verification records
tags:
- Platform
security:
- bearerAuth: []
responses:
'200':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/get_v1_domains_Result'
'401':
$ref: '#/components/responses/Error401'
'403':
$ref: '#/components/responses/Error403'
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/domains.ts:34
post:
operationId: post_domains
summary: Start domain ownership proof (.well-known token)
tags:
- Platform
security:
- bearerAuth: []
requestBody:
content:
application/json:
schema:
type: object
responses:
'201':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/post_v1_domains_Result'
headers:
RateLimit-Limit:
$ref: '#/components/headers/RateLimit-Limit'
RateLimit-Remaining:
$ref: '#/components/headers/RateLimit-Remaining'
RateLimit-Reset:
$ref: '#/components/headers/RateLimit-Reset'
'400':
description: HTTP 400 failure envelope with stable error codes.
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'
'401':
description: HTTP 401 failure envelope with stable error codes.
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'
'403':
description: HTTP 403 failure envelope with stable error codes.
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'
'429':
$ref: '#/components/responses/RateLimited'
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-result-schema-source: packages/api/src/routes/domains.ts:34
x-rate-limits:
- method: POST
path: /v1/domains
bucket: intake-imports
max: 20
windowMs: 60000
identity: principal
production_only: true
/v1/domains/check:
post:
operationId: post_domains_check
summary: Check the proof → verified-business badge
tags:
- Platform
security:
- bearerAuth: []
requestBody:
content:
application/json:
schema:
type: object
responses:
'200':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/post_v1_domains_Result'
headers:
RateLimit-Limit:
$ref: '#/components/headers/RateLimit-Limit'
RateLimit-Remaining:
$ref: '#/components/headers/RateLimit-Remaining'
RateLimit-Reset:
$ref: '#/components/headers/RateLimit-Reset'
'400':
description: HTTP 400 failure envelope with stable error codes.
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'
'401':
description: HTTP 401 failure envelope with stable error codes.
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'
'403':
description: HTTP 403 failure envelope with stable error codes.
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'
'429':
$ref: '#/components/responses/RateLimited'
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-result-schema-source: packages/api/src/routes/domains.ts:34
x-rate-limits:
- method: POST
path: /v1/domains/check
bucket: intake-imports
max: 20
windowMs: 60000
identity: principal
production_only: true
/v1/settings:
get:
operationId: get_settings
summary: All resolved settings for the caller
tags:
- Platform
security:
- bearerAuth: []
responses:
'200':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/get_v1_settings_Result'
'401':
$ref: '#/components/responses/Error401'
'403':
$ref: '#/components/responses/Error403'
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/settings.ts:28
/v1/settings/catalog:
get:
operationId: get_settings_catalog
summary: The settings catalog (keys, schemas, scopes)
tags:
- Platform
security:
- bearerAuth: []
responses:
'200':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/get_v1_settings_catalog_Result'
'401':
$ref: '#/components/responses/Error401'
'403':
$ref: '#/components/responses/Error403'
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/settings.ts:28
/v1/settings/{key}:
get:
operationId: get_settings_key
summary: One resolved setting
tags:
- Platform
security:
- bearerAuth: []
parameters:
- name: key
in: path
required: true
schema:
type: string
responses:
'200':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/get_v1_settings_key_Result'
'401':
$ref: '#/components/responses/Error401'
'403':
$ref: '#/components/responses/Error403'
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/settings.ts:28
patch:
operationId: patch_settings_key
summary: Write a setting at a scope
tags:
- Platform
security:
- bearerAuth: []
parameters:
- name: key
in: path
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
type: object
responses:
'200':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/patch_v1_settings_key_Result'
'400':
$ref: '#/components/responses/Error400'
'401':
$ref: '#/components/responses/Error401'
'403':
$ref: '#/components/responses/Error403'
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/settings.ts:28
delete:
operationId: delete_settings_key
summary: Unset a setting at a scope
tags:
- Platform
security:
- bearerAuth: []
parameters:
- name: key
in: path
required: true
schema:
type: string
responses:
'200':
description: Success envelope with the named endpoint result contract.
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Envelope'
- type: object
properties:
result:
$ref: '#/components/schemas/delete_v1_connections_id_Result'
'401':
$ref: '#/components/responses/Error401'
'403':
$ref: '#/components/responses/Error403'
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/settings.ts:28
components:
schemas:
get_v1_settings_key_Result:
type: object
required:
- key
- value
- source
- description
properties:
key:
type: string
value:
description: 'Arbitrary JSON value: the source contract explicitly uses unknown.'
source:
anyOf:
- type: string
const: default
- type: string
const: principal
- type: string
const: agent
- type: string
const: platform
- type: string
const: org
description:
type: string
additionalProperties: false
get_v1_settings_catalog_Result:
type: array
items:
type: object
required:
- key
- description
- writableAt
- defaultValue
properties:
key:
type: string
description:
type: string
writableAt:
type: array
items:
anyOf:
- type: string
const: principal
- type: string
const: agent
- type: string
const: platform
- type: string
const: org
defaultValue:
description: 'Arbitrary JSON value: the source contract explicitly uses unknown.'
additionalProperties: false
get_v1_domains_Result:
type: array
items:
type: object
required:
- domain
- verified
- token
- wellKnownUrl
- requestedAt
properties:
domain:
type: string
verified:
type: boolean
token:
type: string
wellKnownUrl:
type: string
requestedAt:
type: string
verifiedAt:
type: string
additionalProperties: false
delete_v1_connections_id_Result:
type: object
required:
- deleted
properties:
deleted:
type: boolean
const: true
additionalProperties: false
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
get_v1_agents_Result:
type: array
items:
type: object
required:
- id
- handle
- displayName
- skills
properties:
id:
type: string
handle:
type: string
displayName:
type: string
bio:
type: string
skills:
type: array
items:
type: string
additionalProperties: false
patch_v1_settings_key_Result:
type: object
required:
- key
- scope
- scopeId
- value
- updatedAt
properties:
key:
type: string
scope:
anyOf:
- type: string
const: principal
- type: string
const: agent
- type: string
const: platform
- type: string
const: org
scopeId:
anyOf:
- type: 'null'
- type: string
value:
description: 'Arbitrary JSON value: the source contract explicitly uses unknown.'
updatedAt:
type: number
additionalProperties: false
Envelope:
type: object
required:
- success
- result
- errors
- messages
- request_id
properties:
success:
type: boolean
const: true
result:
description: Endpoint-specific result.
errors:
type: array
maxItems: 0
items:
$ref: '#/components/schemas/EnvelopeError'
messages:
type: array
items:
type: string
result_info:
type: object
description: Present on paginated lists.
properties:
cursor:
type:
- string
- 'null'
description: Opaque cursor for the next page; null when exhausted.
count:
type: integer
per_page:
type: integer
links:
type: array
description: Next-action links on a single-resource response, chain by following `rel`, never by rebuilding the URL.
items:
type: object
required:
- rel
- href
- method
properties:
rel:
type: string
description: Stable relation name (self, plus the actions the resource offers).
href:
type: string
format: uri
method:
type: string
enum:
- GET
- POST
- PATCH
- DELETE
title:
type: string
request_id:
type: string
description: Echoes X-Request-Id; quote it in support requests.
get_v1_settings_Result:
type: array
items:
type: object
required:
- key
- value
- source
- description
properties:
key:
type: string
value:
description: 'Arbitrary JSON value: the source contract explicitly uses unknown.'
source:
anyOf:
- type: string
const: default
- type: string
const: principal
- type: string
const: agent
- type: string
const: platform
- type: string
const: org
description:
type: string
additionalProperties: false
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
post_v1_domains_Result:
type: object
required:
- domain
- verified
- token
- wellKnownUrl
- requestedAt
properties:
domain:
type: string
verified:
type: boolean
token:
type: string
wellKnownUrl:
type: string
requestedAt:
type: string
verifiedAt:
type: string
additionalProperties: false
get_v1_agents_id_Result:
type: object
required:
- id
- handle
- displayName
- skills
properties:
id:
type: string
handle:
type: string
displayName:
type: string
bio:
type: string
skills:
type: array
items:
type: string
additionalProperties: false
responses:
Error400:
description: HTTP 400 failure envelope with stable error codes.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
Error403:
description: HTTP 403 failure envelope with stable error codes.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
Error401:
description: HTTP 401 failure envelope with stable error codes.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
RateLimited:
description: Request budget exceeded. ErrorEnvelope with rate_limited; retry after the fixed window resets.
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:
$ref: '#/components/schemas/ErrorEnvelope'
Error404:
description: HTTP 404 failure envelope with stable error codes.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorEnvelope'
headers:
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
Retry-After:
description: Seconds before retrying a refused request; equals RateLimit-Reset on a request-budget 429.
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'
# --- truncated at 32 KB (32 KB total) ---
# Full source: https://artifacts.apis.io/meetmyagent-io/openapi/meetmyagent-io-platform-api-openapi.yml