Agent Help Network MCP
An MCP server that helps AI agents handle HTTP 403 errors and access denials by checking a public hostname's robots.txt, llms.txt, official developer paths, and provider status feeds to determine if they should stop, switch APIs, hand off to a user, or proceed.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://agenthelpnetwork.com/mcpWhat its tools do
3 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (1)
Can change data (2)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to agenthelpnetwork.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Diagnose why an agent hit a 403 or access denied error
- Check if a host's robots.txt blocks specific agent tokens
- Find official developer API paths to bypass page automation
- Verify if a site is down due to a provider incident
Source and maintenance
Vendor evidenceRegistry 0.1.3
- Maintenance checked
Protocol and capabilities
- Server
- Agent Help Network 0.1.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 3 advertised
- Resources
- 0 advertised
- Resource templates
- 0 advertised
- Prompts
- 0 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
3 advertised
check_incident
Advertised read-onlyOpen-world
Call this when a web step is blocked or failing for no clear reason (a 403 or access denied, a 429, a 5xx or a timeout, a login wall, a "verify you are human" or CAPTCHA page), when sign-in failed or an extra verification step appeared (a code, app approval, new-device check; error_class=login_auth), or when asked "is this site down?" or whether its robots rules block agents. Skip it when the page opened normally or your own tool or platform already said why it refused (e.g. robots.txt or platform policy). Look the host up once per blocked step, before deciding whether to retry. Send the public hostname, never a URL path, query or credentials; add codes only when you observed them: error_class (site_access, login_auth, human_verification, service_error), failure_stage (before_target_response, response_observed, access_denial_observed, unknown), http_status, challenge, retry_after, via. Send agent_vendor only when you know which vendor's documented robots.txt token your requests send: openai, anthropic (Claude-User), google, perplexity, meta, mistral, amazon, microsoft, apple, duckduckgo, diffbot, exa, or other if none. Browser automation usually sends a normal browser user agent, so robots.txt agent tokens may not apply; leave agent_vendor out then. The answer: summary_line, next_action (do, url, retry_after_seconds), recommendation.action, access_profile, official_paths, provider_status and observations. no_reports is not a healthy site. Then follow next_action (continue, wait, use a listed official path, hand the step to the user, stop retrying, or look up once more). On 'pending', look up once more after retry_after_seconds; do not poll. Read-only: it may fetch the host's public robots.txt, llms.txt and status feed, and the home page unless robots.txt bars it (ahn_check), never changes the target site or your data; lookups and the codes you send are counted anonymously per host and hour. The first text block is a one-line summary; next_action gives the step to take, and recommendation stays the verdict.
check_incident input schema
{
"type": "object",
"title": "check_incidentArguments",
"required": [
"site_host"
],
"properties": {
"via": {
"enum": [
"http_fetch",
"browser",
"unknown"
],
"type": "string",
"title": "Via",
"default": null
},
"test": {
"type": "boolean",
"title": "Test",
"default": null,
"description": "Set true to mark this lookup as a test (like the header X-AHN-Test: 1): it is kept out of the anonymous counts and the answer is the same. Leave it out for a real lookup; any other value is ignored."
},
"challenge": {
"enum": [
"header",
"none"
],
"type": "string",
"title": "Challenge",
"default": null
},
"failed_at": {
"type": "string",
"title": "Failed At",
"default": null,
"maxLength": 40,
"description": "When the step failed, as an ISO 8601 time such as 2026-11-01T07:10:00Z (UTC if no offset). Leave it out for a failure that just happened. Only used to choose the cause shown in the answer; not stored."
},
"site_host": {
"type": "string",
"title": "Site Host"
},
"task_step": {
"type": "string",
"title": "Task Step",
"default": ""
},
"error_class": {
"type": "string",
"title": "Error Class",
"default": ""
},
"http_status": {
"type": "integer",
"title": "Http Status",
"default": null,
"description": "HTTP status the site returned: 401, 402, 403, 407, 408, 429, 451 or 500-599. Leave out if unknown."
},
"retry_after": {
"enum": [
"none",
"lt_60",
"60_3600",
"gt_3600"
],
"type": "string",
"title": "Retry After",
"default": null
},
"agent_vendor": {
"enum": [
"openai",
"anthropic",
"google",
"perplexity",
"meta",
"mistral",
"amazon",
"microsoft",
"apple",
"duckduckgo",
"diffbot",
"exa",
"other"
],
"type": "string",
"title": "Agent Vendor",
"default": null
},
"failure_stage": {
"type": "string",
"title": "Failure Stage",
"default": ""
}
}
}check_incident output schema
{
"type": "object",
"$defs": {
"Cause": {
"type": "object",
"title": "Cause",
"required": [
"branch",
"hint",
"confidence",
"basis",
"line"
],
"properties": {
"hint": {
"enum": [
"home_now_gated",
"persistent_refusal",
"provider_incident",
"site_errors",
"recovered",
"rate_limited",
"others_failing_same_hour",
"your_side_likely",
"no_measurement",
"home_gate_unconfirmed",
"robots_now_disallows",
"terms_signal_changed",
"new_bot_defense"
],
"type": "string",
"title": "Hint"
},
"line": {
"type": "string",
"title": "Line",
"pattern": "^[ -~]+$",
"maxLength": 200,
"minLength": 1
},
"note": {
"type": "string",
"title": "Note",
"default": "Information only; follow next_action.",
"pattern": "^[ -~]+$",
"maxLength": 80,
"minLength": 1
},
"basis": {
"type": "array",
"items": {
"enum": [
"provider_status_events",
"outage_episodes",
"site_probe",
"site_probe_daily",
"lookup_signals_hourly",
"host_access_changes"
],
"type": "string"
},
"title": "Basis",
"maxItems": 6
},
"branch": {
"enum": [
"policy_closed",
"transient",
"undetermined"
],
"type": "string",
"title": "Branch"
},
"window": {
"anyOf": [
{
"$ref": "#/$defs/CauseWindow"
},
{
"type": "null"
}
],
"default": null
},
"confidence": {
"enum": [
"high",
"medium",
"low"
],
"type": "string",
"title": "Confidence"
},
"recheck_after": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Recheck After",
"default": null
}
},
"description": "D73: why the step failed, from AHN's own stored host-level measurements. Information only: it is added after the\nrecommendation is final and changes none of it. ``line`` is a fixed English sentence with times and no site text.",
"additionalProperties": true
},
"Links": {
"type": "object",
"title": "Links",
"properties": {
"feedback": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Feedback",
"default": null
},
"changelog": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Changelog",
"default": null
}
},
"additionalProperties": true
},
"Outcome": {
"enum": [
"passed",
"blocked",
"error",
"abandoned"
],
"type": "string",
"title": "Outcome"
},
"TdmRule": {
"type": "object",
"title": "TdmRule",
"required": [
"location"
],
"properties": {
"location": {
"type": "string",
"title": "Location"
},
"tdm_policy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tdm Policy",
"default": null
},
"tdm_reservation": {
"anyOf": [
{
"enum": [
0,
1
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Tdm Reservation",
"default": null
}
},
"additionalProperties": true
},
"AhnCheck": {
"type": "object",
"title": "AhnCheck",
"required": [
"status",
"basis",
"vantage",
"ua_token",
"path_kind",
"fingerprint_version",
"note"
],
"properties": {
"note": {
"type": "string",
"title": "Note"
},
"basis": {
"type": "string",
"const": "ahn_server",
"title": "Basis"
},
"status": {
"enum": [
"measured",
"pending",
"not_measured"
],
"type": "string",
"title": "Status"
},
"outcome": {
"anyOf": [
{
"enum": [
"reachable",
"redirected_same_host",
"bot_challenge",
"refused",
"rate_limited",
"login_wall",
"redirected_offsite",
"server_error",
"unreachable",
"other_status"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Outcome",
"default": null
},
"vantage": {
"$ref": "#/$defs/AhnCheckVantage"
},
"redirect": {
"anyOf": [
{
"$ref": "#/$defs/AhnCheckRedirect"
},
{
"type": "null"
}
],
"default": null
},
"ua_token": {
"type": "string",
"const": "AgentHelpNetwork",
"title": "Ua Token"
},
"freshness": {
"anyOf": [
{
"enum": [
"fresh",
"stale"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Freshness",
"default": null
},
"path_kind": {
"type": "string",
"const": "home",
"title": "Path Kind"
},
"age_seconds": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Age Seconds",
"default": null
},
"bot_defense": {
"anyOf": [
{
"$ref": "#/$defs/AhnCheckBotDefense"
},
{
"type": "null"
}
],
"default": null
},
"http_status": {
"anyOf": [
{
"type": "integer",
"maximum": 599,
"minimum": 100
},
{
"type": "null"
}
],
"title": "Http Status",
"default": null
},
"measured_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Measured At",
"default": null
},
"response_ms": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Response Ms",
"default": null
},
"login_signal": {
"anyOf": [
{
"enum": [
"http_auth",
"redirect",
"form"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Login Signal",
"default": null
},
"edge_vendors_seen": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"cloudflare",
"datadome",
"perimeterx",
"aws_waf",
"vercel",
"generic_captcha",
"unknown"
],
"type": "string"
},
"maxItems": 5
},
{
"type": "null"
}
],
"title": "Edge Vendors Seen",
"default": null
},
"fingerprint_version": {
"type": "string",
"title": "Fingerprint Version",
"maxLength": 16
},
"not_measured_reason": {
"anyOf": [
{
"enum": [
"robots_disallowed",
"robots_refused",
"robots_unreadable",
"robots_stale",
"not_eligible",
"budget",
"backoff",
"disabled"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Not Measured Reason",
"default": null
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 3600,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Retry After Seconds",
"default": null
}
},
"description": "D67: the outcome of AHN's own server's check of the host's home page, as codes. Information only; it is added after\nthe recommendation is decided and changes none of it (except the D85 case, ``edge_refusal_confirmed``). Fields that do not apply are left out, never null.",
"additionalProperties": true
},
"Feedback": {
"type": "object",
"title": "Feedback",
"required": [
"token",
"expires_in_seconds",
"outcomes",
"paths"
],
"properties": {
"paths": {
"type": "array",
"items": {
"$ref": "#/$defs/FeedbackPath"
},
"title": "Paths"
},
"token": {
"type": "string",
"title": "Token",
"maxLength": 530
},
"outcomes": {
"type": "array",
"items": {
"$ref": "#/$defs/FeedbackOutcome"
},
"title": "Outcomes"
},
"expires_in_seconds": {
"type": "integer",
"title": "Expires In Seconds",
"maximum": 3600,
"minimum": 1
}
},
"description": "D58: a one-time token for saying, later, whether the next attempt worked (POST /v1/feedback, MCP rate_last_lookup).",
"additionalProperties": true
},
"AccessMcp": {
"type": "object",
"title": "AccessMcp",
"required": [
"endpoint",
"doc_url"
],
"properties": {
"doc_url": {
"type": "string",
"title": "Doc Url",
"pattern": "^https://[^\\s]+$"
},
"endpoint": {
"type": "string",
"title": "Endpoint",
"pattern": "^https://[^\\s]+$"
}
},
"additionalProperties": true
},
"AgentRule": {
"type": "object",
"title": "AgentRule",
"required": [
"agent",
"kind",
"explicit_group",
"root_allowed",
"disallow_count"
],
"properties": {
"kind": {
"enum": [
"user_agent",
"search_crawler",
"training_crawler"
],
"type": "string",
"title": "Kind"
},
"agent": {
"type": "string",
"title": "Agent"
},
"crawl_delay": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Crawl Delay",
"default": null
},
"root_allowed": {
"type": "boolean",
"title": "Root Allowed"
},
"disallow_count": {
"type": "integer",
"title": "Disallow Count",
"minimum": 0
},
"disallow_paths": {
"type": "array",
"items": {
"type": "string"
},
"title": "Disallow Paths"
},
"explicit_group": {
"type": "boolean",
"title": "Explicit Group"
}
},
"additionalProperties": true
},
"HostFacts": {
"type": "object",
"title": "HostFacts",
"required": [
"note"
],
"properties": {
"note": {
"type": "string",
"title": "Note"
},
"suffix_rule": {
"anyOf": [
{
"$ref": "#/$defs/SuffixRule"
},
{
"type": "null"
}
],
"default": null
},
"government_registry": {
"anyOf": [
{
"$ref": "#/$defs/GovernmentRegistry"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": true
},
"NextCheck": {
"type": "object",
"title": "NextCheck",
"required": [
"code",
"text"
],
"properties": {
"code": {
"enum": [
"locate_failure_stage",
"human_handoff",
"account_handoff",
"before_target_response",
"response_observed",
"access_denial_observed",
"edge_refusal_confirmed",
"edge_refusal_robots",
"no_path_after_failure",
"provider_scope",
"provider_components_only",
"provider_incident_stale",
"provider_scope_partial",
"provider_update_time_unknown",
"provider_maintenance_only",
"provider_history_incident",
"provider_clear",
"provider_unknown",
"reports_unknown",
"reports_stale",
"reports_unverified",
"robots_blocks_agents",
"robots_blocks_some_agents",
"robots_names_vendor_alias",
"robots_blocks_not_your_agent",
"robots_allows_agents",
"robots_wildcard_disallow",
"robots_grouping_differs_by_parser",
"robots_unknown",
"robots_fetch_refused",
"profile_not_read",
"profile_pending",
"llms_txt_present",
"content_use_ai_input_declared_no",
"official_path_available",
"government_registry_listed",
"government_suffix_restricted",
"government_list_version_missing"
],
"type": "string",
"title": "Code"
},
"text": {
"type": "string",
"title": "Text"
}
},
"additionalProperties": true
},
"TdmHeader": {
"type": "object",
"title": "TdmHeader",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"title": "Path"
},
"tdm_policy": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Tdm Policy",
"default": null
},
"tdm_reservation": {
"anyOf": [
{
"enum": [
0,
1
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Tdm Reservation",
"default": null
}
},
"description": "tdm-reservation / tdm-policy response headers seen on the response to one of the files read.",
"additionalProperties": true
},
"AccessAuth": {
"type": "object",
"title": "AccessAuth",
"required": [
"method",
"source_url"
],
"properties": {
"method": {
"enum": [
"none",
"api_key",
"oauth1",
"oauth2",
"device_code",
"pat"
],
"type": "string",
"title": "Method"
},
"source_url": {
"type": "string",
"title": "Source Url",
"pattern": "^https://[^\\s]+$"
}
},
"additionalProperties": true
},
"ApiCatalog": {
"type": "object",
"title": "ApiCatalog",
"required": [
"status",
"source_url"
],
"properties": {
"apis": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/CatalogApi"
}
},
{
"type": "null"
}
],
"title": "Apis",
"default": null
},
"items": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Items",
"default": null
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason",
"default": null
},
"status": {
"enum": [
"declared",
"none_declared",
"not_read"
],
"type": "string",
"title": "Status"
},
"apis_total": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Apis Total",
"default": null
},
"source_url": {
"type": "string",
"title": "Source Url"
},
"items_total": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Items Total",
"default": null
},
"nested_catalogs": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Nested Catalogs",
"default": null
}
},
"description": "/.well-known/api-catalog (RFC 9727). Fields other than status and source_url appear only when declared.",
"additionalProperties": true
},
"AttemptEnv": {
"enum": [
"agent_cloud_browser",
"human_in_agent_browser",
"human_own_browser",
"unknown"
],
"type": "string",
"title": "AttemptEnv"
},
"CatalogApi": {
"type": "object",
"title": "CatalogApi",
"properties": {
"anchor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Anchor",
"default": null
},
"status": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Status",
"default": null
},
"service_doc": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Service Doc",
"default": null
},
"service_desc": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Service Desc",
"default": null
},
"service_meta": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Service Meta",
"default": null
}
},
"description": "One API of an RFC 9727 catalog: its anchor and RFC 8631 links as published (at most 3 per relation).",
"additionalProperties": true
},
"ErrorClass": {
"enum": [
"site_access",
"login_auth",
"human_verification",
"service_error"
],
"type": "string",
"title": "ErrorClass"
},
"NextAction": {
"type": "object",
"title": "NextAction",
"required": [
"do"
],
"properties": {
"do": {
"enum": [
"wait_for_provider",
"hand_off_to_human",
"use_official_path",
"stop_automation",
"proceed",
"retry_lookup_once",
"stop_if_listed",
"lookup_apex_host",
"no_clear_action"
],
"type": "string",
"title": "Do"
},
"url": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"status_url": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"title": "Status Url",
"default": null
},
"lookup_host": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Lookup Host",
"default": null
},
"customer_url": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
],
"title": "Customer Url",
"default": null
},
"stop_if_you_are": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"maxItems": 16,
"minItems": 1
},
{
"type": "null"
}
],
"title": "Stop If You Are",
"default": null
},
"status_url_covers": {
"anyOf": [
{
"type": "string",
"const": "api"
},
{
"type": "null"
}
],
"title": "Status Url Covers",
"default": null
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 3600,
"minimum": 0
},
{
"type": "null"
}
],
"title": "Retry After Seconds",
"default": null
}
},
"description": "D51: what to do now, computed from the recommendation (never a second verdict).",
"additionalProperties": true
},
"SuffixRule": {
"type": "object",
"title": "SuffixRule",
"required": [
"suffix",
"rule",
"text",
"source_url"
],
"properties": {
"rule": {
"type": "string",
"const": "registration_limited_to_government",
"title": "Rule"
},
"text": {
"type": "string",
"title": "Text"
},
"suffix": {
"type": "string",
"title": "Suffix"
},
"source_url": {
"type": "string",
"title": "Source Url"
}
},
"additionalProperties": true
},
"AccessQuote": {
"type": "object",
"title": "AccessQuote",
"required": [
"quote",
"source_url"
],
"properties": {
"quote": {
"type": "string",
"title": "Quote",
"maxLength": 200,
"minLength": 1
},
"source_url": {
"type": "string",
"title": "Source Url",
"pattern": "^https://[^\\s]+$"
}
},
"additionalProperties": true
},
"AccessTerms": {
"type": "object",
"title": "AccessTerms",
"required": [
"url",
"quote"
],
"properties": {
"url": {
"type": "string",
"title": "Url",
"pattern": "^https://[^\\s]+$"
},
"quote": {
"type": "string",
"title": "Quote",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": true
},
"AgentVendor": {
"enum": [
"openai",
"anthropic",
"google",
"perplexity",
"meta",
"mistral",
"amazon",
"microsoft",
"apple",
"duckduckgo",
"diffbot",
"exa",
"other"
],
"type": "string",
"title": "AgentVendor",
"description": "D48 lookup parameter: the vendor whose documented robots.txt token the caller's own web requests send\n(access_profile.AGENT_VENDORS, plus other). Not the model vendor, and unrelated to the report field agent_family."
},
"CauseWindow": {
"type": "object",
"title": "CauseWindow",
"required": [
"from"
],
"properties": {
"to": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "To",
"default": null
},
"from": {
"type": "string",
"title": "From",
"format": "date-time"
}
},
"description": "D73: the period of the measurement the cause rests on (UTC). ``to`` is left out while it is still going on.",
"additionalProperties": true
},
"AttemptActor": {
"enum": [
"agent",
"human"
],
"type": "string",
"title": "AttemptActor"
},
"ConsumerPath": {
"type": "object",
"title": "ConsumerPath",
"required": [
"kind",
"url",
"source_url"
],
"properties": {
"url": {
"type": "string",
"title": "Url",
"pattern": "^https://[^\\s]+$",
"maxLength": 200
},
"kind": {
"enum": [
"customer_help",
"official_app",
"entry_link"
],
"type": "string",
"title": "Kind"
},
"topic": {
"anyOf": [
{
"enum": [
"returns",
"orders",
"contact",
"help",
"account",
"shipping"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Topic",
"default": null
},
"source_url": {
"type": "string",
"title": "Source Url",
"pattern": "^https://[^\\s]+$",
"maxLength": 200
}
},
"additionalProperties": true
},
"ContentUsage": {
"type": "object",
"title": "ContentUsage",
"required": [
"train_ai",
"ai_use",
"search"
],
"properties": {
"ai_use": {
"enum": [
"yes",
"no",
"unset"
],
"type": "string",
"title": "Ai Use"
},
"search": {
"enum": [
"yes",
"no",
"unset"
],
"type": "string",
"title": "Search"
},
"train_ai": {
"enum": [
"yes",
"no",
"unset"
],
"type": "string",
"title": "Train Ai"
}
},
"description": "IETF AIPREF preferences (draft-ietf-aipref-vocab-08 categories), y/n normalized to yes/no.",
"additionalProperties": true
},
"FailureStage": {
"enum": [
"before_target_response",
"response_observed",
"access_denial_observed",
"unknown"
],
"type": "string",
"title": "FailureStage"
},
"FeedbackPath": {
"enum": [
"official_path",
"same_site",
"unknown"
],
"type": "string",
"title": "FeedbackPath",
"description": "D58: which way the attempt that the outcome is about went."
},
"McpDiscovery": {
"type": "object",
"title": "McpDiscovery",
"required": [
"status",
"source_url"
],
"properties": {
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason",
"default": null
},
"status": {
"enum": [
"declared",
"none_declared",
"not_read"
],
"type": "string",
"title": "Status"
},
"servers": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/McpCatalogServer"
}
},
{
"type": "null"
}
],
"title": "Servers",
"default": null
},
"source_url": {
"type": "string",
"title": "Source Url"
},
"experimental": {
"type": "boolean",
"const": true,
"title": "Experimental",
"default": true
},
"spec_version": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Spec Version",
"default": null
},
"servers_total": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Servers Total",
"default": null
}
},
"description": "Experimental: MCP Server Card entries of the host's /.well-known/ai-catalog.json (MCP SEP-2127 discovery).",
"additionalProperties": true
},
"RulesUniform": {
"type": "object",
"title": "RulesUniform",
"required": [
"explicit_group",
"root_allowed",
"disallow_count"
],
"properties": {
"crawl_delay": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Crawl Delay",
"default": null
},
"root_allowed": {
"type": "boolean",
"title": "Root Allowed"
},
"disallow_count": {
"type": "integer",
"title": "Disallow Count",
"minimum": 0
},
"disallow_paths": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Disallow Paths",
"default": null
},
"explicit_group": {
"type": "boolean",
"title": "Explicit Group"
}
},
"description": "D94: the values every token in the (left-out) `rules` list shares.",
"additionalProperties": true
},
"SiteDeclared": {
"type": "object",
"title": "SiteDeclared",
"required": [
"api_catalog",
"tdm",
"freshness"
],
"properties": {
"tdm": {
"$ref": "#/$defs/TdmReservation"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"freshness": {
"enum": [
"fresh",
"stale",
"pending"
],
"type": "string",
"title": "Freshness"
},
"fetched_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Fetched At",
"default": null
},
"api_catalog": {
"$ref": "#/$defs/ApiCatalog"
},
"mcp_discovery": {
"anyOf": [
{
"$ref": "#/$defs/McpDiscovery"
},
{
"type": "null"
}
],
"default": null
}
},
"description": "What the host publishes for agents at standard locations (D59); information only, never in the recommendation.",
"additionalProperties": true
},
"AccessProfile": {
"type": "object",
"title": "AccessProfile",
"required": [
"robots_status",
"llms_txt_status",
"source_urls",
"freshness",
"note"
],
"properties": {
"note": {
"type": "string",
"title": "Note"
},
"robots": {
"anyOf": [
{
"$ref": "#/$defs/RobotsSummary"
},
{
"type": "null"
}
],
"default": null
},
"freshness": {
"enum": [
"fresh",
"stale",
"pending"
],
"type": "string",
"title": "Freshness"
},
"read_host": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Read Host",
"default": null
},
"fetched_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Fetched At",
"default": null
},
"content_use": {
"anyOf": [
{
"oneOf": [
{
"$ref": "#/$defs/ContentUseDeclared"
},
{
"$ref": "#/$defs/ContentUseCompact"
}
],
"discriminator": {
"mapping": {
"declared": "#/$defs/ContentUseDeclared",
"not_read": "#/$defs/ContentUseCompact",
"none_declared": "#/$defs/ContentUseCompact"
},
"propertyName": "status"
}
},
{
"type": "null"
}
],
"title": "Content Use",
"default": null
},
"llms_detail": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Llms Detail",
"default": null
},
"source_urls": {
"type": "object",
"title": "Source Urls",
"additionalProperties": {
"type": "string"
}
},
"robots_detail": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Robots Detail",
"default": null
},
"robots_status": {
"enum": [
"ok",
"absent",
"redirected",
"refused",
"invalid",
"error",
"too_large",
"not_public",
"pending"
],
"type": "string",
"title": "Robots Status"
},
"site_declared": {
"anyOf": [
{
"$ref": "#/$defs/SiteDeclared"
},
{
"type": "null"
}
],
"default": null
},
"llms_txt_status": {
"enum": [
"present",
"absent",
"redirected",
"refused",
"error",
"not_public",
"pending",
"not_read"
],
"type": "string",
"title": "Llms Txt Status"
},
"retry_after_seconds": {
"anyOf": [
{
"type": "integer",
"maximum": 3600,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Retry After Seconds",
"default": null
}
},
"additionalProperties": true
},
"ConsumerPaths": {
"type": "object",
"title": "ConsumerPaths",
"required": [
"paths",
"verified_at"
],
"properties": {
"paths": {
"type": "array",
"items": {
"$ref": "#/$defs/ConsumerPath"
},
"title": "Paths",
"maxItems": 6,
"minItems": 1
},
"verified_at": {
"type": "string",
"title": "Verified At",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"additionalProperties": true
},
"OfficialPaths": {
"type": "object",
"title": "OfficialPaths",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"access": {
"anyOf": [
{
"$ref": "#/$defs/OfficialAccess"
},
{
"type": "null"
}
],
"default": null
},
"api_docs": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Api Docs",
"default": null
},
"consumer": {
"anyOf": [
{
"$ref": "#/$defs/ConsumerPaths"
},
{
"type": "null"
}
],
"default": null
},
"developer_portal": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Developer Portal",
"default": null
}
},
"additionalProperties": true
},
"RobotsSummary": {
"type": "object",
"title": "RobotsSummary",
"required": [
"wildcard_root_allowed"
],
"properties": {
"rules": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/AgentRule"
}
},
{
"type": "null"
}
],
"title": "Rules",
"default": null
},
"sitemap": {
"type": "boolean",
"title": "Sitemap",
"default": false
},
"sitemaps": {
"type": "array",
"items": {
"type": "string"
},
"title": "Sitemaps"
},
"rules_omitted": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Rules Omitted",
"default": null
},
"rules_uniform": {
"anyOf": [
{
"$ref": "#/$defs/RulesUniform"
},
{
"type": "null"
}
],
"default": null
},
"agents_allowed": {
"type": "array",
"items": {
"type": "string"
},
"title": "Agents Allowed"
},
"agents_blocked": {
"type": "array",
"items": {
"type": "string"
},
"title": "Agents Blocked"
},
"wildcard_crawl_delay": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Wildcard Crawl Delay",
"default": null
},
"wildcard_root_allowed": {
"type": "boolean",
"title": "Wildcard Root Allowed"
},
"vendor_aliases_blocked": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Vendor Aliases Blocked",
"default": null
},
"wildcard_disallow_paths": {
"type": "array",
"items": {
"type": "string"
},
"title": "Wildcard Disallow Paths"
},
"grouping_differs_by_parser": {
"type": "array",
"items": {
"type": "string"
},
"title": "Grouping Differs By Parser"
}
},
"additionalProperties": true
},
"ContentSignals": {
"type": "object",
"title": "ContentSignals",
"required": [
"search",
"ai_input",
"ai_train"
],
"properties": {
"use": {
"anyOf": [
{
"enum": [
"immediate",
"reference",
"full"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Use",
"default": null
},
"search": {
"enum": [
"yes",
"no",
"unset"
],
"type": "string",
"title": "Search"
},
"ai_input": {
"enum": [
"yes",
"no",
"unset"
],
"type": "string",
"title": "Ai Input"
},
"ai_train": {
"enum": [
"yes",
"no",
"unset"
],
"type": "string",
"title": "Ai Train"
}
},
"description": "Cloudflare Content Signals, normalized; `use` is Cloudflare's experimental fourth signal.",
"additionalProperties": true
},
"LookupActivity": {
"type": "object",
"title": "LookupActivity",
"required": [
"period_days",
"volume_band"
],
"properties": {
"unit": {
"type": "string",
"const": "requests_not_agents",
"title": "Unit",
"default": "requests_not_agents"
},
"trend": {
"anyOf": [
{
"type": "string",
"const": "increased"
},
{
"type": "null"
}
],
"title": "Trend",
"default": null
},
"period_days": {
"type": "integer",
"const": 7,
"title": "Period Days"
},
"volume_band": {
"enum": [
"1-4",
"5-9",
"10-49",
"50+"
],
"type": "string",
"title": "Volume Band"
}
},
"additionalProperties": true
},
"OfficialAccess": {
"type": "object",
"title": "OfficialAccess",
"required": [
"verified_at"
],
"properties": {
"auth": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/AccessAuth"
},
"minItems": 1
},
{
"type": "null"
}
],
"title": "Auth",
"default": null
},
"feeds": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^https://[^\\s]+$",
"maxLength": 300
},
"maxItems": 3,
"minItems": 1
},
{
"type": "null"
}
],
"title": "Feeds",
"default": null
},
"terms": {
"anyOf": [
{
"$ref": "#/$defs/AccessTerms"
},
{
"type": "null"
}
],
"default": null
},
"docs_repo": {
"anyOf": [
{
"type": "string",
"pattern": "^https://[^\\s]+$",
"maxLength": 300
},
{
"type": "null"
}
],
"title": "Docs Repo",
"default": null
},
"free_tier": {
"anyOf": [
{
"$ref": "#/$defs/AccessQuote"
},
{
"type": "null"
}
],
"default": null
},
"openapi_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https://[^\\s]+$"
},
{
"type": "null"
}
],
"title": "Openapi Url",
"default": null
},
"sandbox_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https://[^\\s]+$"
},
{
"type": "null"
}
],
"title": "Sandbox Url",
"default": null
},
"verified_at": {
"type": "string",
"title": "Verified At",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"official_mcp": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/AccessMcp"
},
"minItems": 1
},
{
"type": "null"
}
],
"title": "Official Mcp",
"default": null
},
"llms_full_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https://[^\\s]+$",
"maxLength": 300
},
{
"type": "null"
}
],
"title": "Llms Full Url",
"default": null
},
"key_signup_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https://[^\\s]+$"
},
{
"type": "null"
}
],
"title": "Key Signup Url",
"default": null
},
"data_export_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https://[^\\s]+$",
"maxLength": 300
},
{
"type": "null"
}
],
"title": "Data Export Url",
"default": null
},
"rate_limits_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https://[^\\s]+$"
},
{
"type": "null"
}
],
"title": "Rate Limits Url",
"default": null
}
},
"additionalProperties": true
},
"ProviderStatus": {
"type": "object",
"title": "ProviderStatus",
"required": [
"source_name",
"source_url",
"indicator",
"fetched_at",
"source_updated_at",
"freshness"
],
"properties": {
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Note",
"default": null
},
"basis": {
"anyOf": [
{
"enum": [
"incident",
"maintenance",
"components_only"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Basis",
"default": null
},
"affected": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"maxLength": 80,
"minLength": 1
},
"maxItems": 3,
"minItems": 1
},
{
"type": "null"
}
],
"title": "Affected",
"default": null
},
"freshness": {
"enum": [
"pending",
"fresh",
"stale"
],
"type": "string",
"title": "Freshness"
},
"indicator": {
"anyOf": [
{
"enum": [
"none",
"minor",
"major",
"critical",
"maintenance",
"unknown"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Indicator"
},
"fetched_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Fetched At"
},
"source_url": {
"type": "string",
"title": "Source Url"
},
"source_kind": {
"anyOf": [
{
"type": "string",
"const": "history_atom"
},
{
"type": "null"
}
],
"title": "Source Kind",
"default": null
},
"source_name": {
"type": "string",
"title": "Source Name"
},
"source_time": {
"anyOf": [
{
"enum": [
"active_items",
"page"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Time",
"default": null
},
"error_detail": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Error Detail",
"default": null
},
"window_blind": {
"anyOf": [
{
"type": "boolean",
"const": true
},
{
"type": "null"
}
],
"title": "Window Blind",
"default": null
},
"active_incidents": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Active Incidents",
"default": null
},
"source_updated_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Source Updated At"
},
"active_maintenances": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Active Maintenances",
"default": null
},
"incident_updated_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Incident Updated At",
"default": null
},
"max_incident_impact": {
"anyOf": [
{
"enum": [
"none",
"minor",
"major",
"critical"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Max Incident Impact",
"default": null
}
},
"additionalProperties": true
},
"Recommendation": {
"type": "object",
"title": "Recommendation",
"required": [
"action",
"confidence"
],
"properties": {
"action": {
"enum": [
"proceed",
"use_official_path",
"hand_off_to_human",
"wait_provider_incident",
"stop_declared_block",
"unknown"
],
"type": "string",
"title": "Action"
},
"reasons": {
"type": "array",
"items": {
"type": "string"
},
"title": "Reasons"
},
"confidence": {
"enum": [
"low",
"medium",
"high"
],
"type": "string",
"title": "Confidence"
},
"agent_vendor": {
"anyOf": [
{
"$ref": "#/$defs/AgentVendor"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": true
},
"TdmReservation": {
"type": "object",
"title": "TdmReservation",
"required": [
"status",
"source_url"
],
"properties": {
"rules": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/TdmRule"
}
},
{
"type": "null"
}
],
"title": "Rules",
"default": null
},
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason",
"default": null
},
"status": {
"enum": [
"declared",
"none_declared",
"not_read"
],
"type": "string",
"title": "Status"
},
"headers": {
"anyOf": [
{
"type": "array",
"items": {
"$ref": "#/$defs/TdmHeader"
}
},
{
"type": "null"
}
],
"title": "Headers",
"default": null
},
"source_url": {
"type": "string",
"title": "Source Url"
},
"file_reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "File Reason",
"default": null
},
"file_status": {
"anyOf": [
{
"enum": [
"none_declared",
"not_read"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "File Status",
"default": null
},
"rules_total": {
"anyOf": [
{
"type": "integer",
"minimum": 0
},
{
"type": "null"
}
],
"title": "Rules Total",
"default": null
},
"any_reserved": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Any Reserved",
"default": null
},
"root_reservation": {
"anyOf": [
{
"enum": [
0,
1
],
"type": "integer"
},
{
"type": "null"
}
],
"title": "Root Reservation",
"default": null
}
},
"description": "/.well-known/tdmrep.json and TDM response headers (W3C TDMRep). Quoted as declared, never a legal reading.",
"additionalProperties": true
},
"AhnCheckVantage": {
"type": "object",
"title": "AhnCheckVantage",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"datacenter",
"residential",
"mobile",
"unknown"
],
"type": "string",
"title": "Kind"
},
"region": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Region",
"default": null
}
},
"additionalProperties": true
},
"ContentUseGroup": {
"type": "object",
"title": "ContentUseGroup",
"required": [
"agents"
],
"properties": {
"usage": {
"anyOf": [
{
"$ref": "#/$defs/ContentUsage"
},
{
"type": "null"
}
],
"default": null
},
"agents": {
"type": "array",
"items": {
"type": "string"
},
"title": "Agents"
},
"signals": {
"anyOf": [
{
"$ref": "#/$defs/ContentSignals"
},
{
"type": "null"
}
],
"default": null
},
"other_agents": {
"type": "integer",
"title": "Other Agents",
"default": 0,
"minimum": 0
},
"path_specific_samples": {
"type": "array",
"items": {
"type": "string"
},
"title": "Path Specific Samples"
}
},
"additionalProperties": true
},
"FeedbackOutcome": {
"enum": [
"succeeded",
"still_blocked",
"handed_off",
"gave_up"
],
"type": "string",
"title": "FeedbackOutcome",
"description": "D58: what happened on the caller's next attempt after a blocked lookup. \"Not tried\" is never sent: no answer is that."
},
"AhnCheckRedirect": {
"type": "object",
"title": "AhnCheckRedirect",
"required": [
"followed_www",
"to_relation",
"path_class"
],
"properties": {
"path_class": {
"enum": [
"login",
"locale",
"other"
],
"type": "string",
"title": "Path Class"
},
"to_relation": {
"enum": [
"same_host",
"www_alias",
"same_site",
"other_site"
],
"type": "string",
"title": "To Relation"
},
"followed_www": {
"type": "boolean",
"title": "Followed Www"
}
},
"additionalProperties": true
},
"CheckObservation": {
"type": "object",
"title": "CheckObservation",
"required": [
"observed_at",
"attempt_actor",
"attempt_env",
"outcome",
"error_class",
"task_step",
"synthetic"
],
"properties": {
"outcome": {
"$ref": "#/$defs/Outcome"
},
"synthetic": {
"type": "boolean",
"title": "Synthetic"
},
"task_step": {
"type": "string",
"title": "Task Step"
},
"attempt_env": {
"$ref": "#/$defs/AttemptEnv"
},
"error_class": {
"$ref": "#/$defs/ErrorClass"
},
"observed_at": {
"type": "string",
"title": "Observed At",
"format": "date-time"
},
"attempt_actor": {
"$ref": "#/$defs/AttemptActor"
}
},
"additionalProperties": true
},
"McpCatalogServer": {
"type": "object",
"title": "McpCatalogServer",
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Name",
"default": null
},
"card_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Card Url",
"default": null
},
"identifier": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Identifier",
"default": null
},
"inline_card": {
"anyOf": [
{
"type": "boolean",
"const": true
},
{
"type": "null"
}
],
"title": "Inline Card",
"default": null
},
"remote_urls": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Remote Urls",
"default": null
}
},
"additionalProperties": true
},
"ContentUseCompact": {
"type": "object",
"title": "ContentUseCompact",
"required": [
"status",
"source_url",
"freshness"
],
"properties": {
"reason": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Reason",
"default": null
},
"status": {
"enum": [
"none_declared",
"not_read"
],
"type": "string",
"title": "Status"
},
"freshness": {
"enum": [
"fresh",
"stale",
"pending"
],
"type": "string",
"title": "Freshness"
},
"fetched_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Fetched At",
"default": null
},
"source_url": {
"type": "string",
"title": "Source Url"
}
},
"description": "Nothing declared, or the file could not be read: the short shape, without the note and vocabulary strings.",
"additionalProperties": true
},
"AhnCheckBotDefense": {
"type": "object",
"title": "AhnCheckBotDefense",
"required": [
"vendor",
"signal",
"confidence"
],
"properties": {
"signal": {
"enum": [
"header",
"cookie",
"body"
],
"type": "string",
"title": "Signal"
},
"vendor": {
"enum": [
"cloudflare",
"datadome",
"perimeterx",
"aws_waf",
"vercel",
"generic_captcha",
"unknown"
],
"type": "string",
"title": "Vendor"
},
"confidence": {
"enum": [
"high",
"medium"
],
"type": "string",
"title": "Confidence"
}
},
"additionalProperties": true
},
"ContentUseDeclared": {
"type": "object",
"title": "ContentUseDeclared",
"required": [
"status",
"formats",
"vocab",
"source_url",
"freshness",
"note"
],
"properties": {
"note": {
"type": "string",
"title": "Note"
},
"scope": {
"anyOf": [
{
"enum": [
"all_paths",
"path_specific"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Scope",
"default": null
},
"usage": {
"anyOf": [
{
"$ref": "#/$defs/ContentUsage"
},
{
"type": "null"
}
],
"default": null
},
"vocab": {
"type": "string",
"title": "Vocab"
},
"reason": {
"type": "null",
"title": "Reason",
"default": null
},
"status": {
"type": "string",
"const": "declared",
"title": "Status"
},
"formats": {
"type": "array",
"items": {
"enum": [
"cloudflare_content_signal",
"ietf_aipref"
],
"type": "string"
},
"title": "Formats"
},
"signals": {
"anyOf": [
{
"$ref": "#/$defs/ContentSignals"
},
{
"type": "null"
}
],
"default": null
},
"freshness": {
"enum": [
"fresh",
"stale",
"pending"
],
"type": "string",
"title": "Freshness"
},
"fetched_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Fetched At",
"default": null
},
"source_url": {
"type": "string",
"title": "Source Url"
},
"ignored_keys": {
"type": "array",
"items": {
"type": "string"
},
"title": "Ignored Keys"
},
"named_groups": {
"type": "array",
"items": {
"$ref": "#/$defs/ContentUseGroup"
},
"title": "Named Groups"
},
"ai_input_no_agents": {
"type": "array",
"items": {
"type": "string"
},
"title": "Ai Input No Agents"
},
"named_groups_total": {
"type": "integer",
"title": "Named Groups Total",
"default": 0,
"minimum": 0
},
"vendor_default_hint": {
"type": "boolean",
"title": "Vendor Default Hint",
"default": false
},
"ai_input_declared_no": {
"type": "boolean",
"title": "Ai Input Declared No",
"default": false
},
"path_specific_samples": {
"type": "array",
"items": {
"type": "string"
},
"title": "Path Specific Samples"
}
},
"additionalProperties": true
},
"GovernmentRegistry": {
"type": "object",
"title": "GovernmentRegistry",
"required": [
"status",
"registry",
"registry_name",
"list_version",
"source_url",
"license",
"fetched_at"
],
"properties": {
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "State",
"default": null
},
"status": {
"enum": [
"listed",
"not_in_list_version"
],
"type": "string",
"title": "Status"
},
"license": {
"type": "string",
"title": "License"
},
"registry": {
"enum": [
"us_dotgov",
"uk_govuk"
],
"type": "string",
"title": "Registry"
},
"fetched_at": {
"type": "string",
"title": "Fetched At",
"format": "date-time"
},
"source_url": {
"type": "string",
"title": "Source Url"
},
"attribution": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Attribution",
"default": null
},
"domain_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Domain Type",
"default": null
},
"list_version": {
"type": "string",
"title": "List Version"
},
"organization": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Organization",
"default": null
},
"registry_name": {
"type": "string",
"title": "Registry Name"
},
"suborganization": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Suborganization",
"default": null
}
},
"description": "Which public government domain list names this domain, as of which version. A fact about the domain, not a judgement.",
"additionalProperties": true
},
"OfficialStatusPage": {
"type": "object",
"title": "OfficialStatusPage",
"required": [
"source_name",
"source_url"
],
"properties": {
"covers": {
"anyOf": [
{
"type": "string",
"const": "api"
},
{
"type": "null"
}
],
"title": "Covers",
"default": null
},
"source_url": {
"type": "string",
"title": "Source Url"
},
"source_name": {
"type": "string",
"title": "Source Name"
},
"requires_sign_in": {
"anyOf": [
{
"type": "boolean",
"const": true
},
{
"type": "null"
}
],
"title": "Requires Sign In",
"default": null
}
},
"additionalProperties": true
}
},
"title": "CheckResponse",
"required": [
"site_host",
"generated_at",
"synthetic",
"window_hours",
"data_horizon_hours",
"current_site_status",
"evidence_level",
"summary_code",
"summary",
"failures",
"successes",
"reporting_sources",
"observations",
"provider_source_state"
],
"properties": {
"cause": {
"anyOf": [
{
"$ref": "#/$defs/Cause"
},
{
"type": "null"
}
],
"default": null
},
"links": {
"anyOf": [
{
"$ref": "#/$defs/Links"
},
{
"type": "null"
}
],
"default": null
},
"summary": {
"type": "string",
"title": "Summary"
},
"failures": {
"type": "integer",
"title": "Failures",
"minimum": 0
},
"ahn_check": {
"anyOf": [
{
"$ref": "#/$defs/AhnCheck"
},
{
"type": "null"
}
],
"default": null
},
"site_host": {
"type": "string",
"title": "Site Host"
},
"successes": {
"type": "integer",
"title": "Successes",
"minimum": 0
},
"synthetic": {
"type": "boolean",
"title": "Synthetic"
},
"host_facts": {
"anyOf": [
{
"$ref": "#/$defs/HostFacts"
},
{
"type": "null"
}
],
"default": null
},
"next_action": {
"anyOf": [
{
"$ref": "#/$defs/NextAction"
},
{
"type": "null"
}
],
"default": null
},
"next_checks": {
"type": "array",
"items": {
"$ref": "#/$defs/NextCheck"
},
"title": "Next Checks"
},
"generated_at": {
"type": "string",
"title": "Generated At",
"format": "date-time"
},
"observations": {
"type": "array",
"items": {
"$ref": "#/$defs/CheckObservation"
},
"title": "Observations"
},
"summary_code": {
"type": "string",
"title": "Summary Code"
},
"summary_line": {
"anyOf": [
{
"type": "string",
"pattern": "^[ -~]+$",
"maxLength": 401,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Summary Line",
"default": null
},
"window_hours": {
"type": "integer",
"title": "Window Hours",
"maximum": 168,
"minimum": 1
},
"failure_stage": {
"anyOf": [
{
"$ref": "#/$defs/FailureStage"
},
{
"type": "null"
}
],
"default": null
},
"access_profile": {
"anyOf": [
{
"$ref": "#/$defs/AccessProfile"
},
{
"type": "null"
}
],
"default": null
},
"evidence_level": {
"enum": [
"no_reports",
"single_observation",
"multiple_observations",
"later_success_observed",
"stale_reports"
],
"type": "string",
"title": "Evidence Level"
},
"feedback_token": {
"anyOf": [
{
"$ref": "#/$defs/Feedback"
},
{
"type": "null"
}
],
"default": null
},
"official_paths": {
"anyOf": [
{
"$ref": "#/$defs/OfficialPaths"
},
{
"type": "null"
}
],
"default": null
},
"recommendation": {
"anyOf": [
{
"$ref": "#/$defs/Recommendation"
},
{
"type": "null"
}
],
"default": null
},
"lookup_activity": {
"anyOf": [
{
"$ref": "#/$defs/LookupActivity"
},
{
"type": "null"
}
],
"default": null
},
"provider_status": {
"anyOf": [
{
"$ref": "#/$defs/ProviderStatus"
},
{
"type": "null"
}
],
"default": null
},
"reporting_sources": {
"type": "integer",
"title": "Reporting Sources",
"minimum": 0
},
"data_horizon_hours": {
"type": "integer",
"const": 168,
"title": "Data Horizon Hours"
},
"current_site_status": {
"type": "string",
"const": "unknown",
"title": "Current Site Status"
},
"official_status_page": {
"anyOf": [
{
"$ref": "#/$defs/OfficialStatusPage"
},
{
"type": "null"
}
],
"default": null
},
"provider_source_state": {
"enum": [
"feed_connected",
"official_page_only",
"not_verified_by_current_methods"
],
"type": "string",
"title": "Provider Source State"
},
"provider_discovery_attempted_at": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"title": "Provider Discovery Attempted At",
"default": null
}
},
"additionalProperties": true
}check_incident annotations
{
"title": "Check host access profile",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}rate_last_lookup
If an earlier check_incident answer gave you a feedback token and you then tried again, say whether it worked. Sends only the token and the outcome code, no hostname. outcome: succeeded (the next attempt worked), still_blocked, handed_off (you handed the step to the user) or gave_up. path: official_path (you used the official path the answer pointed to), same_site (you retried the same site) or unknown. A token works once and expires one hour after the lookup; do not send one for an attempt you did not make. The outcome is counted anonymously per host and hour and does not change any answer.
rate_last_lookup input schema
{
"type": "object",
"title": "rate_last_lookupArguments",
"required": [
"token",
"outcome"
],
"properties": {
"path": {
"enum": [
"official_path",
"same_site",
"unknown"
],
"type": "string",
"title": "Path",
"default": "unknown"
},
"token": {
"type": "string",
"title": "Token",
"pattern": "^[A-Za-z0-9_-]{16,480}\\.[A-Za-z0-9_-]{43}$",
"maxLength": 530,
"description": "The feedback_token.token value from the check_incident answer, unchanged."
},
"outcome": {
"enum": [
"succeeded",
"still_blocked",
"handed_off",
"gave_up"
],
"type": "string",
"title": "Outcome"
}
}
}rate_last_lookup output schema
{
"type": "object",
"title": "FeedbackReceipt",
"required": [
"accepted"
],
"properties": {
"accepted": {
"type": "boolean",
"const": true,
"title": "Accepted"
}
},
"additionalProperties": true
}rate_last_lookup annotations
{
"title": "Rate the last lookup",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}report_observation
Open-world
Submit one de-identified firsthand observation under your own operating authority and platform rules. Public reports enter private review and are not site-status claims. Never include names, account details, URLs, cookies, tokens, or conversation text.
report_observation input schema
{
"type": "object",
"$defs": {
"Outcome": {
"enum": [
"passed",
"blocked",
"error",
"abandoned"
],
"type": "string",
"title": "Outcome"
},
"AttemptEnv": {
"enum": [
"agent_cloud_browser",
"human_in_agent_browser",
"human_own_browser",
"unknown"
],
"type": "string",
"title": "AttemptEnv"
},
"ErrorClass": {
"enum": [
"site_access",
"login_auth",
"human_verification",
"service_error"
],
"type": "string",
"title": "ErrorClass"
},
"AgentFamily": {
"enum": [
"dots",
"muse",
"other"
],
"type": "string",
"title": "AgentFamily"
},
"AttemptActor": {
"enum": [
"agent",
"human"
],
"type": "string",
"title": "AttemptActor"
},
"ChallengeKind": {
"enum": [
"interactive_check",
"loop",
"block_page",
"unknown",
"none"
],
"type": "string",
"title": "ChallengeKind"
},
"ObservationIn": {
"type": "object",
"title": "ObservationIn",
"required": [
"outcome",
"site_host",
"error_class"
],
"properties": {
"outcome": {
"$ref": "#/$defs/Outcome"
},
"site_host": {
"type": "string",
"title": "Site Host"
},
"synthetic": {
"type": "boolean",
"title": "Synthetic",
"default": false
},
"task_step": {
"type": "string",
"title": "Task Step",
"default": "other"
},
"attempt_env": {
"$ref": "#/$defs/AttemptEnv",
"default": "unknown"
},
"error_class": {
"$ref": "#/$defs/ErrorClass"
},
"observed_at": {
"type": "string",
"title": "Observed At",
"format": "date-time"
},
"agent_family": {
"$ref": "#/$defs/AgentFamily",
"default": "other"
},
"attempt_actor": {
"$ref": "#/$defs/AttemptActor",
"default": "agent"
},
"challenge_kind": {
"$ref": "#/$defs/ChallengeKind",
"default": "none"
},
"schema_version": {
"type": "integer",
"title": "Schema Version",
"default": 1
},
"idempotency_key": {
"type": "string",
"title": "Idempotency Key",
"format": "uuid"
},
"challenge_vendor": {
"$ref": "#/$defs/ChallengeVendor",
"default": "none"
},
"consent_confirmed": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Consent Confirmed",
"default": null
}
},
"additionalProperties": false
},
"ChallengeVendor": {
"enum": [
"cloudflare",
"recaptcha",
"hcaptcha",
"unknown",
"none"
],
"type": "string",
"title": "ChallengeVendor"
}
},
"title": "report_observationArguments",
"required": [
"observation"
],
"properties": {
"observation": {
"$ref": "#/$defs/ObservationIn"
}
}
}report_observation output schema
{
"type": "object",
"title": "Receipt",
"required": [
"observation_id",
"incident_id",
"review_state",
"synthetic"
],
"properties": {
"synthetic": {
"type": "boolean",
"title": "Synthetic"
},
"incident_id": {
"type": "string",
"title": "Incident Id",
"format": "uuid"
},
"review_state": {
"type": "string",
"title": "Review State"
},
"observation_id": {
"type": "string",
"title": "Observation Id",
"format": "uuid"
},
"withdrawal_token": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Withdrawal Token",
"default": null
}
},
"additionalProperties": true
}report_observation annotations
{
"title": "Report an authorized observation",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}Prompts
0 advertised
Resources
0 advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1183 ms
- 95th percentile latency
- 1183 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1183 ms · metadata changed · 3 tool(s), 0 resource(s), 0 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http agent-help-network-mcp https://agenthelpnetwork.com/mcpCodex
Codex configuration
codex mcp add agent-help-network-mcp --url https://agenthelpnetwork.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"agent-help-network-mcp": {
"url": "https://agenthelpnetwork.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"agent-help-network-mcp": {
"type": "streamableHttp",
"url": "https://agenthelpnetwork.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"agent-help-network-mcp": {
"type": "http",
"url": "https://agenthelpnetwork.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http agent-help-network-mcp https://agenthelpnetwork.com/mcpClaude Desktop
Claude Desktop configuration
https://agenthelpnetwork.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"agent-help-network-mcp": {
"serverUrl": "https://agenthelpnetwork.com/mcp"
}
}
}Let your agent find its tools
Find servers like Agent Help Network MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other developer tools servers
Do you run Agent Help Network MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.