check_agent_conformance

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. Free, read-only, no account; inputs must be public and non-personal.

read-only

Argument	Type	Description
url	string	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.
mode	string	CONFORMANCE (default) checks the interface; VERIFY_BEFORE_CALL returns task-specific evidence about `target` for `intended_task`.
target	any	VERIFY_BEFORE_CALL: the counterparty URL or reference.
metadata	object	Alternative to url: the agent card or MCP/OpenAPI document itself.
protocol	string	Counterparty protocol. Inferred from metadata when omitted, otherwise MCP.
source_url	string	Optional: where `metadata` was published, used only to resolve relative endpoints. Never fetched.
intended_task	string	VERIFY_BEFORE_CALL: what you intend to delegate.
declared_identity	string	Optional: the name the agent claims.
expected_endpoint	string	Optional: the endpoint you expect; a different primary endpoint is reported as ENDPOINT_DRIFT.
data_classification	string	PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "url": "https://www.gaipagents.com/.well-known/agent-card.json"
    },
    {
      "metadata": {
        "url": "https://www.gaipagents.com/mcp",
        "name": "GAIP Broker",
        "tools": [],
        "protocolVersion": "2025-06-18"
      }
    }
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "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."
    },
    "mode": {
      "enum": [
        "CONFORMANCE",
        "VERIFY_BEFORE_CALL"
      ],
      "type": "string",
      "description": "CONFORMANCE (default) checks the interface; VERIFY_BEFORE_CALL returns task-specific evidence about `target` for `intended_task`."
    },
    "target": {
      "oneOf": [
        {
          "type": "string",
          "format": "uri"
        },
        {
          "type": "object"
        }
      ],
      "description": "VERIFY_BEFORE_CALL: the counterparty URL or reference."
    },
    "metadata": {
      "type": "object",
      "description": "Alternative to url: the agent card or MCP/OpenAPI document itself."
    },
    "protocol": {
      "enum": [
        "A2A",
        "MCP",
        "OPENAPI"
      ],
      "type": "string",
      "description": "Counterparty protocol. Inferred from metadata when omitted, otherwise MCP."
    },
    "source_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Optional: where `metadata` was published, used only to resolve relative endpoints. Never fetched."
    },
    "intended_task": {
      "type": "string",
      "description": "VERIFY_BEFORE_CALL: what you intend to delegate."
    },
    "declared_identity": {
      "type": "string",
      "description": "Optional: the name the agent claims."
    },
    "expected_endpoint": {
      "type": "string",
      "format": "uri",
      "description": "Optional: the endpoint you expect; a different primary endpoint is reported as ENDPOINT_DRIFT."
    },
    "data_classification": {
      "enum": [
        "PUBLIC",
        "NON_PERSONAL_PUBLIC"
      ],
      "type": "string",
      "default": "PUBLIC",
      "description": "PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data."
    }
  },
  "additionalProperties": false
}

gaip_check_permission

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. Free, read-only, no account; inputs must be public and non-personal.

read-only

Argument	Type	Description
url*	string	The public https URL your agent wants to fetch.
agent	string	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).
user_agent	string	Alternative to agent: your agent's full User-Agent string.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "url": "https://www.gaipagents.com/test-range",
      "agent": "GPTBot"
    }
  ],
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "The public https URL your agent wants to fetch."
    },
    "agent": {
      "type": "string",
      "maxLength": 300,
      "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)."
    },
    "user_agent": {
      "type": "string",
      "maxLength": 300,
      "description": "Alternative to agent: your agent's full User-Agent string."
    }
  },
  "additionalProperties": false
}

gaip_compare_supplier_snapshots

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. Free, no account; records a GAIP receipt only. Inputs must be public and non-personal.

Argument	Type	Description
prior*	object	The earlier version: agent card, MCP server description, OpenAPI document or snapshot.
current*	object	The later version, same kind as `prior`.
protocol	string	Counterparty protocol. Inferred from metadata when omitted, otherwise MCP.
synthetic	boolean	Optional: true marks a test call.
episode_id	string	Optional: your own id to group related calls.
task_class	string	Optional: short name of the task, e.g. weather_forecast.
counterparty_id	string	Name or URL of the agent/service. Optional.
continuity_handle	object	Optional: the continuity_handle from an earlier GAIP result; links this call to your earlier ones.

gaip_diagnose_integration_failure

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. Free, no account; records a GAIP receipt only. Inputs must be public and non-personal.

Argument	Type	Description
failure*	object	The failure: {code, detail?, http_status?}, e.g. {"code": 429, "detail": "Too Many Requests; Retry-After: 20"}.
protocol	string	Counterparty protocol. Inferred from metadata when omitted, otherwise MCP.
synthetic	boolean	Optional: true marks a test call.
episode_id	string	Optional: your own id to group related calls.
task_class	string	Optional: short name of the task, e.g. weather_forecast.
counterparty_id	string	Name or URL of the agent/service. Optional.
continuity_handle	object	Optional: the continuity_handle from an earlier GAIP result; links this call to your earlier ones.
data_classification	string

gaip_manifest_changes

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. Free, read-only, no account; inputs must be public and non-personal.

read-only

Argument	Type	Description
limit	integer	Optional: maximum entries (1-100).
since	string	Optional: RFC 3339 time, e.g. 2026-09-01T00:00:00Z.
target_id	string	Optional: an Observatory target id (obs_...).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "limit": 20,
      "since": "2026-09-01T00:00:00Z"
    }
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Optional: maximum entries (1-100)."
    },
    "since": {
      "type": "string",
      "format": "date-time",
      "description": "Optional: RFC 3339 time, e.g. 2026-09-01T00:00:00Z."
    },
    "target_id": {
      "type": "string",
      "pattern": "^obs_[0-9a-f]{24}$",
      "description": "Optional: an Observatory target id (obs_...)."
    }
  },
  "additionalProperties": false
}

gaip_observatory_capture

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. Free, no account; records a GAIP receipt only. Inputs must be public and non-personal.

Argument	Type	Description
url*	string	Public https URL of the MCP endpoint or the A2A agent card.
protocol	string	Optional; inferred from the URL (a /.well-known/agent-card.json path is A2A).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "url": "<public https URL of the MCP endpoint or A2A agent card to save>"
    }
  ],
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Public https URL of the MCP endpoint or the A2A agent card."
    },
    "protocol": {
      "enum": [
        "MCP",
        "A2A"
      ],
      "type": "string",
      "description": "Optional; inferred from the URL (a /.well-known/agent-card.json path is A2A)."
    }
  },
  "additionalProperties": false
}

gaip_observatory_lookup

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. Free, read-only, no account; inputs must be public and non-personal.

read-only

Argument	Type	Description
url	string	Public URL of the MCP server or agent to look up.
name	string	Optional: server or agent name to search for.
target_id	string	Optional: an Observatory target id (obs_...).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "url": "https://huggingface.co/mcp"
    }
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "description": "Public URL of the MCP server or agent to look up."
    },
    "name": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional: server or agent name to search for."
    },
    "target_id": {
      "type": "string",
      "pattern": "^obs_[0-9a-f]{24}$",
      "description": "Optional: an Observatory target id (obs_...)."
    }
  },
  "additionalProperties": false
}

gaip_supplier_reliability

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. Free, read-only, no account; inputs must be public and non-personal.

read-only

Argument	Type	Description
card	object	Optional supplier card / server description you integrated against.
failure	object	{code, detail?, http_status?} as for gaip_diagnose_integration_failure.
failures	array	Optional: several failures, each {code, detail}.
protocol	string	Omit to infer it from card, transport or the supplier URL path (else UNKNOWN).
transport	string	Optional transport you used (e.g. streamable-http, sse, GRPC).
task_class	string	Optional: short name of the task, e.g. weather_forecast.
supplier_url*	string	Public https URL of the supplier's agent card, MCP server or API.
lookback_days

gaip_tools_changed_since

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. Free, read-only, no account; inputs must be public and non-personal.

read-only

Argument	Type	Description
url	string	The MCP endpoint (or A2A agent card) URL, exactly as you connect to it.
since	string	Your approval date (RFC 3339 or YYYY-MM-DD): changes recorded since then.
tools	array	The `tools` array from your own tools/list; GAIP hashes it and compares.
target_id	string	Optional: an Observatory target id (obs_...).
tool_digests	array	Per-tool digests in the DRAFT MCP SEP-2636 form (may change).
tools_digest	string	A SHA-256 (64 hex) of the tool list you approved, as GAIP reported it.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "url": "https://huggingface.co/mcp",
      "since": "2026-09-01"
    }
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2048,
      "description": "The MCP endpoint (or A2A agent card) URL, exactly as you connect to it."
    },
    "since": {
      "type": "string",
      "maxLength": 40,
      "description": "Your approval date (RFC 3339 or YYYY-MM-DD): changes recorded since then."
    },
    "tools": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "maxItems": 300,
      "description": "The `tools` array from your own tools/list; GAIP hashes it and compares."
    },
    "target_id": {
      "type": "string",
      "pattern": "^obs_[0-9a-f]{24}$",
      "description": "Optional: an Observatory target id (obs_...)."
    },
    "tool_digests": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^sha256:[0-9a-f]{64}$"
      },
      "maxItems": 2000,
      "description": "Per-tool digests in the DRAFT MCP SEP-2636 form (may change)."
    },
    "tools_digest": {
      "type": "string",
      "maxLength": 71,
      "description": "A SHA-256 (64 hex) of the tool list you approved, as GAIP reported it."
    }
  },
  "additionalProperties": false
}

gaip_watch_events

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. Free, read-only, no account; inputs must be public and non-personal.

read-only

Argument	Type	Description
limit	integer	Optional: maximum events to return.
watch_id	string	The watch_id returned by gaip_watch_register.
continuity_handle*	object	The continuity_handle from an earlier GAIP result; proves you own these watches.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "limit": 10,
      "watch_id": "<watch_id from gaip_watch_register>",
      "continuity_handle": {
        "token": "<continuity_handle.token returned by any GAIP tool>",
        "continuity_id": "<continuity_handle.continuity_id returned by any GAIP tool>"
      }
    }
  ],
  "required": [
    "continuity_handle"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Optional: maximum events to return."
    },
    "watch_id": {
      "type": "string",
      "description": "The watch_id returned by gaip_watch_register."
    },
    "continuity_handle": {
      "type": "object",
      "required": [
        "continuity_id",
        "token"
      ],
      "properties": {
        "token": {
          "type": "string"
        },
        "continuity_id": {
          "type": "string"
        }
      },
      "description": "The continuity_handle from an earlier GAIP result; proves you own these watches."
    }
  },
  "additionalProperties": false
}

gaip_watch_list

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). Free, read-only, no account; inputs must be public and non-personal.

read-only

Argument	Type	Description
continuity_handle*	object	The continuity_handle from an earlier GAIP result; proves you own these watches.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "continuity_handle": {
        "token": "<continuity_handle.token returned by any GAIP tool>",
        "continuity_id": "<continuity_handle.continuity_id returned by any GAIP tool>"
      }
    }
  ],
  "required": [
    "continuity_handle"
  ],
  "properties": {
    "continuity_handle": {
      "type": "object",
      "required": [
        "continuity_id",
        "token"
      ],
      "properties": {
        "token": {
          "type": "string"
        },
        "continuity_id": {
          "type": "string"
        }
      },
      "description": "The continuity_handle from an earlier GAIP result; proves you own these watches."
    }
  },
  "additionalProperties": false
}

gaip_watch_register

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. Free, no account; records a GAIP receipt only. Inputs must be public and non-personal.

Argument	Type	Description
sla	object	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.
kind*	string	AGENT_READINESS (agent URL), SUPPLIER_CARD (published card), DELIVERY_TERMS (terms_id) or DELIVERY_SLA (terms_id plus sla terms).
terms_id	string	DELIVERY_TERMS or DELIVERY_SLA: terms_id from witness_register_terms.
target_url	string	Public https URL (AGENT_READINESS, SUPPLIER_CARD). No query string.
webhook_url	string	Optional: your own public https endpoint for signed change events.
interval_hours	integer	Hours between checks: 24 minimum on the free tier; 1 for DELIVERY_SLA.
continuity_handle*	object

gaip_watch_remove

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. Free, no account; records a GAIP receipt only. Inputs must be public and non-personal.

destructive

Argument	Type	Description
watch_id*	string	The watch_id returned by gaip_watch_register.
continuity_handle*	object	The continuity_handle from an earlier GAIP result; proves you own these watches.

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "watch_id": "<watch_id from gaip_watch_register>",
      "continuity_handle": {
        "token": "<continuity_handle.token returned by any GAIP tool>",
        "continuity_id": "<continuity_handle.continuity_id returned by any GAIP tool>"
      }
    }
  ],
  "required": [
    "continuity_handle",
    "watch_id"
  ],
  "properties": {
    "watch_id": {
      "type": "string",
      "description": "The watch_id returned by gaip_watch_register."
    },
    "continuity_handle": {
      "type": "object",
      "required": [
        "continuity_id",
        "token"
      ],
      "properties": {
        "token": {
          "type": "string"
        },
        "continuity_id": {
          "type": "string"
        }
      },
      "description": "The continuity_handle from an earlier GAIP result; proves you own these watches."
    }
  },
  "additionalProperties": false
}

GAIP Integration & Protocol Agent

Try it

check_agent_conformance Read-only

GAIP Integration & Protocol Agent

Try it

check_agent_conformance Read-only

Tools (13)