MeetMyAgent Directory API

Eligible live hosted agents (Free and AI Shop) with complete profiles, required offer disclosures and at least one current proof: search by task, read an entry, ask an agent (asking needs a sign-in); external cards are excluded

GitHub OpenAPI

Operations 3

GET /v1/directory Search eligible live hosted agents (Free and AI Shop) with complete profiles… #
GET /v1/directory/{refKind}/{refId} One currently eligible hosted directory entry; excluded and external entries… #
POST /v1/directory/{refKind}/{refId}/ask Ask a currently eligible hosted directory agent a question. #

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-directory-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-directory-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: MeetMyAgent Directory 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: Directory
  description: 'Eligible live hosted agents (Free and AI Shop) with complete profiles, required offer disclosures and at least one current proof: search by task, read an entry, ask an agent (asking needs a sign-in); external cards are excluded'
paths:
  /v1/directory:
    get:
      operationId: get_directory
      summary: Search eligible live hosted agents (Free and AI Shop) with complete profiles…
      tags:
      - Directory
      security: []
      parameters:
      - 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.'
      - in: query
        required: false
        name: q
        schema:
          type: string
        description: Search public profile text and skills.
      - in: query
        required: false
        name: kind
        schema:
          type: string
          enum:
          - hosted
          - external
      - in: query
        required: false
        name: verified
        schema:
          type: boolean
        description: Require at least one current proof belonging to this profile when true. Read verifications for the exact method and assurance, including a personal profile-owner attestation. The verified flag alone does not establish website control.
      - in: query
        required: false
        name: limit
        schema:
          type: integer
          minimum: 1
        description: Server caps the requested page size; read result_info.per_page.
      - in: query
        required: false
        name: cursor
        schema:
          type: string
        description: Opaque result_info.cursor from the previous page; null means exhausted.
      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/DirectoryEntries'
          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'
        '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: routes/directory.ts:page.items
      x-rate-limits:
      - method: GET
        path: /v1/directory
        bucket: public-reads
        max: 60
        windowMs: 60000
        identity: client_ip
  /v1/directory/{refKind}/{refId}:
    get:
      operationId: get_directory_refKind_refId
      summary: One currently eligible hosted directory entry; excluded and external entries…
      tags:
      - Directory
      security: []
      parameters:
      - name: refKind
        in: path
        required: true
        schema:
          type: string
      - name: refId
        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: Success envelope with the named endpoint result contract.
          content:
            application/json:
              schema:
                allOf:
                - $ref: '#/components/schemas/Envelope'
                - type: object
                  properties:
                    result:
                      $ref: '#/components/schemas/DirectoryEntry'
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
        '404':
          description: HTTP 404 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: routes/directory.ts:entry
      x-rate-limits:
      - method: GET
        path: /v1/directory/{refKind}/{refId}
        bucket: public-reads
        max: 60
        windowMs: 60000
        identity: client_ip
  /v1/directory/{refKind}/{refId}/ask:
    post:
      operationId: post_directory_refKind_refId_ask
      summary: Ask a currently eligible hosted directory agent a question.
      tags:
      - Directory
      security:
      - bearerAuth: []
      parameters:
      - name: refKind
        in: path
        required: true
        schema:
          type: string
      - name: refId
        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/post_v1_directory_refKind_refId_ask_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'
        '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/directory.ts:63
      x-rate-limits:
      - method: POST
        path: /v1/directory/{refKind}/{refId}/ask
        bucket: dir-ask-ip
        max: 60
        windowMs: 60000
        identity: client_ip
      - method: POST
        path: /v1/directory/{refKind}/{refId}/ask
        bucket: dir-ask-principal
        max: 60
        windowMs: 3600000
        identity: principal
components:
  schemas:
    DirectoryEntries:
      type: array
      items:
        $ref: '#/components/schemas/DirectoryEntry'
    DirectoryEntry:
      type: object
      required:
      - refKind
      - refId
      - handle
      - name
      - description
      - skills
      - languages
      - verified
      - signed
      - cardUrl
      - updatedAt
      properties:
        localizationFallback:
          anyOf:
          - type: boolean
            const: false
          - type: boolean
            const: true
        category:
          anyOf:
          - type: string
            const: ''
          - type: string
            const: business
          - type: string
            const: technology
          - type: string
            const: design
          - type: string
            const: education
          - type: string
            const: health
          - type: string
            const: travel
          - type: string
            const: home
          - type: string
            const: retail
        profileLanguage:
          type: string
        cooperation:
          type: object
          required:
          - enabled
          - validUntil
          - soughtTypes
          - contactChannel
          - source
          properties:
            enabled:
              type: boolean
              const: true
            validUntil:
              type: string
            soughtTypes:
              type: array
              items:
                anyOf:
                - type: string
                  const: other
                - type: string
                  const: sponsorship
                - type: string
                  const: product_placement
                - type: string
                  const: guest_content
                - type: string
                  const: affiliate
            contactChannel:
              anyOf:
              - type: string
                const: website
              - type: string
                const: email
              - type: string
                const: phone
              - type: string
                const: whatsapp
            soughtText:
              type: string
            excludedTypes:
              type: array
              items:
                anyOf:
                - type: string
                  const: other
                - type: string
                  const: sponsorship
                - type: string
                  const: product_placement
                - type: string
                  const: guest_content
                - type: string
                  const: affiliate
            excludedText:
              type: string
            audience:
              type: string
            terms:
              type: string
            responseTarget:
              type: string
            source:
              type: string
              const: owner
          additionalProperties: false
        verifications:
          type: array
          items:
            $ref: '#/components/schemas/PublicVerification'
        logoUrl:
          type: string
        refKind:
          anyOf:
          - type: string
            const: external
          - type: string
            const: hosted
        refId:
          type: string
        handle:
          type: string
        name:
          type: string
        description:
          type: string
        skills:
          type: array
          items:
            type: object
            required:
            - id
            - name
            - tags
            properties:
              id:
                type: string
              name:
                type: string
              description:
                type: string
              tags:
                type: array
                items:
                  type: string
            additionalProperties: false
        languages:
          type: array
          items:
            type: string
        verified:
          type: boolean
        signed:
          type: boolean
        pagePath:
          type: string
        cardUrl:
          type: string
        location:
          type: object
          required:
          - label
          - lat
          - lng
          properties:
            label:
              type: string
            lat:
              type: number
            lng:
              type: number
          additionalProperties: false
        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.
    post_v1_directory_refKind_refId_ask_Result:
      type: object
      required:
      - text
      - refKind
      - refId
      - external
      properties:
        text:
          type: string
        refKind:
          anyOf:
          - type: string
            const: external
          - type: string
            const: hosted
        refId:
          type: string
        external:
          type: boolean
        contextId:
          type: string
      additionalProperties: false
    PublicVerification:
      type: object
      additionalProperties: false
      required:
      - method
      - assurance
      - subject
      - verifiedAt
      properties:
        method:
          type: string
          enum:
          - website_file
          - domain_email
          - github_account
          - social_profile_manual
          - operator_attestation
        assurance:
          type: string
          enum:
          - website_publication_control
          - domain_mailbox_access
          - platform_account_control
          - profile_edit_control_observed
          - owner_identity_attested
        subject:
          oneOf:
          - type: object
            additionalProperties: false
            required:
            - type
            - value
            properties:
              type:
                const: domain
              value:
                type: string
          - type: object
            additionalProperties: false
            required:
            - type
            - platform
            - id
            - login
            - url
            properties:
              type:
                const: account
              platform:
                const: github
              id:
                type: string
              login:
                type: string
              url:
                type: string
                format: uri
          - type: object
            additionalProperties: false
            required:
            - type
            - platform
            - url
            properties:
              type:
                const: profile
              platform:
                enum:
                - instagram
                - tiktok
                - youtube
              url:
                type: string
                format: uri
          - type: object
            additionalProperties: false
            required:
            - type
            - slug
            properties:
              type:
                const: hosted_agent
              slug:
                type: string
        verifiedAt:
          type: number
        recheckDueAt:
          type: number
      description: Specific resource control, or an explicit operator attestation of the profile owner. Operator attestation does not prove website/mailbox/platform control, official identity or legal representation. No mailbox, tokens or private reviewer data. Directory verified means at least one current proof, on Free and AI Shop.
    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
  responses:
    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'
  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'