GAIP — evidence on AI agents before and after you call them

{'type': 'object', 'examples': [{'url': 'https://www.gaipagents.com/.well-known/agent-card.json'}], 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public https link to the agent, its A2A agent card, MCP server endpoint or OpenAPI document. GAIP fetches, validates and reach-tests it; an MCP endpoint gets a read-only handshake (initialize, tools/list).'}, 'verbose': {'type': 'boolean', 'default': False, 'description': 'Optional: true returns the full result with every underlying field. Default: a short answer.'}, 'intended_task': {'type': 'string', 'maxLength': 500, 'description': "Optional: what you plan to hand it, e.g. 'weather forecast for London'. Adds task-specific evidence."}, '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 (needed to see or remove your watches later).', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'error': 'HTTP 429 Too Many Requests; Retry-After: 20', 'http_status': 429}], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Optional: public https URL of the agent, MCP server or API that failed.'}, 'error': {'type': 'string', 'maxLength': 4000, 'description': 'The error you got, as text: HTTP status line, JSON-RPC/A2A/MCP error or message. Give this and/or http_status.'}, 'verbose': {'type': 'boolean', 'default': False, 'description': 'Optional: true returns the full result with every underlying field. Default: a short answer.'}, 'http_status': {'type': 'integer', 'maximum': 599, 'minimum': 100, 'description': 'Optional: the HTTP status code you got, e.g. 429.'}, '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 (needed to see or remove your watches later).', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'citations': [{'url': 'https://www.gaipagents.com/', 'quote': 'GAIP'}]}], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Claims: the agent or supplier they are about. Delivery: the public https service URL that should deliver.'}, 'checks': {'type': 'array', 'items': {'type': 'object', 'required': ['id'], 'properties': {'id': {'enum': ['http_status_in', 'content_type_is', 'non_empty', 'json_parses', 'json_required_keys', 'json_path_equals', 'max_latency_ms', 'max_bytes', 'text_contains', 'regex'], 'type': 'string', 'description': 'http_status_in (allowed), content_type_is (value), non_empty, json_parses, json_required_keys (keys), json_path_equals (path, value), max_latency_ms (limit), max_bytes (limit), text_contains (value), regex (pattern).'}, 'keys': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200}, 'maxItems': 20, 'minItems': 1, 'description': 'json_required_keys: top-level or dotted keys that must exist, e.g. ["a.b"].'}, 'path': {'type': 'string', 'maxLength': 200, 'description': 'json_path_equals: dotted path, list items by index, e.g. items.0.id.'}, 'limit': {'type': 'integer', 'maximum': 60000, 'minimum': 1, 'description': 'max_latency_ms: milliseconds (1-60000); max_bytes: body bytes (1-32768).'}, 'value': {'type': 'string', 'maxLength': 200, 'description': 'content_type_is: media type, e.g. application/json; text_contains: case-sensitive text; json_path_equals: the expected value (GAIP also accepts a number, boolean, null, array or object).'}, 'allowed': {'type': 'array', 'items': {'type': 'integer', 'maximum': 599, 'minimum': 100}, 'maxItems': 10, 'minItems': 1, 'description': 'http_status_in: the acceptable HTTP statuses, e.g. [200].'}, 'pattern': {'type': 'string', 'maxLength': 200, 'description': 'regex: bounded pattern searched in the body; no nested quantifiers.'}}, 'additionalProperties': False}, 'examples': [[{'id': 'http_status_in', 'allowed': [200]}, {'id': 'content_type_is', 'value': 'application/json'}, {'id': 'non_empty'}, {'id': 'json_parses'}], [{'id': 'http_status_in', 'allowed': [200]}, {'id': 'json_required_keys', 'keys': ['status']}, {'id': 'json_path_equals', 'path': 'status', 'value': 'ok'}, {'id': 'max_latency_ms', 'limit': 2000}]], 'maxItems': 8, 'minItems': 1, 'description': 'Optional (delivery): what a good response is, e.g. [{"id": "http_status_in", "allowed": [200]}, {"id": "json_parses"}]. Default: HTTP 200 and a non-empty body.'}, 'claims': {'type': 'array', 'items': {'oneOf': [{'type': 'string'}, {'type': 'object'}]}, 'maxItems': 20, 'minItems': 1, 'description': 'Claims to record about `url`: each a sentence or {id, text}. Each is compared with the `observations` you supply; without them it stays UNTESTED.'}, 'result': {'type': 'object', 'properties': {'body': {'type': 'string', 'maxLength': 32768}, 'body_sha256': {'type': 'string'}, 'http_status': {'type': 'integer'}, 'content_type': {'type': 'string'}}, 'description': 'Optional (delivery): the response you received. Omitted: GAIP fetches the service URL now (public replay).'}, 'verbose': {'type': 'boolean', 'default': False, 'description': 'Optional: true returns the full result with every underlying field. Default: a short answer.'}, 'metadata': {'type': 'object', 'description': 'Optional (claims): the published agent card, MCP or OpenAPI document.'}, 'terms_id': {'type': 'string', 'description': 'Optional (delivery): terms_id from an earlier registration, instead of url.'}, 'citations': {'type': 'array', 'items': {'oneOf': [{'type': 'string'}, {'type': 'object'}]}, 'maxItems': 20, 'minItems': 1, 'description': 'Citations to check: each {url, quote?} or just a URL. GAIP fetches each page once (robots.txt respected) and looks for the quote.'}, 'observations': {'type': 'array', 'items': {'type': 'object'}, 'maxItems': 30, 'description': 'Optional (claims): what you saw, each {claim_id, result: PASS|FAIL, detail}.'}, '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 (needed to see or remove your watches later).', 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'url': 'https://www.gaipagents.com/mcp'}], 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Public https URL of the MCP server endpoint or agent (card) to follow. No query string.'}, 'verbose': {'type': 'boolean', 'default': False, 'description': 'Optional: true returns the full result with every underlying field. Default: a short answer.'}, 'webhook_url': {'type': 'string', 'format': 'uri', 'maxLength': 2048, 'description': 'Optional: your own public https endpoint. GAIP then registers a watch and POSTs a signed event when the result changes.'}, '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 (needed to see or remove your watches later).', 'additionalProperties': False}}, 'additionalProperties': False}