ModelMarket .well Known API

The .well Known API from ModelMarket — 1 operation(s) for .well known.

GitHub OpenAPI

Operations 31

GET /.well-known/ai-market.json Aimarket Well Known #
HEAD /.well-known/ai-market.json Well Known #
GET /discovery/resources Bazaar Discovery #
GET /schemas/{filename} Protocol Schema #
GET /schemas Protocol Schema Index #
GET /.well-known/agent-marketplace Well Known Draft #
HEAD /.well-known/agent-marketplace Well Known Draft #
GET /.well-known/mcp/server-card.json Mcp Server Card #
HEAD /.well-known/mcp/server-card.json Mcp Server Card #
GET /llms.txt Mcp Llms Txt #
HEAD /llms.txt Mcp Llms Txt #
GET /.well-known/ard.json Ard Manifest #
HEAD /.well-known/ard.json Ard Manifest #
GET /.well-known/did.json Did Document #
HEAD /.well-known/did.json Did Document #
GET /ard/v1 Ard Registry #
POST /ard/v1/search Ard Search #
POST /ard/v1/explore Ard Explore #
GET /ard/v1/agents Ard Agents #
GET /ard/v1/capability Ard Capability #
HEAD /ard/v1/capability Ard Capability #
GET /mcp/server-card Mcp Server Card #
HEAD /mcp/server-card Mcp Server Card #
GET /.well-known/ai-catalog.json Ai Catalog Document #
HEAD /.well-known/ai-catalog.json Ai Catalog Document #
GET /ai-catalog/v1/capabilities.json Ai Catalog Capabilities #
HEAD /ai-catalog/v1/capabilities.json Ai Catalog Capabilities #
GET /ai-catalog/v1/ids/{name} Ai Catalog Identifier #
HEAD /ai-catalog/v1/ids/{name} Ai Catalog Identifier #
GET /ai-catalog/profiles/{name} Ai Catalog Profile #
HEAD /ai-catalog/profiles/{name} Ai Catalog 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/modelmarket-dev:modelmarket-dev-well-known-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

modelmarket-dev-well-known-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ATLAS .well Known API
  version: 0.3.3
tags:
- name: .well Known
paths:
  /.well-known/ai-market.json:
    get:
      summary: Aimarket Well Known
      operationId: aimarket_well_known__well_known_ai_market_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Aimarket Well Known  Well Known Ai Market Json Get
      tags:
      - .well Known
    head:
      tags:
      - .well Known
      summary: Well Known
      operationId: headWellKnownAiMarketJson
      parameters:
      - name: x-aimarket-crawler
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: X-Aimarket-Crawler
      - name: agent-marketplace-crawler
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Agent-Marketplace-Crawler
      - name: user-agent
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: User-Agent
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: well_known__well_known_ai_market_json_get
  /discovery/resources:
    get:
      tags:
      - .well Known
      summary: Bazaar Discovery
      description: 'A Bazaar-compatible discovery index of what this hub sells.


        The x402 Bazaar is not a registry anyone registers with — it is a per-facilitator

        index, and its specification says in as many words that any facilitator may run its

        own. Serving this envelope means every official x402 SDK can enumerate this hub''s

        catalogue with no code changes: point a facilitator client at this host and call

        `listResources`.


        That matters more than one endpoint usually does. Each existing Bazaar catalogues

        only what its own facilitator settles, and they do not federate — Coinbase''s index

        and PayAI''s share no entries at all. An index that can be crawled by others is the

        one thing that turns a set of disjoint catalogues back into a market, which is what

        this protocol is for.


        Public and unauthenticated by design. SDK clients attach auth headers on their way

        in; a public index ignores them rather than rejecting the request.'
      operationId: bazaar_discovery_discovery_resources_get
      parameters:
      - name: type
        in: query
        required: false
        schema:
          type: string
          default: http
          title: Type
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /schemas/{filename}:
    get:
      tags:
      - .well Known
      summary: Protocol Schema
      operationId: protocol_schema_schemas__filename__get
      parameters:
      - name: filename
        in: path
        required: true
        schema:
          type: string
          title: Filename
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /schemas:
    get:
      tags:
      - .well Known
      summary: Protocol Schema Index
      operationId: protocol_schema_index_schemas_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /.well-known/agent-marketplace:
    get:
      tags:
      - .well Known
      summary: Well Known Draft
      description: 'The discovery document under the Internet-Draft''s name and member names.


        Same key, same catalogue, same counts as ``/.well-known/ai-market.json`` — it is

        built from that document, so the two cannot disagree. ``peers`` is the list of

        discovery-document URIs this hub actually reads for its admitted peers; the

        legacy document keeps the richer per-peer objects. Served alongside the legacy

        path, not instead of it: no peer reads this one yet.'
      operationId: well_known_draft__well_known_agent_marketplace_get
      parameters:
      - name: x-aimarket-crawler
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: X-Aimarket-Crawler
      - name: agent-marketplace-crawler
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Agent-Marketplace-Crawler
      - name: user-agent
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: User-Agent
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    head:
      tags:
      - .well Known
      summary: Well Known Draft
      description: 'The discovery document under the Internet-Draft''s name and member names.


        Same key, same catalogue, same counts as ``/.well-known/ai-market.json`` — it is

        built from that document, so the two cannot disagree. ``peers`` is the list of

        discovery-document URIs this hub actually reads for its admitted peers; the

        legacy document keeps the richer per-peer objects. Served alongside the legacy

        path, not instead of it: no peer reads this one yet.'
      operationId: headWellKnownAgentMarketplace
      parameters:
      - name: x-aimarket-crawler
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: X-Aimarket-Crawler
      - name: agent-marketplace-crawler
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Agent-Marketplace-Crawler
      - name: user-agent
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: User-Agent
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: well_known_draft__well_known_agent_marketplace_get
  /.well-known/mcp/server-card.json:
    get:
      tags:
      - .well Known
      summary: Mcp Server Card
      operationId: mcp_server_card__well_known_mcp_server_card_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - .well Known
      summary: Mcp Server Card
      operationId: headWellKnownMcpServerCardJson
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: mcp_server_card__well_known_mcp_server_card_json_get
  /llms.txt:
    get:
      tags:
      - .well Known
      summary: Mcp Llms Txt
      operationId: mcp_llms_txt_llms_txt_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - .well Known
      summary: Mcp Llms Txt
      operationId: headLlmsTxt
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: mcp_llms_txt_llms_txt_get
  /.well-known/ard.json:
    get:
      tags:
      - .well Known
      summary: Ard Manifest
      description: This hub's ARD manifest (draft-jimenez-dawn-ard-initial-contact-00 §4.3.1).
      operationId: ard_manifest__well_known_ard_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - .well Known
      summary: Ard Manifest
      description: This hub's ARD manifest (draft-jimenez-dawn-ard-initial-contact-00 §4.3.1).
      operationId: headWellKnownArdJson
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: ard_manifest__well_known_ard_json_get
  /.well-known/did.json:
    get:
      tags:
      - .well Known
      summary: Did Document
      description: The did:web document the ARD trustManifests name as their identity.
      operationId: did_document__well_known_did_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - .well Known
      summary: Did Document
      description: The did:web document the ARD trustManifests name as their identity.
      operationId: headWellKnownDidJson
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: did_document__well_known_did_json_get
  /ard/v1:
    get:
      tags:
      - .well Known
      summary: Ard Registry
      description: What this registry implements. Not defined by ARD; a client may ignore it.
      operationId: ard_registry_ard_v1_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /ard/v1/search:
    post:
      tags:
      - .well Known
      summary: Ard Search
      description: POST /search (draft-bu-dawn-ard-discovery-00 §4.2.2).
      operationId: ard_search_ard_v1_search_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /ard/v1/explore:
    post:
      tags:
      - .well Known
      summary: Ard Explore
      description: 'POST /explore (§4.2.3): facet counts over the entries a query selects.'
      operationId: ard_explore_ard_v1_explore_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /ard/v1/agents:
    get:
      tags:
      - .well Known
      summary: Ard Agents
      description: 'GET /agents (§4.2.4): every entry, ordered by identifier, filtered by query

        parameters named like the filter terms (repeat a parameter for OR).'
      operationId: ard_agents_ard_v1_agents_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /ard/v1/capability:
    get:
      tags:
      - .well Known
      summary: Ard Capability
      description: 'The descriptor an entry''s ``url`` names: the bytes its ``digest`` pins.'
      operationId: ard_capability_ard_v1_capability_get
      parameters:
      - name: product_id
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Product Id
      - name: capability_id
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Capability Id
      - name: source_hub
        in: query
        required: false
        schema:
          type: string
          default: local
          title: Source Hub
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    head:
      tags:
      - .well Known
      summary: Ard Capability
      description: 'The descriptor an entry''s ``url`` names: the bytes its ``digest`` pins.'
      operationId: headArdV1Capability
      parameters:
      - name: product_id
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Product Id
      - name: capability_id
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Capability Id
      - name: source_hub
        in: query
        required: false
        schema:
          type: string
          default: local
          title: Source Hub
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ard_capability_ard_v1_capability_get
  /mcp/server-card:
    get:
      tags:
      - .well Known
      summary: Mcp Server Card
      description: This hub's MCP endpoint as a Server Card (SEP-2127), at ``/server-card``.
      operationId: mcp_server_card_mcp_server_card_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - .well Known
      summary: Mcp Server Card
      description: This hub's MCP endpoint as a Server Card (SEP-2127), at ``/server-card``.
      operationId: headMcpServerCard
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: mcp_server_card_mcp_server_card_get
  /.well-known/ai-catalog.json:
    get:
      tags:
      - .well Known
      summary: Ai Catalog Document
      description: This hub's AI Catalog (https://ai-catalog.io/, section "Well-Known URI").
      operationId: ai_catalog_document__well_known_ai_catalog_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - .well Known
      summary: Ai Catalog Document
      description: This hub's AI Catalog (https://ai-catalog.io/, section "Well-Known URI").
      operationId: headWellKnownAiCatalogJson
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: ai_catalog_document__well_known_ai_catalog_json_get
  /ai-catalog/v1/capabilities.json:
    get:
      tags:
      - .well Known
      summary: Ai Catalog Capabilities
      description: Every sellable capability as a Catalog Entry; the catalogue above links here.
      operationId: ai_catalog_capabilities_ai_catalog_v1_capabilities_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    head:
      tags:
      - .well Known
      summary: Ai Catalog Capabilities
      description: Every sellable capability as a Catalog Entry; the catalogue above links here.
      operationId: headAiCatalogV1CapabilitiesJson
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      x-operation-id-source: normalized
      x-operation-id-original: ai_catalog_capabilities_ai_catalog_v1_capabilities_json_get
  /ai-catalog/v1/ids/{name}:
    get:
      tags:
      - .well Known
      summary: Ai Catalog Identifier
      description: 'An identifier this hub assigned to a capability it copies from a peer: redirects to

        the capability''s descriptor.'
      operationId: ai_catalog_identifier_ai_catalog_v1_ids__name__get
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    head:
      tags:
      - .well Known
      summary: Ai Catalog Identifier
      description: 'An identifier this hub assigned to a capability it copies from a peer: redirects to

        the capability''s descriptor.'
      operationId: headAiCatalogV1IdsByName
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ai_catalog_identifier_ai_catalog_v1_ids__name__get
  /ai-catalog/profiles/{name}:
    get:
      tags:
      - .well Known
      summary: Ai Catalog Profile
      description: 'The definition of a signer profile these catalogues name (a profile defined outside the

        AI Catalog specification is identified by a URL that serves its definition).'
      operationId: ai_catalog_profile_ai_catalog_profiles__name__get
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    head:
      tags:
      - .well Known
      summary: Ai Catalog Profile
      description: 'The definition of a signer profile these catalogues name (a profile defined outside the

        AI Catalog specification is identified by a URL that serves its definition).'
      operationId: headAiCatalogProfilesByName
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
          title: Name
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-operation-id-source: normalized
      x-operation-id-original: ai_catalog_profile_ai_catalog_profiles__name__get
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError