{ "agent_card": { "capabilities": { "extendedAgentCard": false, "pushNotifications": false, "stateTransitionHistory": false, "streaming": false }, "defaultInputModes": [ "application/json" ], "defaultOutputModes": [ "application/json" ], "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).", "documentationUrl": "https://www.gaipagents.com/agents/integration-protocol", "gaip": { "agentId": "integration-protocol", "authority": "PUBLIC_NON_PERSONAL_ZERO_PRICE_BOUNDED_NO_SPEND_NO_PAYMENT_NO_CONTRACT", "automaticEvidenceCredit": false, "discovery": { "aiCatalog": "https://www.gaipagents.com/.well-known/ai-catalog.json", "listingKit": "https://www.gaipagents.com/v1/free/discovery/listing-kit", "llms": "https://www.gaipagents.com/llms.txt", "llmsFull": "https://www.gaipagents.com/llms-full.txt", "mcpServerCard": "https://www.gaipagents.com/mcp/server-card", "openapi": "https://www.gaipagents.com/openapi.json", "products": "https://www.gaipagents.com/v1/free/products" }, "distributionBundle": "https://www.gaipagents.com/v1/distribution/agents/integration-protocol", "durableReceiptRequiredBeforeSuccess": true, "howToCall": { "a2a": "POST JSON-RPC message/send (A2A 0.3) or SendMessage (A2A 1.0) to https://www.gaipagents.com/a2a/integration-protocol. Put the tool name (underscores, e.g. \"check_agent_conformance\") in message.metadata.gaip_tool and the input object in one data part (0.3: {\"kind\": \"data\", \"data\": {...}}; 1.0: {\"data\": {...}} with role ROLE_USER). Without gaip_tool the data part must match one of this agent's tools. Text parts are never converted into a task.", "allowedTools": [ "check_agent_conformance", "gaip_watch_register", "gaip_watch_list", "gaip_watch_remove", "gaip_watch_events", "gaip_observatory_lookup", "gaip_manifest_changes", "gaip_observatory_capture", "gaip_tools_changed_since", "gaip_check_permission", "gaip_compare_supplier_snapshots", "gaip_diagnose_integration_failure", "gaip_supplier_reliability" ], "example": { "id": 1, "jsonrpc": "2.0", "method": "message/send", "params": { "message": { "kind": "message", "messageId": "example-1", "metadata": { "gaip_tool": "check_agent_conformance" }, "parts": [ { "data": { "metadata": { "name": "GAIP Broker", "protocolVersion": "2025-06-18", "tools": [], "url": "https://www.gaipagents.com/mcp" } }, "kind": "data" } ], "role": "user" } } }, "mcp": "POST tools/call to https://www.gaipagents.com/mcp/agents/integration-protocol", "primaryTool": "check_agent_conformance" }, "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" }, "mcpServerCard": "https://www.gaipagents.com/mcp/agents/integration-protocol/server-card", "mcpUrl": "https://www.gaipagents.com/mcp/agents/integration-protocol", "priceGbp": 0, "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" } }, "iconUrl": "https://www.gaipagents.com/assets/agents/integration-protocol.svg", "name": "GAIP Integration & Protocol Agent", "preferredTransport": "JSONRPC", "protocolVersion": "1.0", "provider": { "organization": "GAIP", "url": "https://www.gaipagents.com" }, "securityRequirements": [], "securitySchemes": {}, "skills": [ { "description": "Use this when asked to check an AI agent or MCP server: does it work, is it reachable, is its card valid (\"check this agent\", \"is this MCP server up?\"). Pass just its `url`. Returns READY / FIXES_NEEDED / NO_AGENT_CARD / UNREACHABLE with fixes and a receipt. Input: required none; optional data_classification, declared_identity, expected_endpoint, intended_task, metadata, mode, protocol, source_url, target, url. A2A: send message/send with metadata.gaip_tool=\"check_agent_conformance\" and one data part holding the input object; MCP: tools/call name \"check_agent_conformance\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"metadata\": {\"name\": \"GAIP Broker\", \"protocolVersion\": \"2025-06-18\", \"tools\": [], \"url\": \"https://www.gaipagents.com/mcp\"}}" ], "id": "check-agent-conformance", "inputModes": [ "application/json" ], "name": "Check Agent Conformance", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this when asked to keep an eye on an agent or MCP server (\"tell me if it changes or goes down\"). Pass the `continuity_handle` from any GAIP result, `kind` and `target_url`. GAIP re-checks every 24 hours (3 free watches), receipts each change and can call your webhook. Input: required continuity_handle, kind; optional data_classification, interval_hours, sla, target_url, terms_id, webhook_url. A2A: send message/send with metadata.gaip_tool=\"gaip_watch_register\" and one data part holding the input object; MCP: tools/call name \"gaip_watch_register\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"chain\": [{\"agent_id\": \"integration-protocol\", \"arguments\": {\"counterparty_id\": \"example-weather-agent\", \"current\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"security\": [{\"bearer\": []}], \"securitySchemes\": {\"bearer\": {\"scheme\": \"bearer\", \"type\": \"http\"}}, \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}], \"url\": \"https://weather.example.com/v2/a2a\", \"version\": \"2.0.0\"}, \"prior\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}, {\"id\": \"alerts\", \"name\": \"Severe weather alerts\"}], \"url\": \"https://weather.example.com/a2a\", \"version\": \"1.4.0\"}}, \"keep_from_result\": \"continuity_handle\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 1, \"tool\": \"gaip_compare_supplier_snapshots\"}, {\"agent_id\": \"integration-protocol\", \"arguments\": {\"continuity_handle\": {\"continuity_id\": \"\", \"token\": \"\"}, \"interval_hours\": 24, \"kind\": \"AGENT_READINESS\", \"target_url\": \"https://weather.example.com/.well-known/agent-card.json\"}, \"keep_from_result\": \"result\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 2, \"tool\": \"gaip_watch_register\"}], \"note\": \"Run the steps in order; replace each angle-bracket value with the named field from the result of the named earlier step.\"}" ], "id": "gaip-watch-register", "inputModes": [ "application/json" ], "name": "Gaip Watch Register", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this when asked which agents or services you are watching. Pass your `continuity_handle`. Returns each watch's kind, target, last verdict, last and next check and webhook endpoint (never the secret). Input: required continuity_handle. A2A: send message/send with metadata.gaip_tool=\"gaip_watch_list\" and one data part holding the input object; MCP: tools/call name \"gaip_watch_list\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"chain\": [{\"agent_id\": \"integration-protocol\", \"arguments\": {\"counterparty_id\": \"example-weather-agent\", \"current\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"security\": [{\"bearer\": []}], \"securitySchemes\": {\"bearer\": {\"scheme\": \"bearer\", \"type\": \"http\"}}, \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}], \"url\": \"https://weather.example.com/v2/a2a\", \"version\": \"2.0.0\"}, \"prior\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}, {\"id\": \"alerts\", \"name\": \"Severe weather alerts\"}], \"url\": \"https://weather.example.com/a2a\", \"version\": \"1.4.0\"}}, \"keep_from_result\": \"continuity_handle\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 1, \"tool\": \"gaip_compare_supplier_snapshots\"}, {\"agent_id\": \"integration-protocol\", \"arguments\": {\"continuity_handle\": {\"continuity_id\": \"\", \"token\": \"\"}, \"interval_hours\": 24, \"kind\": \"AGENT_READINESS\", \"target_url\": \"https://weather.example.com/.well-known/agent-card.json\"}, \"keep_from_result\": \"watch.watch_id\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 2, \"tool\": \"gaip_watch_register\"}, {\"agent_id\": \"integration-protocol\", \"arguments\": {\"continuity_handle\": {\"continuity_id\": \"\", \"token\": \"\"}}, \"keep_from_result\": \"result\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 3, \"tool\": \"gaip_watch_list\"}], \"note\": \"Run the steps in order; replace each angle-bracket value with the named field from the result of the named earlier step.\"}" ], "id": "gaip-watch-list", "inputModes": [ "application/json" ], "name": "Gaip Watch List", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this when asked to stop watching an agent or service. Pass your `continuity_handle` and the `watch_id`. Its stored events are deleted; retained receipts stay verifiable. Input: required continuity_handle, watch_id. A2A: send message/send with metadata.gaip_tool=\"gaip_watch_remove\" and one data part holding the input object; MCP: tools/call name \"gaip_watch_remove\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"chain\": [{\"agent_id\": \"integration-protocol\", \"arguments\": {\"counterparty_id\": \"example-weather-agent\", \"current\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"security\": [{\"bearer\": []}], \"securitySchemes\": {\"bearer\": {\"scheme\": \"bearer\", \"type\": \"http\"}}, \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}], \"url\": \"https://weather.example.com/v2/a2a\", \"version\": \"2.0.0\"}, \"prior\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}, {\"id\": \"alerts\", \"name\": \"Severe weather alerts\"}], \"url\": \"https://weather.example.com/a2a\", \"version\": \"1.4.0\"}}, \"keep_from_result\": \"continuity_handle\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 1, \"tool\": \"gaip_compare_supplier_snapshots\"}, {\"agent_id\": \"integration-protocol\", \"arguments\": {\"continuity_handle\": {\"continuity_id\": \"\", \"token\": \"\"}, \"interval_hours\": 24, \"kind\": \"AGENT_READINESS\", \"target_url\": \"https://weather.example.com/.well-known/agent-card.json\"}, \"keep_from_result\": \"watch.watch_id\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 2, \"tool\": \"gaip_watch_register\"}, {\"agent_id\": \"integration-protocol\", \"arguments\": {\"continuity_handle\": {\"continuity_id\": \"\", \"token\": \"\"}, \"watch_id\": \"\"}, \"keep_from_result\": \"result\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 3, \"tool\": \"gaip_watch_remove\"}], \"note\": \"Run the steps in order; replace each angle-bracket value with the named field from the result of the named earlier step.\"}" ], "id": "gaip-watch-remove", "inputModes": [ "application/json" ], "name": "Gaip Watch Remove", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this when asked what changed on a watched agent or service. Pass your `continuity_handle` and optionally a `watch_id`. Returns recent change events: verdict before and after, a change summary, the receipt and webhook delivery status. Input: required continuity_handle; optional limit, watch_id. A2A: send message/send with metadata.gaip_tool=\"gaip_watch_events\" and one data part holding the input object; MCP: tools/call name \"gaip_watch_events\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"chain\": [{\"agent_id\": \"integration-protocol\", \"arguments\": {\"counterparty_id\": \"example-weather-agent\", \"current\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"security\": [{\"bearer\": []}], \"securitySchemes\": {\"bearer\": {\"scheme\": \"bearer\", \"type\": \"http\"}}, \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}], \"url\": \"https://weather.example.com/v2/a2a\", \"version\": \"2.0.0\"}, \"prior\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}, {\"id\": \"alerts\", \"name\": \"Severe weather alerts\"}], \"url\": \"https://weather.example.com/a2a\", \"version\": \"1.4.0\"}}, \"keep_from_result\": \"continuity_handle\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 1, \"tool\": \"gaip_compare_supplier_snapshots\"}, {\"agent_id\": \"integration-protocol\", \"arguments\": {\"continuity_handle\": {\"continuity_id\": \"\", \"token\": \"\"}, \"interval_hours\": 24, \"kind\": \"AGENT_READINESS\", \"target_url\": \"https://weather.example.com/.well-known/agent-card.json\"}, \"keep_from_result\": \"watch.watch_id\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 2, \"tool\": \"gaip_watch_register\"}, {\"agent_id\": \"integration-protocol\", \"arguments\": {\"continuity_handle\": {\"continuity_id\": \"\", \"token\": \"\"}, \"limit\": 10, \"watch_id\": \"\"}, \"keep_from_result\": \"result\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 3, \"tool\": \"gaip_watch_events\"}], \"note\": \"Run the steps in order; replace each angle-bracket value with the named field from the result of the named earlier step.\"}" ], "id": "gaip-watch-events", "inputModes": [ "application/json" ], "name": "Gaip Watch Events", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this when asked about an MCP server's or agent's history (\"has this server changed?\", \"was it up last week?\"). Pass its `url` or `name`. Returns dated facts the Agent Observatory observed: status history, manifest hash, conformance codes, change log. Not an assessment. Input: required none; optional name, target_id, url. A2A: send message/send with metadata.gaip_tool=\"gaip_observatory_lookup\" and one data part holding the input object; MCP: tools/call name \"gaip_observatory_lookup\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"url\": \"https://huggingface.co/mcp\"}" ], "id": "gaip-observatory-lookup", "inputModes": [ "application/json" ], "name": "Gaip Observatory Lookup", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this when asked which MCP servers or agents changed recently (\"what changed this week?\"). Optional `since` (RFC 3339), `target_id`, `limit` (max 100). Returns the Observatory's hash-chained log of manifest changes: before/after hashes, neutral facts, receipts. Input: required none; optional limit, since, target_id. A2A: send message/send with metadata.gaip_tool=\"gaip_manifest_changes\" and one data part holding the input object; MCP: tools/call name \"gaip_manifest_changes\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"limit\": 20, \"since\": \"2026-09-01T00:00:00Z\"}" ], "id": "gaip-manifest-changes", "inputModes": [ "application/json" ], "name": "Gaip Manifest Changes", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this to save a dated record of what a public MCP server or A2A agent card declares now. Pass its `url`. GAIP reads it once (robots.txt respected, never tools/call), re-reads it daily and returns the capture id, time and SHA-256 hashes. Not an assessment. Input: required url; optional protocol. A2A: send message/send with metadata.gaip_tool=\"gaip_observatory_capture\" and one data part holding the input object; MCP: tools/call name \"gaip_observatory_capture\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"chain\": [{\"agent_id\": \"integration-protocol\", \"arguments\": {\"url\": \"https://huggingface.co/mcp\"}, \"keep_from_result\": \"matches\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 1, \"tool\": \"gaip_observatory_lookup\"}, {\"agent_id\": \"integration-protocol\", \"arguments\": {\"url\": \"\"}, \"keep_from_result\": \"result\", \"mcp_endpoint\": \"https://www.gaipagents.com/mcp/agents/integration-protocol\", \"step\": 2, \"tool\": \"gaip_observatory_capture\"}], \"note\": \"Run the steps in order; replace each angle-bracket value with the named field from the result of the named earlier step.\"}" ], "id": "gaip-observatory-capture", "inputModes": [ "application/json" ], "name": "Gaip Observatory Capture", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this before connecting to an MCP server: did its tools change since your `since` date? Pass its `url`, optionally your tools/list `tools` or a digest. Returns dates, change classes, stored hashes and whether yours match the latest GAIP observed. Facts, not a verdict. Input: required none; optional since, target_id, tool_digests, tools, tools_digest, url. A2A: send message/send with metadata.gaip_tool=\"gaip_tools_changed_since\" and one data part holding the input object; MCP: tools/call name \"gaip_tools_changed_since\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"since\": \"2026-09-01\", \"url\": \"https://huggingface.co/mcp\"}" ], "id": "gaip-tools-changed-since", "inputModes": [ "application/json" ], "name": "Gaip Tools Changed Since", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this before your agent fetches a page (\"may my agent fetch this?\"). Pass the `url` and your `agent` token. Reads robots.txt (RFC 9309), AI-preference lines, RSL, tdmrep.json and llms.txt; returns ALLOWED, DISALLOWED, NO_RULE or UNKNOWN, the rule quoted, the time and a signature. Input: required url; optional agent, user_agent. A2A: send message/send with metadata.gaip_tool=\"gaip_check_permission\" and one data part holding the input object; MCP: tools/call name \"gaip_check_permission\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"agent\": \"GPTBot\", \"url\": \"https://www.gaipagents.com/test-range\"}" ], "id": "gaip-check-permission", "inputModes": [ "application/json" ], "name": "Gaip Check Permission", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this when asked what changed between two versions of an agent card, MCP server description or OpenAPI document (\"did this API break?\"). Pass `prior` and `current`. Returns each change as BREAKING / NON_BREAKING / INFO with migration notes and a receipt. Input: required prior, current; optional continuity_handle, counterparty_id, data_classification, episode_id, independent_operator_id, protocol, synthetic, task_class. A2A: send message/send with metadata.gaip_tool=\"gaip_compare_supplier_snapshots\" and one data part holding the input object; MCP: tools/call name \"gaip_compare_supplier_snapshots\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"counterparty_id\": \"example-weather-agent\", \"current\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"security\": [{\"bearer\": []}], \"securitySchemes\": {\"bearer\": {\"scheme\": \"bearer\", \"type\": \"http\"}}, \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}], \"url\": \"https://weather.example.com/v2/a2a\", \"version\": \"2.0.0\"}, \"prior\": {\"capabilities\": {\"streaming\": true}, \"name\": \"Weather Agent\", \"protocolVersion\": \"0.3.0\", \"skills\": [{\"id\": \"forecast\", \"name\": \"Forecast\"}, {\"id\": \"alerts\", \"name\": \"Severe weather alerts\"}], \"url\": \"https://weather.example.com/a2a\", \"version\": \"1.4.0\"}}" ], "id": "gaip-compare-supplier-snapshots", "inputModes": [ "application/json" ], "name": "Gaip Compare Supplier Snapshots", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this when an agent, MCP or API call failed (\"why did my call fail?\", \"what does this 429 mean?\"). Pass the `failure` ({code, detail}) or the raw error text. Returns the likely cause, when and how to retry, fix steps and a receipt. GAIP touches no other system. Input: required failure; optional continuity_handle, counterparty_id, data_classification, episode_id, independent_operator_id, protocol, synthetic, task_class. A2A: send message/send with metadata.gaip_tool=\"gaip_diagnose_integration_failure\" and one data part holding the input object; MCP: tools/call name \"gaip_diagnose_integration_failure\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"counterparty_id\": \"example-weather-agent\", \"failure\": {\"code\": 429, \"detail\": \"HTTP 429 Too Many Requests; Retry-After: 20\"}}" ], "id": "gaip-diagnose-integration-failure", "inputModes": [ "application/json" ], "name": "Gaip Diagnose Integration Failure", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, { "description": "Use this when a supplier agent or API you depend on started failing (\"did something change on their side?\"). Pass its `supplier_url` and the `failure`. Returns the diagnosis plus changes GAIP observed around then (correlated in time, not causation), with receipts. Input: required supplier_url; optional card, counterparty_id, data_classification, failure, failure_started_at, failures, lookback_days, protocol, task_class, transport. A2A: send message/send with metadata.gaip_tool=\"gaip_supplier_reliability\" and one data part holding the input object; MCP: tools/call name \"gaip_supplier_reliability\" at https://www.gaipagents.com/mcp/agents/integration-protocol.", "examples": [ "{\"failure\": {\"code\": 404, \"detail\": \"Not Found\"}, \"failure_started_at\": \"2026-09-27T12:00:00Z\", \"supplier_url\": \"https://weather.example.com/.well-known/agent-card.json\"}" ], "id": "gaip-supplier-reliability", "inputModes": [ "application/json" ], "name": "Gaip Supplier Reliability", "outputModes": [ "application/json" ], "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] } ], "supportedInterfaces": [ { "protocolBinding": "JSONRPC", "protocolVersion": "1.0", "url": "https://www.gaipagents.com/a2a/integration-protocol" } ], "url": "https://www.gaipagents.com/a2a/integration-protocol", "version": "1.0.0" }, "agent_id": "integration-protocol", "agentverse": { "a2a_agent_card": "https://www.gaipagents.com/agents/integration-protocol/.well-known/agent-card.json", "a2a_endpoint": "https://www.gaipagents.com/a2a/integration-protocol", "agent_id": "integration-protocol", "chat_protocol_required": true, "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).", "name": "GAIP Integration & Protocol Agent", "price_gbp": 0, "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" }, "proof_boundary": "This public profile is ready for registration; Agentverse discovery is not claimed until a registry receipt exists.", "protocols": [ "A2A", "MCP", "HTTPS" ], "public": true, "publication_approval": "FOUNDER_GRANTED_2026-09-24", "registration_state": "PENDING_AGENTVERSE_IDENTITY_LINK", "schema_version": "gaip.agentverse.profile.v2", "tags": [ "integration", "schema", "A2A", "MCP", "OpenAPI" ] }, "coo_reporting": "ENABLED", "engineering_reliability_monitoring": "ENABLED", "erc8004": { "active": true, "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).", "gaip": { "agent_id": "integration-protocol", "mainnet_claimed": false, "onchain_state": "PENDING_WALLET_SIGNED_REGISTRATION", "spend_authorized": false, "target_network": "BASE_SEPOLIA" }, "image": "https://www.gaipagents.com/assets/agents/integration-protocol.svg", "name": "GAIP Integration & Protocol Agent", "registrations": [], "services": [ { "endpoint": "https://www.gaipagents.com/agents/integration-protocol", "name": "web" }, { "endpoint": "https://www.gaipagents.com/agents/integration-protocol/.well-known/agent-card.json", "name": "A2A", "version": "1.0" }, { "endpoint": "https://www.gaipagents.com/mcp/agents/integration-protocol", "name": "MCP", "version": "2025-06-18" }, { "endpoint": "https://www.gaipagents.com/v1/distribution/oasf/integration-protocol.json", "name": "OASF", "version": "1.0.0" } ], "supportedTrust": [ "reputation" ], "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1", "x402Support": false }, "external_acceptance_receipts": [ { "evidence_url": "https://github.com/tjcgraham-rgb/-gaip-agent-to-art-prototype/actions/runs/36324732597", "name": "io.github.tjcgraham-rgb/gaip-integration-protocol", "surface": "OFFICIAL_MCP_REGISTRY", "version": "1.0.0" } ], "generated_at_utc": "2026-10-21T17:24:38.680477+00:00", "mcp": { "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" }, "oasf": { "authors": [ "GAIP" ], "created_at": "2026-09-24T00:00:00Z", "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).", "domains": [], "extensions": { "gaip": { "agent_id": "integration-protocol", "mcp": "https://www.gaipagents.com/mcp/agents/integration-protocol", "product": "developer-checks", "publication_state": "PENDING_AGNTCY_DIRECTORY_RECEIPT" } }, "locators": [ { "type": "source_code", "urls": [ "https://github.com/tjcgraham-rgb/-gaip-agent-to-art-prototype" ] }, { "type": "documentation", "urls": [ "https://www.gaipagents.com/agents/integration-protocol" ] }, { "type": "a2a_agent_card", "urls": [ "https://www.gaipagents.com/agents/integration-protocol/.well-known/agent-card.json" ] } ], "modules": [], "name": "GAIP Integration & Protocol Agent", "schema_version": "1.0.0", "skills": [ { "id": 1004, "name": "agent_orchestration/agent_coordination" } ], "version": "1.0.0" }, "publication_truth": "OFFICIAL_MCP_REGISTRY_PUBLISHED_OTHER_EXTERNAL_ACCEPTANCE_PENDING", "schema_version": "gaip.ten-agent-distribution-bundle.v1" }