GAIP Supplier Watch Agent

Working · 1.7 s

io.github.tjcgraham-rgb/gaip-supplier-watchv1.5.0

Now part of GAIP Check and GAIP Watch: compares supplier snapshots and watches for change.

AI & Agents

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://www.gaipagents.com/mcp/agents/supplier-watch

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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.

priorobject, required

The earlier version: agent card, MCP server description, OpenAPI document or snapshot.

currentobject, required

The later version, same kind as `prior`.

protocolstring

Counterparty protocol. Inferred from metadata when omitted, otherwise MCP.

syntheticboolean

Optional: true marks a test call.

episode_idstring

Optional: your own id to group related calls.

task_classstring

Optional: short name of the task, e.g. weather_forecast.

counterparty_idstring

Name or URL of the agent/service. Optional.

continuity_handleobject

Optional: the continuity_handle from an earlier GAIP result; links this call to your earlier ones.

data_classificationstring

PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data.

independent_operator_idstring

Optional: your operator id (recorded as a claim, not verified).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Try it

Call this server's tools from your browser. Nothing to install.

https://www.gaipagents.com/mcp/agents/supplier-watch

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

gaip_compare_supplier_snapshots

priorobject, required

The earlier version: agent card, MCP server description, OpenAPI document or snapshot.

currentobject, required

The later version, same kind as `prior`.

protocolstring

Counterparty protocol. Inferred from metadata when omitted, otherwise MCP.

syntheticboolean

Optional: true marks a test call.

episode_idstring

Optional: your own id to group related calls.

task_classstring

Optional: short name of the task, e.g. weather_forecast.

counterparty_idstring

Name or URL of the agent/service. Optional.

continuity_handleobject

Optional: the continuity_handle from an earlier GAIP result; links this call to your earlier ones.

data_classificationstring

PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data.

independent_operator_idstring

Optional: your operator id (recorded as a claim, not verified).

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (6)

gaip_compare_supplier_snapshots

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.
data_classification	string	PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data.
independent_operator_id	string	Optional: your operator id (recorded as a claim, not verified).

Input schema (JSON)

{
  "type": "object",
  "examples": [
    {
      "prior": {
        "url": "https://weather.example.com/a2a",
        "name": "Weather Agent",
        "skills": [
          {
            "id": "forecast",
            "name": "Forecast"
          },
          {
            "id": "alerts",
            "name": "Severe weather alerts"
          }
        ],
        "version": "1.4.0",
        "capabilities": {
          "streaming": true
        },
        "protocolVersion": "0.3.0"
      },
      "current": {
        "url": "https://weather.example.com/v2/a2a",
        "name": "Weather Agent",
        "skills": [
          {
            "id": "forecast",
            "name": "Forecast"
          }
        ],
        "version": "2.0.0",
        "security": [
          {
            "bearer": []
          }
        ],
        "capabilities": {
          "streaming": true
        },
        "protocolVersion": "0.3.0",
        "securitySchemes": {
          "bearer": {
            "type": "http",
            "scheme": "bearer"
          }
        }
      },
      "counterparty_id": "example-weather-agent"
    }
  ],
  "required": [
    "prior",
    "current"
  ],
  "properties": {
    "prior": {
      "type": "object",
      "description": "The earlier version: agent card, MCP server description, OpenAPI document or snapshot."
    },
    "current": {
      "type": "object",
      "description": "The later version, same kind as `prior`."
    },
    "protocol": {
      "enum": [
        "A2A",
        "MCP",
        "OPENAPI"
      ],
      "type": "string",
      "description": "Counterparty protocol. Inferred from metadata when omitted, otherwise MCP."
    },
    "synthetic": {
      "type": "boolean",
      "description": "Optional: true marks a test call."
    },
    "episode_id": {
      "type": "string",
      "description": "Optional: your own id to group related calls."
    },
    "task_class": {
      "type": "string",
      "default": "supplier_snapshot_comparison",
      "description": "Optional: short name of the task, e.g. weather_forecast."
    },
    "counterparty_id": {
      "type": "string",
      "description": "Name or URL of the agent/service. Optional."
    },
    "continuity_handle": {
      "type": "object",
      "required": [
        "continuity_id",
        "token"
      ],
      "properties": {
        "token": {
          "type": "string"
        },
        "continuity_id": {
          "type": "string"
        }
      },
      "description": "Optional: the continuity_handle from an earlier GAIP result; links this call to your earlier ones.",
      "additionalProperties": false
    },
    "data_classification": {
      "enum": [
        "PUBLIC",
        "NON_PERSONAL_PUBLIC"
      ],
      "type": "string",
      "default": "PUBLIC",
      "description": "PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data."
    },
    "independent_operator_id": {
      "type": "string",
      "description": "Optional: your operator id (recorded as a claim, not verified)."
    }
  },
  "additionalProperties": true
}

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_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
}

{ "type": "object", "examples": [ { "failure": { "code": 404, "detail": "Not Found" }, "supplier_url": "https://weather.example.com/.well-known/agent-card.json", "failure_started_at": "2026-09-27T12:00:00Z" } ], "required": [ "supplier_url" ], "properties": { "card": { "type": "object", "description": "Optional supplier card / server description you integrated against." }, "failure": { "type": "object", "description": "{code, detail?, http_status?} as for gaip_diagnose_integration_failure." }, "failures": { "type": "array", "maxItems": 100, "minItems": 1, "description": "Optional: several failures, each {code, detail}." }, "protocol": { "enum": [ "A2A", "MCP", "OPENAPI", "UNKNOWN" ], "type": "string", "description": "Omit to infer it from card, transport or the supplier URL path (else UNKNOWN)." }, "transport": { "type": "string", "description": "Optional transport you used (e.g. streamable-http, sse, GRPC)." }, "task_class": { "type": "string", "description": "Optional: short name of the task, e.g. weather_forecast." }, "supplier_url": { "type": "string", "format": "uri", "maxLength": 2048, "description": "Public https URL of the supplier's agent card, MCP server or API." }, "lookback_days": { "type": "integer", "default": 14, "maximum": 30, "minimum": 1, "description": "Optional: days of GAIP observations to look back over." }, "counterparty_id": { "type": "string", "description": "Optional: name of the supplier." }, "failure_started_at": { "type": "string", "format": "date-time", "description": "Optional: RFC 3339 time the failures started." }, "data_classification": { "enum": [ "PUBLIC", "NON_PERSONAL_PUBLIC" ], "type": "string", "default": "PUBLIC", "description": "PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data." } }, "additionalProperties": true }

{ "type": "object", "examples": [ { "kind": "SUPPLIER_CARD", "target_url": "https://weather.example.com/.well-known/agent-card.json", "interval_hours": 24, "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", "kind" ], "properties": { "sla": { "type": "object", "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." }, "kind": { "enum": [ "AGENT_READINESS", "DELIVERY_TERMS", "SUPPLIER_CARD", "DELIVERY_SLA" ], "type": "string", "description": "AGENT_READINESS (agent URL), SUPPLIER_CARD (published card), DELIVERY_TERMS (terms_id) or DELIVERY_SLA (terms_id plus sla terms)." }, "terms_id": { "type": "string", "description": "DELIVERY_TERMS or DELIVERY_SLA: terms_id from witness_register_terms." }, "target_url": { "type": "string", "format": "uri", "maxLength": 2048, "description": "Public https URL (AGENT_READINESS, SUPPLIER_CARD). No query string." }, "webhook_url": { "type": "string", "format": "uri", "maxLength": 2048, "description": "Optional: your own public https endpoint for signed change events." }, "interval_hours": { "type": "integer", "default": 24, "maximum": 168, "minimum": 1, "description": "Hours between checks: 24 minimum on the free tier; 1 for DELIVERY_SLA." }, "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." }, "data_classification": { "enum": [ "PUBLIC", "NON_PERSONAL_PUBLIC" ], "type": "string", "default": "PUBLIC", "description": "PUBLIC (default) or NON_PERSONAL_PUBLIC. Never send personal data." } }, "additionalProperties": false }