MeetMyAgent Agents API

Your hosted agent: profile, knowledge, going live and pausing, inbox, install data (owner scopes agents:read and agents:write)

GitHub OpenAPI

Operations 74

GET /v1/me/agent/verifications Read private resource verifications and method availability. #
POST /v1/me/agent/verifications/challenges Create a website, domain mailbox or manual social profile verification… #
POST /v1/me/agent/verifications/challenges/{id}/confirm Confirm a mailbox code deliberately; GET does not activate it. #
POST /v1/me/agent/verifications/challenges/{id}/check Read the fresh website file and verify this challenge. #
POST /v1/me/agent/verifications/github/start Start a separate GitHub resource verification, with purpose-bound state. #
POST /v1/me/agent/verifications/github/complete Exchange a GitHub code in the original session. No proof until confirmation. #
POST /v1/me/agent/verifications/github/confirm Confirm the recognized GitHub account deliberately. #
POST /v1/me/agent/verifications/{id}/revoke Revoke one resource proof. #
GET /v1/agent-verification-reviews Read the manual review queue. Requires the operator allowlist. #
POST /v1/agent-verification-reviews/{id}/decision Record a manual code comparison. Requires the operator allowlist. #
POST /v1/agent-verification-reviews/{id}/revoke Revoke one proof with an audit note. Requires the operator allowlist. #
POST /v1/ucp/catalog/search UCP 2026-08-25 read-only search of complete published eligible hosted offers #
POST /v1/ucp/catalog/lookup UCP 2026-08-25 read-only lookup by catalog product or variant ID #
POST /v1/ucp/catalog/product UCP 2026-08-25 read-only current detail for one catalog product or variant ID #
GET /v1/me/agent My hosted agent and what still blocks publishing (missing[]); { agent: null }… #
PUT /v1/me/agent Create my hosted agent as a draft, or update it: name, address, texts… #
GET /v1/me/agent/knowledge My agent's knowledge sources #
POST /v1/me/agent/knowledge Add knowledge: a text, a question with its answer, or a web page (fetched… #
PUT /v1/me/agent/knowledge Replace ALL knowledge sources in one call: body { sources: [...], confirm: true… #
POST /v1/me/agent/knowledge/{sourceId}/refresh Read a web page source (kind url) again: stored under a new id, the old source… #
DELETE /v1/me/agent/knowledge/{sourceId} Remove one knowledge source #
POST /v1/me/agent/publish Go live: public page, A2A endpoint and card. #
POST /v1/me/agent/pause Pause the live agent: hidden on every public surface, data kept; publish brings… #
GET /v1/me/agent/requests My agent's inbox, newest first (?status= & ?limit= & ?cursor=) #
PATCH /v1/me/agent/requests/{id} Mark a request seen or archived, or record an answer on it. #
GET /v1/me/agent/install Install data: card address, A2A endpoint, page, embedSnippet using… #
POST /v1/me/agent/profile-imports Save a private profile import proposal and exact diff; no public changes #
GET /v1/me/agent/profile-imports List my profile import proposals #
GET /v1/me/agent/profile-imports/{id} Read my saved profile import and revision #
POST /v1/me/agent/profile-imports/{id}/approve Apply only an explicitly reviewed revision atomically, without publishing a… #
POST /v1/me/agent/profile-imports/{id}/reject Reject my profile import proposal #
GET /v1/me/agent/notifications Read my notification connection and supported event selection #
POST /v1/me/agent/notifications/connect Create an expiring Telegram connection link after explicit third-party consent #
PUT /v1/me/agent/notifications/preferences Choose supported notification events #
DELETE /v1/me/agent/notifications/telegram Disconnect Telegram and cancel pending deliveries #
POST /v1/notifications/telegram/webhook Telegram updates with mandatory X-Telegram-Bot-Api-Secret-Token and one-time… #
GET /v1/hosted/_schema/offers Category-specific offer fields and filters as JSON Schema #
GET /v1/hosted/{slug}/offers Filter live offers; optional filter query contains a JSON object from… #
PUT /v1/me/agent/offer-images Upload one offer photo (PNG/JPEG/WebP, maximum 5 MB); returns its agent-owned… #
GET /v1/me/agent/offer-images/{file} Private owner preview of an uploaded offer image #
GET /v1/hosted/{slug}/offer-images/{file} WebP photo currently referenced by a live published offer #
GET /v1/hosted/{slug} Public profile of a live hosted agent for its page (404 for a draft, a paused… #
POST /v1/hosted/{slug}/messages One chat message to a live hosted agent from its page or chat window (channel… #
POST /v1/hosted/{slug}/requests Leave a request in the owner's inbox: name, contact, message. #
GET /v1/me/agent/card My agent's public contact card: the card, its revision, what the page shows… #
PATCH /v1/me/agent/card Change the public contact card: body { revision, ...fields }; a field left out… #
GET /v1/hosted/{slug}/vcard The contact card of a live hosted agent as a vCard 4.0 file (text/vcard, not… #
GET /v1/me/agent/qr My agent's QR codes, retired ones included: code, url (the address inside the… #
POST /v1/me/agent/qr A new QR code for my agent: body { label, placement… #
GET /v1/me/agent/qr/{id} One QR code of my agent #
PATCH /v1/me/agent/qr/{id} Change a QR code: label, placement, greeting (null removes it), questions, or… #
POST /v1/me/agent/qr/{id}/retire Retire a QR code for good: body { confirm: true }. #
GET /v1/me/agent/qr/{id}/file A file of a QR code (not the envelope): ?format=svg|png|pdf, png with… #
GET /v1/me/agent/qr/{id}/stats The day counters of a QR code (?days=1..366, default 30): views of the short… #
GET /v1/qr/{code} Where a QR address /q/ leads: { state: active, slug, pagePath } for an active… #
POST /v1/qr/{code}/visits Resolves like GET /v1/qr/:code and counts one view. #
GET /v1/qr/files/{token} The file behind a signed QR download link (not the envelope); 404 when the link… #
POST /v1/hosted/{slug}/events Counts one contact click for a QR code: body { type: contact_click, action… #
PUT /v1/me/agent/card/images/{kind} Set an image of my agent's public card: kind logo, portrait or cover, the body… #
DELETE /v1/me/agent/card/images/{kind} Remove an image of my agent's public card (logo, portrait or cover); the card… #
GET /v1/me/agent/card/images/{kind} The image of one kind (logo, portrait or cover) my own agent's card names now… #
GET /v1/hosted/{slug}/images/{kind}/{file} An image of the public card of a live hosted agent, at the address its card… #
GET /v1/me/assistant The setup assistant of my account: { enabled, reason, plan, used, cap… #
POST /v1/me/assistant/sessions Open a setup assistant session. #
GET /v1/me/assistant/sessions/{id} One setup assistant session with its history: { session, messages }. #
POST /v1/me/assistant/sessions/{id}/messages One turn with the setup assistant: body { message (1 to 4000 characters)… #
GET /v1/me/agent/directories The external agent directories for my agent: per directory whether it is… #
GET /v1/me/agent/directories/{ziel}/preview What would be sent to one directory, built from the public view of my live… #
POST /v1/me/agent/directories/{ziel}/activate Opt in to one directory: body { freigabeRevision } naming the revision the… #
POST /v1/me/agent/directories/{ziel}/publish Publish my live agent to one approved directory now, or bring the entry up to… #
POST /v1/me/agent/directories/{ziel}/update Bring an existing entry in one directory up to date now and read it back. #
POST /v1/me/agent/directories/{ziel}/revoke Withdraw the approval for one directory: nothing is published or updated there… #
POST /v1/me/agent/directories/{ziel}/remove Remove the entry from one directory. #

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-agents-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-agents-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: MeetMyAgent Agents 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:


# --- truncated at 32 KB (445 KB total) ---
# Full source: https://artifacts.apis.io/meetmyagent-io/openapi/meetmyagent-io-agents-api-openapi.yml