gaipagents-com

gaipagents-com Discovery API

Agent cards, MCP Server Cards, catalogs, guides and product documents.

Documentation GitHub OpenAPI

Operations 31

GET /.well-known/agent-card.json Platform A2A Agent Card #

GET /.well-known/agent-registration.json Get erc8004 registration #

GET /.well-known/ai-catalog.json Get agentic resource catalog #

GET /.well-known/mcp.json MCP discovery document (older shape) #

GET /.well-known/mcp/server-card.json MCP Server Card (well-known alias) #

GET /a2a/extensions/verify-before-call.json Get verify before call A2A extension #

POST /a2a/witness-agent Post a2a witness agent #

POST /a2a/{agent_id} Post a2a agent id #

GET /agents/{agent_id}/.well-known/agent-card.json Specialist A2A Agent Card #

GET /agentverse-profile.json Get agentverse profile #

GET /entra-agent-id.json Get entra agent id mapping #

GET /erc8004/roster.json Get erc8004 roster #

GET /erc8004/status.json Get erc8004 preparation status #

GET /extended-preflight-capabilities.json Get extended preflight publication #

GET /external-task-example.json Get external task example #

GET /integrations.json Get interoperability map #

GET /llms-full.txt Agent-readable guide (full) #

GET /llms.txt Agent-readable guide #

GET /mcp Get mcp #

POST /mcp Post mcp #

GET /mcp/agents/{agent_id} Specialist MCP descriptor #

POST /mcp/agents/{agent_id} Call a specialist over MCP #

GET /mcp/agents/{agent_id}/server-card Specialist MCP Server Card (SEP-2127) #

GET /mcp/all Platform MCP server (full catalogue) #

POST /mcp/all Call the platform MCP server (full catalogue) #

GET /mcp/server-card MCP Server Card (SEP-2127) #

GET /protocol-verification.json Get protocol verification plan #

GET /v1/free/capabilities Get free capabilities #

GET /v1/free/discovery/listing-kit Directory listing kit #

GET /v1/free/plans Plans #

GET /v1/free/products Get V1Free products #

Documentation

📖

Documentation

https://www.gaipagents.com

📖

APIReference

https://www.gaipagents.com/openapi.json

Specifications

⚙

OpenAPI

https://artifacts.apis.io/gaipagents-com/openapi/gaipagents-com-discovery-api-openapi.yml

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/gaipagents-com:gaipagents-com-discovery-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  contact:
    name: GAIP
    url: https://www.gaipagents.com/contact
  description: 'GAIP, the Governed Agentic Intelligence Platform, keeps an independent, dated record of what AI agents, MCP servers and online shops publish, and answers questions about that record with signed receipts. Free, read-only, no key; facts at a stated time, never an assessment. First call: gaip_check on https://www.gaipagents.com/mcp, or GET https://www.gaipagents.com/v1/free/conformance/check?url=. What it answers, by who asks: https://www.gaipagents.com/v1/free/map. Every completed answer carries a continuity handle; send it back and the answer is bound to your own history with GAIP.'
  summary: GAIP keeps an independent, dated record of what AI agents, MCP servers and online shops publish.
  termsOfService: https://www.gaipagents.com/terms
  title: GAIP Discovery API
  version: 1.8.0
  x-gaip-legal:
    corrections: https://www.gaipagents.com/corrections
    methodology: https://www.gaipagents.com/methodology
    privacyPolicy: https://www.gaipagents.com/privacy
    status: DRAFT_PENDING_LEGAL_REVIEW
    termsOfService: https://www.gaipagents.com/terms
  x-gaip-manifest-version: 0.15.0
  x-gaip-platform-name: GAIP
servers:
- url: https://www.gaipagents.com
security: []
tags:
- description: Agent cards, MCP Server Cards, catalogs, guides and product documents.
  name: Discovery
paths:
  /.well-known/agent-card.json:
    get:
      description: The GAIP Broker router card and specialist directory.
      operationId: getPlatformAgentCard
      responses:
        '200':
          description: OK
      summary: Platform A2A Agent Card
      tags:
      - Discovery
  /.well-known/agent-registration.json:
    get:
      description: GET /.well-known/agent-registration.json
      operationId: getErc8004Registration
      responses:
        '200':
          description: 'Canonical GAIP registration metadata with the Base Sepolia #9315 identity binding'
      tags:
      - Discovery
      summary: Get erc8004 registration
      x-summary-source: derived
  /.well-known/ai-catalog.json:
    get:
      description: GET /.well-known/ai-catalog.json
      operationId: getAgenticResourceCatalog
      responses:
        '200':
          description: Agentic Resource Discovery catalog
      tags:
      - Discovery
      summary: Get agentic resource catalog
      x-summary-source: derived
  /.well-known/mcp.json:
    get:
      description: Endpoint, transport and every tool name.
      operationId: getLegacyMcpCard
      responses:
        '200':
          description: OK
      summary: MCP discovery document (older shape)
      tags:
      - Discovery
  /.well-known/mcp/server-card.json:
    get:
      description: Same document as /mcp/server-card.
      operationId: getWellKnownMcpServerCard
      responses:
        '200':
          description: OK
      summary: MCP Server Card (well-known alias)
      tags:
      - Discovery
  /a2a/extensions/verify-before-call.json:
    get:
      description: GET /a2a/extensions/verify-before-call.json
      operationId: getVerifyBeforeCallA2AExtension
      responses:
        '200':
          description: A2A verify-before-call extension descriptor
      tags:
      - Discovery
      summary: Get verify before call A2A extension
      x-summary-source: derived
  /a2a/witness-agent:
    post:
      description: Send a structured task to the canonical Witness Agent
      operationId: postA2aWitnessAgent
      responses:
        '200':
          description: OK
      tags:
      - Discovery
      summary: Post a2a witness agent
      x-summary-source: derived
  /a2a/{agent_id}:
    post:
      description: Send a structured A2A message or retrieve a retained task
      operationId: postA2aAgentId
      parameters:
      - in: path
        name: agent_id
        required: true
        schema:
          type: string
      requestBody:
        $ref: '#/components/requestBodies/JsonObject'
      responses:
        '200':
          description: A2A JSON-RPC response
      tags:
      - Discovery
      summary: Post a2a agent id
      x-summary-source: derived
  /agents/{agent_id}/.well-known/agent-card.json:
    get:
      description: A2A card with one skill per tool, examples, product membership and legal links.
      operationId: getSpecialistAgentCard
      parameters:
      - description: Specialist id
        in: path
        name: agent_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Agent Card
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unknown agent
      summary: Specialist A2A Agent Card
      tags:
      - Discovery
  /agentverse-profile.json:
    get:
      description: GET /agentverse-profile.json
      operationId: getAgentverseProfile
      responses:
        '200':
          description: Publication-ready profile; activation requires authenticated founder action
      tags:
      - Discovery
      summary: Get agentverse profile
      x-summary-source: derived
  /entra-agent-id.json:
    get:
      description: GET /entra-agent-id.json
      operationId: getEntraAgentIdMapping
      responses:
        '200':
          description: Fail-closed Entra mapping; no tenant secrets
      tags:
      - Discovery
      summary: Get entra agent id mapping
      x-summary-source: derived
  /erc8004/roster.json:
    get:
      description: GET /erc8004/roster.json
      operationId: getErc8004Roster
      responses:
        '200':
          description: GAIP roster including the Base Sepolia platform registration and deferred identities
      tags:
      - Discovery
      summary: Get erc8004 roster
      x-summary-source: derived
  /erc8004/status.json:
    get:
      description: GET /erc8004/status.json
      operationId: getErc8004PreparationStatus
      responses:
        '200':
          description: Fail-closed on-chain registration and wallet status
      tags:
      - Discovery
      summary: Get erc8004 preparation status
      x-summary-source: derived
  /extended-preflight-capabilities.json:
    get:
      description: GET /extended-preflight-capabilities.json
      operationId: getExtendedPreflightPublication
      responses:
        '200':
          description: Published five-capability activation metadata and unchanged authority boundaries
      tags:
      - Discovery
      summary: Get extended preflight publication
      x-summary-source: derived
  /external-task-example.json:
    get:
      description: GET /external-task-example.json
      operationId: getExternalTaskExample
      responses:
        '200':
          description: Copyable bounded task, receipt and outcome-linkage example
      tags:
      - Discovery
      summary: Get external task example
      x-summary-source: derived
  /integrations.json:
    get:
      description: GET /integrations.json
      operationId: getInteroperabilityMap
      responses:
        '200':
          description: Protocol integration states, dependencies, targets and non-credit rules
      tags:
      - Discovery
      summary: Get interoperability map
      x-summary-source: derived
  /llms-full.txt:
    get:
      description: llms.txt plus every tool.
      operationId: getLlmsFullTxt
      responses:
        '200':
          description: OK
      summary: Agent-readable guide (full)
      tags:
      - Discovery
  /llms.txt:
    get:
      description: Products, agents, key tools and examples.
      operationId: getLlmsTxt
      responses:
        '200':
          description: OK
      summary: Agent-readable guide
      tags:
      - Discovery
  /mcp:
    get:
      description: Discover GAIP's live MCP server
      operationId: getMcp
      responses:
        '200':
          description: OK
      tags:
      - Discovery
      summary: Get mcp
      x-summary-source: derived
    post:
      description: Call GAIP MCP initialize, tools/list or tools/call
      operationId: postMcp
      requestBody:
        $ref: '#/components/requestBodies/JsonObject'
      responses:
        '200':
          description: MCP JSON-RPC response
      tags:
      - Discovery
      summary: Post mcp
      x-summary-source: derived
  /mcp/agents/{agent_id}:
    get:
      description: One specialist's MCP endpoint and scoped tools.
      operationId: getSpecialistMcpDescriptor
      parameters:
      - description: Specialist id
        in: path
        name: agent_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Descriptor
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unknown agent
      summary: Specialist MCP descriptor
      tags:
      - Discovery
    post:
      description: MCP JSON-RPC (initialize, tools/list, tools/call) scoped to one specialist's tools.
      operationId: callSpecialistMcp
      parameters:
      - description: Specialist id
        in: path
        name: agent_id
        required: true
        schema:
          type: string
      requestBody:
        $ref: '#/components/requestBodies/JsonObject'
      responses:
        '200':
          description: MCP JSON-RPC response
      summary: Call a specialist over MCP
      tags:
      - Discovery
  /mcp/agents/{agent_id}/server-card:
    get:
      description: Identity and connection details.
      operationId: getSpecialistServerCard
      parameters:
      - description: Specialist id
        in: path
        name: agent_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Server Card
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Unknown agent
      summary: Specialist MCP Server Card (SEP-2127)
      tags:
      - Discovery
  /mcp/all:
    get:
      description: Same MCP server as /mcp; tools/list here lists every GAIP tool (the platform /mcp lists the five front-door tools…
      externalDocs:
        url: https://www.gaipagents.com/docs/api#getMcpAllTools
      operationId: getMcpAllTools
      responses:
        '200':
          description: OK
      summary: Platform MCP server (full catalogue)
      tags:
      - Discovery
    post:
      description: MCP JSON-RPC (initialize, tools/list, tools/call). Every tool name is callable here and on /mcp.
      operationId: callMcpAllTools
      requestBody:
        $ref: '#/components/requestBodies/JsonObject'
      responses:
        '200':
          description: MCP JSON-RPC response
      summary: Call the platform MCP server (full catalogue)
      tags:
      - Discovery
  /mcp/server-card:
    get:
      description: Identity and connection details of the platform MCP server; tools stay authoritative on tools/list.
      operationId: getMcpServerCard
      responses:
        '200':
          description: OK
      summary: MCP Server Card (SEP-2127)
      tags:
      - Discovery
  /protocol-verification.json:
    get:
      description: GET /protocol-verification.json
      operationId: getProtocolVerificationPlan
      responses:
        '200':
          description: Cross-protocol positive and negative verification contract
      tags:
      - Discovery
      summary: Get protocol verification plan
      x-summary-source: derived
  /v1/free/capabilities:
    get:
      description: GET /v1/free/capabilities
      operationId: getFreeCapabilities
      responses:
        '200':
          description: Bounded free public capabilities and authority limits
      tags:
      - Discovery
      summary: Get free capabilities
      x-summary-source: derived
  /v1/free/discovery/listing-kit:
    get:
      description: Name, one-liners, descriptions, categories, endpoints, logo and legal links for directories.
      operationId: getListingKit
      responses:
        '200':
          description: OK
      summary: Directory listing kit
      tags:
      - Discovery
  /v1/free/plans:
    get:
      description: 'The only public plan: free. Paid tiers are not offered.'
      operationId: getPlans
      responses:
        '200':
          description: OK
      summary: Plans
      tags:
      - Discovery
  /v1/free/products:
    get:
      description: GAIP products, each named by the map rows its agent answers, with the agents behind them
      operationId: getV1FreeProducts
      responses:
        '200':
          description: Product map
      tags:
      - Discovery
      summary: Get V1Free products
      x-summary-source: derived
components:
  schemas:
    Error:
      additionalProperties: true
      description: 'Error body returned by GAIP routes: a stable machine code plus optional detail.'
      properties:
        detail:
          description: Optional human-readable detail or structured context.
        error:
          description: Stable machine-readable error code, e.g. NOT_FOUND.
          type: string
        failure_class:
          description: Optional failure class for storage errors.
          type: string
      required:
      - error
      type: object
  requestBodies:
    JsonObject:
      content:
        application/json:
          schema:
            type: object
      required: true
externalDocs:
  description: Agent-readable guide
  url: https://www.gaipagents.com/llms.txt
x-gaip-internal-paths:
  description: Served but not part of the public API listing (operations, programme metrics, founder-only plans). No stability commitment.
  paths:
  - /a2a/buyer-assurance
  - /activation-pack.json
  - /erc8004/transaction-plan.json
  - /examples/art-claix-002.json
  - /examples/broker-claix-002.json
  - /integration.json
  - /measurement.json
  - /onboarding.json
  - /phase-entry.json
  - /phase1-acceleration.json
  - /phase1-exit.json
  - /phase1-outcome-receipt-schema.json
  - /phase1-receipt-verification.json
  - /phase1-receipts/preflight
  - /phase1-scorecard.json
  - /phase1-use-receipt-schema.json
  - /progress.json
  - /proof.json
  - /schemas/counterparty-evidence-request-v1.schema.json
  - /schemas/counterparty-evidence-response-v1.schema.json
  - /shared-result.json
  - /status.json
  - /v1/free/adoption/status
  - /v1/free/agents/buyer-assurance/operations
  - /v1/free/art/evaluate
  - /v1/free/broker/preflight
  - /v1/free/commercial/capabilities
  - /v1/free/commercial/coo-report
  - /v1/free/commercial/outcome-value/capabilities
  - /v1/free/counterparty-evidence
  - /v1/free/delegation-evidence
  - /v1/free/design-partner/qualify
  - /v1/free/digital-art/evidence-check
  - /v1/free/discovery/cohort
  - /v1/free/extended-preflight/capabilities
  - /v1/free/history/metrics
  - /v1/free/incubator/agent-output-assurance
  - /v1/free/interoperability/recovery
  - /v1/free/loop/run
  - /v1/free/outcomes/preflight
  - /v1/free/sales/inbound-reply
  - /v1/free/sales/outbound-policy
  - /v1/free/verify-before-call
  - /v1/shadow/services
  - /value-outputs.json
x-gaip-native-execution:
  automaticEvidenceCredit: false
  durableReceiptRequiredBeforeSuccess: true
  status: ACTIVE_BOUNDED_FREE
  transports:
  - A2A_JSONRPC
  - MCP_STREAMABLE_HTTP_JSONRPC
  - OPENAPI_HTTPS