{"components":{"requestBodies":{"JsonObject":{"content":{"application/json":{"schema":{"type":"object"}}},"required":true}},"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"}}},"externalDocs":{"description":"Agent-readable guide","url":"https://www.gaipagents.com/llms.txt"},"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=<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","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"},"openapi":"3.1.0","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"]}},"/.well-known/ai-catalog.json":{"get":{"description":"GET /.well-known/ai-catalog.json","operationId":"getAgenticResourceCatalog","responses":{"200":{"description":"Agentic Resource Discovery catalog"}},"tags":["Discovery"]}},"/.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"]}},"/a2a/witness-agent":{"post":{"description":"Send a structured task to the canonical Witness Agent","operationId":"postA2aWitnessAgent","responses":{"200":{"description":"OK"}},"tags":["Discovery"]}},"/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"]}},"/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"]}},"/data/weekly/{week}/{file}":{"get":{"description":"A frozen ISO week's files, built once when the week is frozen: totals.csv / totals.jsonl (aggregate figures, one row…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getWeeklyDownload"},"operationId":"getWeeklyDownload","parameters":[{"description":"ISO week YYYY-Www, or latest","in":"path","name":"week","required":true,"schema":{"type":"string"}},{"description":"totals.csv, totals.jsonl, changes.csv or changes.jsonl","in":"path","name":"file","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The file (text/csv or application/jsonlines)"},"302":{"description":"Redirect to the newest week"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Week not built"}},"summary":"Weekly download file","tags":["Agent Observatory"]}},"/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"]}},"/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"]}},"/erc8004/status.json":{"get":{"description":"GET /erc8004/status.json","operationId":"getErc8004PreparationStatus","responses":{"200":{"description":"Fail-closed on-chain registration and wallet status"}},"tags":["Discovery"]}},"/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"]}},"/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"]}},"/history.json":{"get":{"description":"GET /history.json","operationId":"getHistory","responses":{"200":{"description":"Public evidence feed"}},"tags":["Evidence Ledger"]}},"/integrations.json":{"get":{"description":"GET /integrations.json","operationId":"getInteroperabilityMap","responses":{"200":{"description":"Protocol integration states, dependencies, targets and non-credit rules"}},"tags":["Discovery"]}},"/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"]},"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"]}},"/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"]}},"/receipts/{receipt_id}":{"get":{"description":"GET /receipts/{receipt_id}","operationId":"getReceipt","parameters":[{"in":"path","name":"receipt_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"Receipt"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not found"}},"tags":["Evidence Ledger"]}},"/v1/free/acts":{"post":{"description":"MCP tool gaip_log_act over HTTP.","operationId":"postV1FreeActs","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Put what your agent did, promised or was told in the person's record","tags":["Platform"]}},"/v1/free/acts/recall-watch":{"get":{"description":"MCP tool gaip_recall_watch over HTTP.","operationId":"getV1FreeActsRecallWatch","parameters":[{"in":"query","name":"since","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Has a regulator's notice matched what my agent bought?","tags":["Platform"]}},"/v1/free/acts/switch-pack":{"get":{"description":"MCP tool gaip_switch_pack over HTTP.","operationId":"getV1FreeActsSwitchPack","responses":{"200":{"description":"OK"}},"summary":"Take your agents' record with you (the switch pack)","tags":["Platform"]}},"/v1/free/agent-commerce/check":{"get":{"description":"MCP tool gaip_check_agent_commerce over HTTP.","operationId":"getV1FreeAgentCommerceCheck","parameters":[{"in":"query","name":"host","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"What does this shop's own agent-commerce file say, as indexed?","tags":["The record"]}},"/v1/free/agent-web-index":{"get":{"description":"Monthly headline figures on the 2026-10 reference panel, each with its count, denominator and share (withheld under 5)…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getAgentWebIndex"},"operationId":"getAgentWebIndex","parameters":[{"description":"Calendar month YYYY-MM (default: this month)","in":"query","name":"month","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"externalDocs":{"url":"https://www.gaipagents.com/v1/free/data/dictionary"},"properties":{"available":{},"citation":{},"declared_derivations":{},"error":{},"example":{},"figures":{},"generated_at_utc":{},"json":{},"licence":{},"licence_url":{},"license":{},"meaning":{},"message":{},"minimum_cell_size":{},"month":{},"name":{},"not_collected_yet":{},"reliability":{},"reproduce":{},"rules":{},"sample_frame":{},"schema_version":{},"served":{},"status":{},"title":{},"weekly_totals_rule":{},"weeks":{},"window_utc":{}},"type":"object"}}},"description":"The month's index"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad month"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No copy stored for the month"}},"summary":"Agent Web Index (monthly)","tags":["Agent Observatory"],"x-license":{"covers":"aggregate figures","id":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/"}}},"/v1/free/capabilities":{"get":{"description":"GET /v1/free/capabilities","operationId":"getFreeCapabilities","responses":{"200":{"description":"Bounded free public capabilities and authority limits"}},"tags":["Discovery"]}},"/v1/free/changes/feed.atom":{"get":{"description":"Dated neutral facts about published MCP server and A2A agent manifests, newest first (at most 100): tools added…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getChangesAtomFeed"},"operationId":"getChangesAtomFeed","parameters":[{"description":"Target URL (MCP endpoint or agent card) for a per-target feed","in":"query","name":"url","schema":{"type":"string"}},{"description":"Observatory target id","in":"query","name":"target_id","schema":{"type":"string"}},{"description":"Maximum entries (default 50, at most 100)","in":"query","name":"limit","schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Atom feed (application/atom+xml)"},"304":{"description":"Not modified"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid query"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Target not observed"}},"summary":"Observatory change feed (Atom)","tags":["Agent Observatory"]}},"/v1/free/changes/feed.json":{"get":{"description":"The same entries as the Atom feed as JSON Feed 1.1 (application/feed+json).","operationId":"getChangesJsonFeed","parameters":[{"description":"Target URL for a per-target feed","in":"query","name":"url","schema":{"type":"string"}},{"description":"Observatory target id","in":"query","name":"target_id","schema":{"type":"string"}},{"description":"Maximum entries (default 50, at most 100)","in":"query","name":"limit","schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"JSON Feed"},"304":{"description":"Not modified"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid query"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Target not observed"}},"summary":"Observatory change feed (JSON Feed 1.1)","tags":["Agent Observatory"]}},"/v1/free/changes/subscribe":{"get":{"description":"Whether GAIP observes a URL, its feed URLs, its latest dated changes and how to get webhooks (gaip_watch_register); if…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#subscribeToChanges"},"operationId":"subscribeToChanges","parameters":[{"description":"Target URL","in":"query","name":"url","schema":{"type":"string"}},{"description":"Observatory target id","in":"query","name":"target_id","schema":{"type":"string"}}],"responses":{"200":{"description":"Subscription details"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid query"}},"summary":"Follow one target's changes","tags":["Agent Observatory"]}},"/v1/free/changes/weekly.json":{"get":{"description":"Per ISO week: aggregate counts (targets observed and changed, tools added and removed, reachability and protocol…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getWeeklyEcosystemChanges"},"operationId":"getWeeklyEcosystemChanges","parameters":[{"description":"ISO week, e.g. 2026-W40 (default: all weeks)","in":"query","name":"week","schema":{"type":"string"}}],"responses":{"200":{"description":"Weekly report"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Week not found"}},"summary":"What changed in the agent ecosystem (weekly)","tags":["Agent Observatory"]}},"/v1/free/citation-witness":{"get":{"description":"Input shape and limits for checking cited pages.","operationId":"describeCitationWitness","responses":{"200":{"description":"OK"}},"summary":"Citation witness: how to call","tags":["Delivery Assurance"]},"post":{"description":"Pass 1-20 citations {url, quote?, claimed_title?, claimed_date?}; robots.txt is respected and only a hash and short…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#witnessCitations"},"operationId":"witnessCitations","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"Per-citation results"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"}},"summary":"Check cited pages contain the quoted text","tags":["Delivery Assurance"]}},"/v1/free/commercial/outcome-value":{"post":{"description":"Produce a task outcome and cost dossier from caller-supplied public evidence; no independent verification or ROI claim.","operationId":"evaluateOutcomeValue","requestBody":{"content":{"application/json":{"schema":{"required":["data_classification","counterparty_id","task_class","episode_id","task","delivery","costs"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Retained dossier"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Blocked"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"History unavailable"}},"tags":["Evidence Ledger"]}},"/v1/free/commercial/repair":{"post":{"description":"Classify a supplied failure and propose a bounded repair; no patch or replay is performed.","operationId":"proposeIntegrationRepair","requestBody":{"content":{"application/json":{"schema":{"required":["data_classification","counterparty_id","task_class","protocol","failure"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Repair proposal and retained observation"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Blocked"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"History unavailable"}},"tags":["Supplier Reliability"]}},"/v1/free/commercial/verify":{"post":{"description":"Reconcile caller-supplied public claims, observations and metadata; no approval or remote probe.","operationId":"verifySupplierEvidence","requestBody":{"content":{"application/json":{"schema":{"required":["data_classification","counterparty_id","task_class","protocol","claims","metadata"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Claim dispositions and retained observation"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Blocked"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"History unavailable"}},"tags":["Delivery Assurance"]}},"/v1/free/commercial/watch":{"post":{"description":"Compare two caller-supplied snapshots; no scheduled monitoring or alert is activated.","operationId":"compareSupplierSnapshots","requestBody":{"content":{"application/json":{"schema":{"required":["data_classification","counterparty_id","task_class","protocol","prior","current"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Changes and retained observation"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Blocked"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"History unavailable"}},"tags":["Supplier Reliability"]}},"/v1/free/commercial/watch-status":{"get":{"description":"Current bounded public cohort snapshots, changes and GAIP-owned discovery-path repairs.","operationId":"getScheduledSupplierWatchStatus","responses":{"200":{"description":"Supplier Watch state"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"State unavailable"}},"tags":["Supplier Reliability"]}},"/v1/free/conformance/check":{"post":{"description":"Checks caller-supplied public A2A, MCP, or OpenAPI metadata: per-finding severity, JSON path, fix and spec link, a…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#checkPublicAgentConformance"},"operationId":"checkPublicAgentConformance","requestBody":{"content":{"application/json":{"schema":{"required":["data_classification","protocol","metadata"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Deterministic conformant or non-conformant report"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Malformed request"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Payload too large"}},"tags":["Agent Observatory"]}},"/v1/free/data/dictionary":{"get":{"description":"Every column of the weekly download files and every top-level field of the public data answers (summary, snapshots…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getDataDictionary"},"operationId":"getDataDictionary","responses":{"200":{"description":"OK"}},"summary":"Data dictionary","tags":["Agent Observatory"]}},"/v1/free/data/releases":{"get":{"description":"The append-only registry of GAIP's permanent dataset ids (e.g.","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getDataReleases"},"operationId":"getDataReleases","responses":{"200":{"content":{"application/json":{"schema":{"externalDocs":{"url":"https://www.gaipagents.com/v1/free/data/dictionary"},"properties":{"automatic_evidence_credit":{},"chain":{},"dois":{},"entries":{},"licence":{},"licence_url":{},"license":{},"meaning":{},"method":{},"notice":{},"price_gbp":{},"schema_version":{},"title":{},"weekly_snapshots":{}},"type":"object"}}},"description":"Registry"}},"summary":"Permanent ids of frozen cohorts and quarterly aggregate releases","tags":["Agent Observatory"],"x-license":{"covers":"aggregate figures","id":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/"}}},"/v1/free/disclosures/about-me":{"get":{"description":"MCP tool gaip_disclosures_about_me over HTTP (GET or POST).","operationId":"getV1FreeDisclosuresAboutMe","responses":{"200":{"description":"OK"}},"summary":"Which agents recorded passing data about my agent?","tags":["The record"]}},"/v1/free/disclosures/article30":{"get":{"description":"MCP tool gaip_disclosures_mine over HTTP.","operationId":"getV1FreeDisclosuresArticle30","responses":{"200":{"description":"OK"}},"summary":"What did my agent disclose or receive?","tags":["The record"]}},"/v1/free/disclosures/mine":{"get":{"description":"MCP tool gaip_disclosures_mine over HTTP (GET or POST).","operationId":"getV1FreeDisclosuresMine","responses":{"200":{"description":"OK"}},"summary":"What did my agent disclose or receive?","tags":["The record"]}},"/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/disputes/evidence":{"post":{"description":"POST /v1/free/disputes/evidence","operationId":"captureSymmetricDisputeEvidence","responses":{"202":{"description":"Quarantined unadjudicated evidence with equal response path"}},"tags":["Evidence Ledger"]}},"/v1/free/ecosystem/snapshots":{"get":{"description":"One aggregate snapshot per completed ISO week, frozen after the week ends and never rewritten: targets, reachability…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getEcosystemSnapshots"},"operationId":"getEcosystemSnapshots","parameters":[{"description":"ISO week, e.g. 2026-W40 (default: index of frozen weeks)","in":"query","name":"week","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"externalDocs":{"url":"https://www.gaipagents.com/v1/free/data/dictionary"},"properties":{"automatic_evidence_credit":{},"chain":{},"citation":{},"corrections":{},"error":{},"first_snapshot":{},"licence":{},"licence_url":{},"license":{},"method":{},"notice":{},"previous_sha256":{},"price_gbp":{},"schema_version":{},"snapshot":{},"snapshot_sha256":{},"title":{},"week":{},"weeks":{}},"type":"object"}}},"description":"Index or one snapshot"}},"summary":"Weekly agent-ecosystem snapshots (frozen, hash-chained)","tags":["Agent Observatory"],"x-license":{"covers":"aggregate figures","id":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/"}}},"/v1/free/evidence/freshness":{"post":{"description":"POST /v1/free/evidence/freshness","operationId":"checkEvidenceFreshness","responses":{"200":{"description":"Freshness and re-verification states without deleting history"}},"tags":["Evidence Ledger"]}},"/v1/free/evidence/incident-bundle":{"post":{"description":"Put the receipts and attributed observations about an incident in time order.","operationId":"buildIncidentBundle","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"Incident bundle"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"}},"summary":"Incident bundle","tags":["Evidence Ledger"]}},"/v1/free/evidence/pack":{"post":{"description":"Compile a subject's conformance, watch, witness and repair history into one dossier with a verify URL per item.","externalDocs":{"url":"https://www.gaipagents.com/docs/api#buildEvidencePack"},"operationId":"buildEvidencePack","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"Evidence pack"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"}},"summary":"Evidence pack","tags":["Evidence Ledger"]}},"/v1/free/evidence/receipt-spec":{"get":{"description":"The receipt format and verification procedure (text/markdown).","operationId":"getReceiptSpec","responses":{"200":{"description":"OK"}},"summary":"GAIP receipt specification","tags":["Evidence Ledger"]}},"/v1/free/host-timeline":{"get":{"description":"Dated events GAIP observed about one host across its records (Observatory capability record, agent keys, AI…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getHostTimeline"},"operationId":"getHostTimeline","parameters":[{"description":"The site's host name, e.g. shop.example","in":"query","name":"host","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The timeline (state TIMELINE, NO_RECORD, NOT_IN_PUBLIC_RECORD or WITHHELD)"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid host"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"summary":"GAIP's record about one site, as a timeline","tags":["Agent Observatory"]}},"/v1/free/host-timeline/verify":{"post":{"description":"Send {\"host\"} to get a private challenge and a token; publish the token at…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#verifyHostOwner"},"operationId":"verifyHostOwner","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"A token, or the verified timeline"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid host"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not verified"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"summary":"Your own site's full timeline, after proving you run it","tags":["Agent Observatory"]}},"/v1/free/interoperability/inspect":{"post":{"description":"POST /v1/free/interoperability/inspect","operationId":"inspectInteroperabilitySchemaDrift","responses":{"200":{"description":"Declaration consistency evidence with no suitability verdict"}},"tags":["Agent Observatory"]}},"/v1/free/knowledge/breaking-changes":{"get":{"description":"Versioned breaking-change taxonomy used by Supplier Watch","operationId":"getV1FreeKnowledgeBreakingChanges","responses":{"200":{"description":"Read-only public knowledge document"}},"tags":["Supplier Reliability"]}},"/v1/free/knowledge/conformance-rules":{"get":{"description":"Versioned catalogue of every conformance finding code (severity, fix, spec section, versions)","operationId":"getV1FreeKnowledgeConformanceRules","responses":{"200":{"description":"Read-only public knowledge document"}},"tags":["Agent Observatory"]}},"/v1/free/knowledge/error-kb":{"get":{"description":"Versioned error knowledge base used by Integration Repair (HTTP, JSON-RPC, A2A, MCP, LLM providers)","operationId":"getV1FreeKnowledgeErrorKb","responses":{"200":{"description":"Read-only public knowledge document"}},"tags":["Supplier Reliability"]}},"/v1/free/mandates/check":{"get":{"description":"MCP tool gaip_check_mandate over HTTP (GET or POST).","operationId":"getV1FreeMandatesCheck","parameters":[{"in":"query","name":"principal","schema":{"type":"string"}},{"in":"query","name":"agent","schema":{"type":"string"}},{"in":"query","name":"scope","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Was this agent mandated to act for them, as indexed?","tags":["The record"]}},"/v1/free/market/demand-signals":{"get":{"description":"Privacy-safe aggregate counts of requested task kinds over a fixed vocabulary.","operationId":"getDemandSignals","parameters":[{"description":"Look-back window in days","in":"query","name":"days","schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"OK"}},"summary":"Demand signals","tags":["Platform"]},"servers":[{"url":"https://gaip-agent-to-art-prototype-production.up.railway.app"}]},"/v1/free/member/history":{"get":{"description":"Receipts linked to the caller's continuity handle.","operationId":"getMemberHistory","parameters":[{"description":"Continuity handle '<continuity_id>.<token>' returned with an earlier receipt.","in":"header","name":"X-GAIP-Continuity","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"History"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No valid continuity handle"}},"summary":"Member history","tags":["Evidence Ledger"]},"servers":[{"url":"https://gaip-agent-to-art-prototype-production.up.railway.app"}]},"/v1/free/member/usage":{"get":{"description":"Today's call counts for the caller's continuity handle.","operationId":"getMemberUsage","parameters":[{"description":"Continuity handle '<continuity_id>.<token>' returned with an earlier receipt.","in":"header","name":"X-GAIP-Continuity","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Usage"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"No valid continuity handle"}},"summary":"Member usage","tags":["Evidence Ledger"]},"servers":[{"url":"https://gaip-agent-to-art-prototype-production.up.railway.app"}]},"/v1/free/notices":{"get":{"description":"MCP tool gaip_notices over HTTP (GET or POST).","operationId":"getV1FreeNotices","parameters":[{"in":"query","name":"urls","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Has anyone withdrawn or warned about this server?","tags":["The record"]}},"/v1/free/observatory/anchors":{"get":{"description":"Each day's signed chain-head document with its Sigstore/Rekor log index, OpenTimestamps proof and weekly Internet…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getRecordAnchors"},"operationId":"getRecordAnchors","parameters":[{"description":"Maximum anchors (default 30)","in":"query","name":"limit","schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"OK"}},"summary":"Dated chain-head anchors","tags":["Agent Observatory"]}},"/v1/free/observatory/changed-since":{"get":{"description":"Connect-time check: when GAIP began recording the server, its last recorded change, change classes since a date, stored…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getToolsChangedSince"},"operationId":"getToolsChangedSince","parameters":[{"description":"MCP endpoint or agent card URL, exactly as you connect to it","in":"query","name":"url","schema":{"type":"string"}},{"description":"Observatory target id","in":"query","name":"target_id","schema":{"type":"string"}},{"description":"Approval date (RFC 3339 or YYYY-MM-DD)","in":"query","name":"since","schema":{"type":"string"}},{"description":"SHA-256 (64 hex) of the tool list you approved","in":"query","name":"tools_digest","schema":{"type":"string"}}],"responses":{"200":{"description":"Facts (known: false with a capture offer when GAIP has no history yet)"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid input"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"summary":"Has this MCP server changed since GAIP began recording it?","tags":["Agent Observatory"]}},"/v1/free/observatory/changes":{"get":{"description":"Hash-chained log of published manifest changes (before/after hashes, time observed).","operationId":"getManifestChanges","parameters":[{"description":"ISO-8601 time or sequence to read from","in":"query","name":"since","schema":{"type":"string"}},{"description":"Observatory target id","in":"query","name":"target_id","schema":{"type":"string"}},{"description":"Maximum entries (default 50)","in":"query","name":"limit","schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"Change entries"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid query"}},"summary":"Manifest Transparency Log","tags":["Agent Observatory"]}},"/v1/free/observatory/corrections":{"post":{"description":"An operator can request a correction or exclusion of their public entries.","operationId":"submitObservatoryCorrection","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"202":{"description":"Accepted for review"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"summary":"Request a correction or opt-out","tags":["Agent Observatory"]}},"/v1/free/observatory/corrections/exclusion":{"post":{"description":"An opt-out only pauses.","externalDocs":{"url":"https://www.gaipagents.com/docs/api#confirmObservatoryExclusion"},"operationId":"confirmObservatoryExclusion","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"Token issued or excluded"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not confirmed"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"summary":"Make an opt-out permanent (site owner)","tags":["Agent Observatory"]}},"/v1/free/observatory/lookup":{"get":{"description":"Find an Observatory target by public url or name and read what it published over time.","operationId":"lookupObservatoryTarget","parameters":[{"description":"Public agent card, MCP endpoint or server URL","in":"query","name":"url","schema":{"type":"string"}},{"description":"Published name","in":"query","name":"name","schema":{"type":"string"}}],"responses":{"200":{"description":"Matching targets"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"url or name required"}},"summary":"Look up an observed agent or MCP server","tags":["Agent Observatory"]}},"/v1/free/observatory/methods":{"get":{"description":"Per long-run dataset: each method version, when it took effect, what changed, known defects of earlier versions and the…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getDatasetMethods"},"operationId":"getDatasetMethods","responses":{"200":{"content":{"application/json":{"schema":{"externalDocs":{"url":"https://www.gaipagents.com/v1/free/data/dictionary"},"properties":{"datasets":{},"from_basis_note":{},"license":{},"meaning":{},"method_doc":{},"overlap_rule":{},"schema_version":{},"title":{},"url":{}},"type":"object"}}},"description":"OK"}},"summary":"Dataset method versions","tags":["Agent Observatory"],"x-license":{"covers":"aggregate figures","id":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/"}}},"/v1/free/observatory/summary":{"get":{"description":"Totals and common fixes across observed public MCP servers and A2A agents; no named verdicts.","operationId":"getObservatorySummary","responses":{"200":{"content":{"application/json":{"schema":{"externalDocs":{"url":"https://www.gaipagents.com/v1/free/data/dictionary"},"properties":{"automatic_evidence_credit":{},"capability_record":{},"cold_archive":{},"collection_ledger":{},"coverage":{},"cycle_health":{},"declared_derivations":{},"declared_extras":{},"ecosystem_conformance":{},"endpoints":{},"full_text_archive":{},"generated_at_utc":{},"license":{},"limits":{},"manifest_changes":{},"metadata_signal_pattern_rates":{},"neutrality":{},"notice":{},"outcome_ledger":{},"overall_verdicts":{},"price_gbp":{},"ranking":{},"reach":{},"registry_archive":{},"reliability_index":{},"retention_days":{},"retention_notes":{},"schema_version":{},"served":{},"shop_panel":{},"sources":{},"status_distribution":{},"targets":{},"third_party_scanners":{},"tiers":{},"unique_datasets":{},"weekly_snapshots":{}},"type":"object"}}},"description":"OK"}},"summary":"Agent Observatory summary","tags":["Agent Observatory"],"x-license":{"covers":"aggregate figures","id":"CC-BY-4.0","url":"https://creativecommons.org/licenses/by/4.0/"}}},"/v1/free/observatory/targets/{target_id}":{"get":{"description":"Observations and change history for one target (facts at time T, not an assessment).","operationId":"getObservatoryTarget","parameters":[{"description":"Observatory target id","in":"path","name":"target_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Target view"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Target not found"}},"summary":"One observed target","tags":["Agent Observatory"]}},"/v1/free/permission":{"get":{"description":"Reads the target site's robots.txt (RFC 9309), Content-Signal and IETF AI-preference lines, RSL licence links…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#checkPermission"},"operationId":"checkPermission","parameters":[{"description":"The public https URL your agent wants to fetch","in":"query","name":"url","required":true,"schema":{"type":"string"}},{"description":"Your agent's user-agent token, e.g. GPTBot (default *)","in":"query","name":"agent","schema":{"type":"string"}}],"responses":{"200":{"description":"The signed answer"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid input"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"summary":"May my agent fetch this?","tags":["Agent Observatory"]}},"/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/preferences/check":{"get":{"description":"MCP tool gaip_check_preferences over HTTP (GET or POST).","operationId":"getV1FreePreferencesCheck","parameters":[{"in":"query","name":"subject","schema":{"type":"string"}},{"in":"query","name":"approach","schema":{"type":"string"}},{"in":"query","name":"channel","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"May my agent approach this person or agent?","tags":["The record"]}},"/v1/free/preferences/screen":{"get":{"description":"MCP tool gaip_screen_caller over HTTP (GET or POST).","operationId":"getV1FreePreferencesScreen","parameters":[{"in":"query","name":"caller","schema":{"type":"string"}},{"in":"query","name":"approach","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Who is this agent approaching mine?","tags":["The record"]}},"/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"]}},"/v1/free/reachability/status":{"post":{"description":"POST /v1/free/reachability/status","operationId":"checkReachabilityRuntimeStatus","responses":{"200":{"description":"Timestamped bounded observation from one vantage point"}},"tags":["Supplier Reliability"]}},"/v1/free/receipts/transparency":{"get":{"description":"Get the current GAIP history Merkle root and anchor status","operationId":"getV1FreeReceiptsTransparency","responses":{"200":{"description":"Transparency snapshot"}},"tags":["Evidence Ledger"]}},"/v1/free/receipts/{receipt_id}":{"get":{"description":"Retrieve a durable execution receipt","operationId":"getV1FreeReceiptsReceiptId","parameters":[{"in":"path","name":"receipt_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"Retained hash-chained observation"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Receipt not found"}},"tags":["Evidence Ledger"]}},"/v1/free/receipts/{receipt_id}/formats/{format}":{"get":{"description":"Return a retained GAIP receipt in another ecosystem's shape, unsigned.","operationId":"exportReceipt","parameters":[{"description":"GAIP receipt id","in":"path","name":"receipt_id","required":true,"schema":{"type":"string"}},{"description":"Target format, for example x402 or in-toto","in":"path","name":"format","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Exported receipt"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Unknown format"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Receipt not found"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"summary":"Export a receipt in another format","tags":["Evidence Ledger"]}},"/v1/free/receipts/{receipt_id}/verify":{"get":{"description":"Verify a retained GAIP receipt, chain and Merkle inclusion proof","operationId":"getV1FreeReceiptsReceiptIdVerify","parameters":[{"in":"path","name":"receipt_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Machine-readable verification report"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Receipt not found"}},"tags":["Evidence Ledger"]}},"/v1/free/record-extract":{"get":{"description":"GAIP's own recorded entries about an agent card, MCP endpoint or shop product page (Observatory change log and…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#getRecordExtract"},"operationId":"getRecordExtract","parameters":[{"description":"Agent card, MCP endpoint or shop product page URL","in":"query","name":"url","required":true,"schema":{"type":"string"}},{"description":"Start of the range (YYYY-MM-DD or RFC 3339)","in":"query","name":"since","schema":{"type":"string"}},{"description":"End of the range (YYYY-MM-DD, inclusive, or RFC 3339)","in":"query","name":"until","schema":{"type":"string"}},{"description":"Most entries (1-200, default 50)","in":"query","name":"limit","schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"description":"The signed extract (state EXTRACT, NO_RECORD or WITHDRAWN)"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid input"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"summary":"An extract of GAIP's record about a URL","tags":["Evidence Ledger"]}},"/v1/free/record/agent-commerce":{"get":{"description":"MCP tool gaip_check_agent_commerce over HTTP.","operationId":"getV1FreeRecordAgentCommerce","parameters":[{"in":"query","name":"host","schema":{"type":"string"}},{"in":"query","name":"on","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"What does this shop's own agent-commerce file say, as indexed?","tags":["The record"]}},"/v1/free/record/credentials":{"get":{"description":"MCP tool gaip_record_credentials over HTTP.","operationId":"getV1FreeRecordCredentials","parameters":[{"in":"query","name":"url","schema":{"type":"string"}},{"in":"query","name":"on","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Which registration numbers did this agent declare, and what did the register say?","tags":["The record"]}},"/v1/free/record/ingredients":{"get":{"description":"MCP tool gaip_record_ingredients over HTTP.","operationId":"getV1FreeRecordIngredients","parameters":[{"in":"query","name":"url","schema":{"type":"string"}},{"in":"query","name":"on","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"What did this agent say it runs on, on a date?","tags":["The record"]}},"/v1/free/record/keys":{"get":{"description":"MCP tool gaip_record_keys over HTTP.","operationId":"getV1FreeRecordKeys","parameters":[{"in":"query","name":"host","schema":{"type":"string"}},{"in":"query","name":"on","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Which keys had this host published on a date?","tags":["The record"]}},"/v1/free/record/names":{"get":{"description":"First-recorded date, registry, host, lookalike names on record, replies. Facts, not intent.","operationId":"getRecordNames","parameters":[{"description":"Registry name or its last segment","in":"query","name":"name","schema":{"type":"string"}},{"description":"Instead of name","in":"query","name":"url","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Names: since when a registry name is on record, and what looks like it","tags":["Agent Observatory"]}},"/v1/free/record/names/objection":{"post":{"description":"{name, owner_challenge}.","operationId":"objectToRecordName","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"A publisher's objection to its name","tags":["Agent Observatory"]}},"/v1/free/record/names/reply":{"post":{"description":"{name, text, owner_challenge?}.","operationId":"replyAboutRecordName","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"The publisher's reply about a name","tags":["Agent Observatory"]}},"/v1/free/record/permissions":{"get":{"description":"MCP tool gaip_record_permissions over HTTP.","operationId":"getV1FreeRecordPermissions","parameters":[{"in":"query","name":"host","schema":{"type":"string"}},{"in":"query","name":"agent","schema":{"type":"string"}},{"in":"query","name":"on","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"What did this site allow an AI agent on a date?","tags":["The record"]}},"/v1/free/record/prices":{"get":{"description":"MCP tool gaip_record_prices over HTTP.","operationId":"getV1FreeRecordPrices","parameters":[{"in":"query","name":"host","schema":{"type":"string"}},{"in":"query","name":"on","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"What did this agent service charge on a date?","tags":["The record"]}},"/v1/free/record/residence":{"get":{"description":"MCP tool gaip_record_residence over HTTP.","operationId":"getV1FreeRecordResidence","parameters":[{"in":"query","name":"url","schema":{"type":"string"}},{"in":"query","name":"on","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Where did this agent's endpoint answer from, on a date?","tags":["The record"]}},"/v1/free/record/tenure":{"get":{"description":"First record date, days recorded and answered, changes, anchors. Not a trust signal.","operationId":"getRecordTenure","parameters":[{"description":"MCP endpoint or agent card URL","in":"query","name":"url","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Tenure: since when GAIP has recorded this endpoint","tags":["Agent Observatory"]}},"/v1/free/representation/check":{"get":{"description":"MCP tool gaip_check_representation over HTTP (GET or POST).","operationId":"getV1FreeRepresentationCheck","parameters":[{"in":"query","name":"organisation","schema":{"type":"string"}},{"in":"query","name":"agent","schema":{"type":"string"}},{"in":"query","name":"on","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Does this organisation say this agent is theirs, as indexed?","tags":["The record"]}},"/v1/free/revocations/check":{"get":{"description":"MCP tool gaip_revoked_since over HTTP (GET or POST).","operationId":"getV1FreeRevocationsCheck","parameters":[{"in":"query","name":"subject","schema":{"type":"string"}},{"in":"query","name":"since","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Has anything I relied on been revoked since?","tags":["The record"]}},"/v1/free/second-look":{"post":{"description":"MCP tool second_look_check over HTTP.","operationId":"postV1FreeSecondLook","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Second Look: check before you buy","tags":["Platform"]}},"/v1/free/software-provenance/inspect":{"post":{"description":"POST /v1/free/software-provenance/inspect","operationId":"inspectSoftwareDependencyProvenance","responses":{"200":{"description":"Artifact provenance evidence, known unknowns and advisory inputs"}},"tags":["Supplier Reliability"]}},"/v1/free/state-of-agents":{"get":{"description":"Monthly aggregate figures on what public MCP servers and A2A agents published; page /state-of-agents.","operationId":"getStateOfAgents","parameters":[{"description":"Calendar month YYYY-MM (default: this month)","in":"query","name":"month","schema":{"type":"string"}}],"responses":{"200":{"description":"The month's report"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Bad month"}},"summary":"State of Agents monthly report (JSON)","tags":["Agent Observatory"]}},"/v1/free/supplier-reliability":{"get":{"description":"Input shape and limits for diagnosing a failed supplier call.","operationId":"describeSupplierReliability","responses":{"200":{"description":"OK"}},"summary":"Supplier reliability: how to call","tags":["Supplier Reliability"]},"post":{"description":"Diagnosis against the error knowledge base next to supplier changes observed around that time (correlation, not…","externalDocs":{"url":"https://www.gaipagents.com/docs/api#diagnoseSupplierReliability"},"operationId":"diagnoseSupplierReliability","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"Diagnosis"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"}},"summary":"Diagnose a failed supplier call","tags":["Supplier Reliability"]}},"/v1/free/watch/check":{"get":{"description":"MCP tool gaip_dependency_check over HTTP (GET or POST).","operationId":"getV1FreeWatchCheck","parameters":[{"in":"query","name":"urls","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"Did a server I depend on change?","tags":["Supplier Reliability"]}},"/v1/free/witness/accept":{"post":{"description":"MCP tool witness_accept_terms over HTTP.","operationId":"postV1FreeWitnessAccept","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Accept registered terms (the other party)","tags":["Delivery Assurance"]}},"/v1/free/witness/deliver":{"post":{"description":"Bounded public delivery evidence; no settlement or seller agreement verification","operationId":"postV1FreeWitnessDeliver","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"Evidence result"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"History unavailable"}},"tags":["Delivery Assurance"]}},"/v1/free/witness/disclosure":{"post":{"description":"MCP tool witness_disclosure over HTTP.","operationId":"postV1FreeWitnessDisclosure","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Record that your agent passed personal data to another agent","tags":["Delivery Assurance"]}},"/v1/free/witness/disclosure-ack":{"post":{"description":"MCP tool witness_disclosure_ack over HTTP.","operationId":"postV1FreeWitnessDisclosureAck","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Acknowledge a disclosure you received","tags":["Delivery Assurance"]}},"/v1/free/witness/dispute-bundle":{"post":{"description":"Bounded public delivery evidence; no settlement or seller agreement verification","operationId":"postV1FreeWitnessDisputeBundle","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"Evidence result"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"History unavailable"}},"tags":["Delivery Assurance"]}},"/v1/free/witness/finding":{"post":{"description":"MCP tool witness_finding over HTTP.","operationId":"postV1FreeWitnessFinding","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Was the agreed rule met? (signed finding)","tags":["Delivery Assurance"]}},"/v1/free/witness/seller-record":{"post":{"description":"Bounded public delivery evidence; no settlement or seller agreement verification","operationId":"postV1FreeWitnessSellerRecord","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"Evidence result"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"History unavailable"}},"tags":["Delivery Assurance"]}},"/v1/free/witness/serve":{"post":{"description":"MCP tool witness_serve over HTTP.","operationId":"postV1FreeWitnessServe","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Serve a notice on an agent endpoint, with a signed record of delivery","tags":["Delivery Assurance"]}},"/v1/free/witness/serve/ack":{"post":{"description":"MCP tool witness_serve_ack over HTTP.","operationId":"postV1FreeWitnessServeAck","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Acknowledge a served notice","tags":["Delivery Assurance"]}},"/v1/free/witness/serve/fetch":{"post":{"description":"MCP tool witness_serve_fetch over HTTP.","operationId":"postV1FreeWitnessServeFetch","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Read a served notice and its delivery record","tags":["Delivery Assurance"]}},"/v1/free/witness/signoff":{"post":{"description":"MCP tool witness_signoff over HTTP.","operationId":"postV1FreeWitnessSignoff","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"OK"}},"summary":"Record a role's decision on a proposal (sign-off)","tags":["Delivery Assurance"]}},"/v1/free/witness/terms":{"post":{"description":"Bounded public delivery evidence; no settlement or seller agreement verification","operationId":"postV1FreeWitnessTerms","requestBody":{"$ref":"#/components/requestBodies/JsonObject"},"responses":{"200":{"description":"Evidence result"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"History unavailable"}},"tags":["Delivery Assurance"]}},"/v1/statements/{YYYY-MM}":{"get":{"description":"MCP tool gaip_statement over HTTP.","operationId":"getV1StatementsYYYYMM","parameters":[{"description":"YYYY-MM","in":"path","name":"YYYY-MM","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}},"summary":"What did my agents do this month?","tags":["The record"]}}},"security":[],"servers":[{"url":"https://www.gaipagents.com"}],"tags":[{"description":"Conformance of A2A, MCP and OpenAPI declarations and the manifest change log.","name":"Agent Observatory"},{"description":"Supplier snapshots, change watch and failed-call diagnosis.","name":"Supplier Reliability"},{"description":"Pre-delegation checks, delivery terms, witnessing and citation checks.","name":"Delivery Assurance"},{"description":"Receipts, verification, evidence packs, incident bundles and outcomes.","name":"Evidence Ledger"},{"description":"Agent cards, MCP Server Cards, catalogs, guides and product documents.","name":"Discovery"},{"description":"Status, history and other platform resources.","name":"Platform"},{"description":"Answers read from GAIP's dated record of what was published, as indexed, each with a receipt.","name":"The record"}],"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"]}}