{ "description": "Checks A2A, MCP and OpenAPI declarations and task-specific handshakes before delegated work, and keeps the Agent Observatory: a dated record of what agents and MCP servers published. It also compares supplier snapshots, watches suppliers for change and diagnoses failed calls (Supplier Watch and Integration Repair are part of it since 1 Oct 2026), and answers \"may my agent fetch this?\" from a site's robots.txt and AI-permission files. Part of GAIP Check and GAIP Watch \u00b7 Diagnose (lead agent).", "endpoint": "https://www.gaipagents.com/mcp/agents/integration-protocol", "name": "io.github.tjcgraham-rgb/gaip-integration-protocol", "privacyPolicy": "https://www.gaipagents.com/privacy", "product": { "foldedInto": null, "kind": "PRODUCT", "listed": true, "productId": "developer-checks", "productName": "Check and GAIP Watch \u00b7 Diagnose", "role": "LEAD", "roleLabel": "lead agent", "status": "PUBLIC_FREE", "url": "https://www.gaipagents.com/v1/free/products#developer-checks" }, "protocolVersion": "2025-06-18", "publication": { "acceptanceNotImplied": true, "descriptorLive": true, "officialMcpRegistry": "PENDING_INDIVIDUAL_REGISTRY_ACCEPTANCE" }, "registryVersion": "1.5.0", "repository": { "source": "github", "url": "https://github.com/tjcgraham-rgb/-gaip-agent-to-art-prototype" }, "schema_version": "gaip.agent-mcp-descriptor.v1", "serverCard": "https://www.gaipagents.com/mcp/agents/integration-protocol/server-card", "termsOfService": "https://www.gaipagents.com/terms", "title": "GAIP Integration & Protocol Agent", "tools": [ { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true }, "description": "Use this when installing an A2A, MCP or OpenAPI agent. Supply a public `url` (GAIP fetches, validates and reach-tests it) or its public metadata to check its declared interface. Set mode VERIFY_BEFORE_CALL to inspect task-specific counterparty evidence before delegation.", "inputSchema": { "additionalProperties": false, "properties": { "data_classification": { "enum": [ "PUBLIC", "NON_PERSONAL_PUBLIC" ], "type": "string" }, "declared_identity": { "type": "string" }, "expected_endpoint": { "description": "Optional: the endpoint you expect; a different primary endpoint is reported as ENDPOINT_DRIFT.", "format": "uri", "type": "string" }, "intended_task": { "type": "string" }, "metadata": { "type": "object" }, "mode": { "enum": [ "CONFORMANCE", "VERIFY_BEFORE_CALL" ], "type": "string" }, "protocol": { "enum": [ "A2A", "MCP", "OPENAPI" ], "type": "string" }, "source_url": { "description": "Optional: where `metadata` was published, used only to resolve relative endpoints. Never fetched.", "format": "uri", "maxLength": 2048, "type": "string" }, "target": { "oneOf": [ { "format": "uri", "type": "string" }, { "type": "object" } ] }, "url": { "description": "Public https link to an agent, its A2A agent card, MCP server description or OpenAPI document. GAIP fetches, validates and reach-tests it. Use instead of metadata.", "format": "uri", "maxLength": 2048, "type": "string" } }, "type": "object" }, "name": "check_agent_conformance", "title": "Check an agent interface" }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false }, "description": "Register a free watch (max 3, every 24h+) on an agent's readiness, a published card, or witness delivery terms; optional signed webhook on change.", "inputSchema": { "additionalProperties": false, "properties": { "continuity_handle": { "description": "The continuity_handle from an earlier GAIP result; proves you own these watches.", "properties": { "continuity_id": { "type": "string" }, "token": { "type": "string" } }, "required": [ "continuity_id", "token" ], "type": "object" }, "data_classification": { "default": "PUBLIC", "enum": [ "PUBLIC", "NON_PERSONAL_PUBLIC" ], "type": "string" }, "interval_hours": { "default": 24, "description": "Hours between checks: 24 minimum on the free tier; 1 for DELIVERY_SLA.", "maximum": 168, "minimum": 1, "type": "integer" }, "kind": { "enum": [ "AGENT_READINESS", "DELIVERY_TERMS", "SUPPLIER_CARD", "DELIVERY_SLA" ], "type": "string" }, "sla": { "description": "DELIVERY_SLA only: service-level terms checked on every observation, any of min_uptime_pct, max_latency_ms, required_fields (JSON key paths), freshness_field + max_age_seconds; optional uptime_window_hours, min_observations. Results go only to you.", "type": "object" }, "target_url": { "description": "Public https URL (AGENT_READINESS, SUPPLIER_CARD). No query string.", "format": "uri", "maxLength": 2048, "type": "string" }, "terms_id": { "description": "DELIVERY_TERMS or DELIVERY_SLA: terms_id from witness_register_terms.", "type": "string" }, "webhook_url": { "description": "Optional: your own public https endpoint for signed change events.", "format": "uri", "maxLength": 2048, "type": "string" } }, "required": [ "continuity_handle", "kind" ], "type": "object" }, "name": "gaip_watch_register", "title": "Watch an agent, card or delivery" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "List your watches with last verdict, last check and next due time.", "inputSchema": { "additionalProperties": false, "properties": { "continuity_handle": { "description": "The continuity_handle from an earlier GAIP result; proves you own these watches.", "properties": { "continuity_id": { "type": "string" }, "token": { "type": "string" } }, "required": [ "continuity_id", "token" ], "type": "object" } }, "required": [ "continuity_handle" ], "type": "object" }, "name": "gaip_watch_list", "title": "List my watches" }, { "annotations": { "destructiveHint": true, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false }, "description": "Stop one of your watches and delete its events.", "inputSchema": { "additionalProperties": false, "properties": { "continuity_handle": { "description": "The continuity_handle from an earlier GAIP result; proves you own these watches.", "properties": { "continuity_id": { "type": "string" }, "token": { "type": "string" } }, "required": [ "continuity_id", "token" ], "type": "object" }, "watch_id": { "type": "string" } }, "required": [ "continuity_handle", "watch_id" ], "type": "object" }, "name": "gaip_watch_remove", "title": "Remove a watch" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Read recent change events (with receipts and webhook delivery status) for your watches.", "inputSchema": { "additionalProperties": false, "properties": { "continuity_handle": { "description": "The continuity_handle from an earlier GAIP result; proves you own these watches.", "properties": { "continuity_id": { "type": "string" }, "token": { "type": "string" } }, "required": [ "continuity_id", "token" ], "type": "object" }, "limit": { "maximum": 50, "minimum": 1, "type": "integer" }, "watch_id": { "type": "string" } }, "required": [ "continuity_handle" ], "type": "object" }, "name": "gaip_watch_events", "title": "Read watch change events" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Look up dated public facts GAIP's Agent Observatory has observed about an MCP server or A2A agent: status history, manifest hash, bounded manifest snapshot, conformance codes, metadata-signal rules (pattern present / not present) and the receipted manifest change log. Pass target_id, or a url or name to find target ids. Facts observed at a time, not an assessment.", "inputSchema": { "additionalProperties": false, "properties": { "name": { "maxLength": 200, "type": "string" }, "target_id": { "pattern": "^obs_[0-9a-f]{24}$", "type": "string" }, "url": { "maxLength": 2048, "type": "string" } }, "type": "object" }, "name": "gaip_observatory_lookup" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Read the Observatory's Manifest Transparency Log: hash-chained, receipted entries recording that a published agent/MCP manifest changed (before/after hash, neutral change facts, time). Filter by target_id and since (RFC 3339); at most 100 entries.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "maximum": 100, "minimum": 1, "type": "integer" }, "since": { "format": "date-time", "type": "string" }, "target_id": { "pattern": "^obs_[0-9a-f]{24}$", "type": "string" } }, "type": "object" }, "name": "gaip_manifest_changes" }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": false }, "description": "Save a dated record of what a public MCP server or A2A agent card declares now. GAIP reads the card, or sends the MCP discovery handshake (initialize, tools/list; never tools/call), keeps the agent in its Agent Observatory and re-reads it about daily. Returns the record id, time and SHA-256 hashes of what was declared. Facts at a time, not an assessment.", "inputSchema": { "additionalProperties": false, "properties": { "protocol": { "description": "Optional; inferred from the URL (a /.well-known/agent-card.json path is A2A).", "enum": [ "MCP", "A2A" ], "type": "string" }, "url": { "description": "Public https URL of the MCP endpoint or the A2A agent card.", "maxLength": 2048, "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "gaip_observatory_capture", "title": "Save an agent's declarations now" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Before you connect: has this MCP server's tool list changed since GAIP began recording it, or since your approval date? Pass its url (or target_id), optionally since and your tools/list `tools` or a digest. Returns dates, change classes and stored hashes, and whether yours matches the latest GAIP observed. Facts, not a verdict.", "inputSchema": { "additionalProperties": false, "properties": { "since": { "description": "Your approval date (RFC 3339 or YYYY-MM-DD): changes recorded since then.", "maxLength": 40, "type": "string" }, "target_id": { "pattern": "^obs_[0-9a-f]{24}$", "type": "string" }, "tool_digests": { "description": "Per-tool digests in the DRAFT MCP SEP-2636 form (may change).", "items": { "pattern": "^sha256:[0-9a-f]{64}$", "type": "string" }, "maxItems": 2000, "type": "array" }, "tools": { "description": "The `tools` array from your own tools/list; GAIP hashes it and compares.", "items": { "type": "object" }, "maxItems": 300, "type": "array" }, "tools_digest": { "description": "A SHA-256 (64 hex) of the tool list you approved, as GAIP reported it.", "maxLength": 71, "type": "string" }, "url": { "description": "The MCP endpoint (or A2A agent card) URL, exactly as you connect to it.", "maxLength": 2048, "type": "string" } }, "type": "object" }, "name": "gaip_tools_changed_since", "title": "Has this MCP server changed?" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true }, "description": "May my agent fetch this URL? Reads the site's robots.txt (RFC 9309), Content-Signal and AI-preference lines, RSL licence links, tdmrep.json and llms.txt once, and answers ALLOWED, DISALLOWED, NO_RULE or UNKNOWN for your agent's user-agent token, with the matching rule quoted, the time and an Ed25519 signature. Not legal advice or a licence.", "inputSchema": { "additionalProperties": false, "examples": [ { "agent": "GPTBot", "url": "https://www.gaipagents.com/test-range" } ], "properties": { "agent": { "description": "Your agent's user-agent token as robots.txt names it, e.g. GPTBot or ClaudeBot (a full User-Agent string also works). Default * (any crawler without its own rules).", "maxLength": 300, "type": "string" }, "url": { "description": "The public https URL your agent wants to fetch.", "format": "uri", "maxLength": 2048, "type": "string" }, "user_agent": { "description": "Alternative to agent: your agent's full User-Agent string.", "maxLength": 300, "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "gaip_check_permission", "title": "May my agent fetch this?" }, { "annotations": { "destructiveHint": false, "openWorldHint": false, "readOnlyHint": false }, "description": "Compare two supplied public snapshots and return material changes with a retained receipt. The separate scheduled GAIP cohort watch is published at /v1/free/commercial/watch-status.", "inputSchema": { "additionalProperties": true, "properties": { "continuity_handle": { "additionalProperties": false, "properties": { "continuity_id": { "type": "string" }, "token": { "type": "string" } }, "required": [ "continuity_id", "token" ], "type": "object" }, "counterparty_id": { "type": "string" }, "current": { "type": "object" }, "data_classification": { "enum": [ "PUBLIC", "NON_PERSONAL_PUBLIC" ], "type": "string" }, "episode_id": { "type": "string" }, "independent_operator_id": { "type": "string" }, "prior": { "type": "object" }, "protocol": { "enum": [ "A2A", "MCP", "OPENAPI" ], "type": "string" }, "synthetic": { "type": "boolean" }, "task_class": { "type": "string" } }, "required": [ "data_classification", "counterparty_id", "task_class", "protocol", "prior", "current" ], "type": "object" }, "name": "gaip_compare_supplier_snapshots", "title": "Compare supplier snapshots" }, { "annotations": { "destructiveHint": false, "openWorldHint": false, "readOnlyHint": false }, "description": "Classify a supplied public handshake or task failure and return a bounded repair plan and retained receipt. No patch or replay of another operator's system.", "inputSchema": { "additionalProperties": true, "properties": { "continuity_handle": { "additionalProperties": false, "properties": { "continuity_id": { "type": "string" }, "token": { "type": "string" } }, "required": [ "continuity_id", "token" ], "type": "object" }, "counterparty_id": { "type": "string" }, "data_classification": { "enum": [ "PUBLIC", "NON_PERSONAL_PUBLIC" ], "type": "string" }, "episode_id": { "type": "string" }, "failure": { "description": "The failure: {code, detail?, http_status?}, e.g. {\"code\": 429, \"detail\": \"Too Many Requests; Retry-After: 20\"}.", "type": "object" }, "independent_operator_id": { "type": "string" }, "protocol": { "enum": [ "A2A", "MCP", "OPENAPI" ], "type": "string" }, "synthetic": { "type": "boolean" }, "task_class": { "type": "string" } }, "required": [ "data_classification", "counterparty_id", "task_class", "protocol", "failure" ], "type": "object" }, "name": "gaip_diagnose_integration_failure", "title": "Diagnose integration failure" }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": true }, "description": "An agent or API you depend on started failing? Pass the `failure` ({code, detail}) as for gaip_diagnose_integration_failure plus the supplier's public `supplier_url` and optionally `failure_started_at`. Returns GAIP's repair diagnosis plus the supplier changes GAIP observed around that time (card and readiness watch events, observatory change log), each with a receipt and labelled as correlated in time, not causation. Recommends next steps and offers a watch. Does not fetch the supplier.", "inputSchema": { "additionalProperties": true, "properties": { "card": { "description": "Optional supplier card / server description you integrated against.", "type": "object" }, "counterparty_id": { "type": "string" }, "data_classification": { "default": "PUBLIC", "enum": [ "PUBLIC", "NON_PERSONAL_PUBLIC" ], "type": "string" }, "failure": { "description": "{code, detail?, http_status?} as for gaip_diagnose_integration_failure.", "type": "object" }, "failure_started_at": { "format": "date-time", "type": "string" }, "failures": { "maxItems": 100, "minItems": 1, "type": "array" }, "lookback_days": { "default": 14, "maximum": 30, "minimum": 1, "type": "integer" }, "protocol": { "description": "Omit to infer it from card, transport or the supplier URL path (else UNKNOWN).", "enum": [ "A2A", "MCP", "OPENAPI", "UNKNOWN" ], "type": "string" }, "supplier_url": { "format": "uri", "maxLength": 2048, "type": "string" }, "task_class": { "type": "string" }, "transport": { "description": "Optional transport you used (e.g. streamable-http, sse, GRPC).", "type": "string" } }, "required": [ "supplier_url" ], "type": "object" }, "name": "gaip_supplier_reliability", "title": "Diagnose a supplier failure with recent changes" } ], "transport": "streamable-http", "version": "1.0.0" }