Agent Help Network

Agent Help Network

English · 한국어

When a web step is blocked (403, login wall, CAPTCHA, 5xx), ask once: what does this host allow agents to do, what is its official path, is it up — and what to do next. Free, read-only, no account. Remote MCP · REST · Claude Code plugin · Python client.

Agent Help Network answers one question for a public hostname: what does this host allow agents to do, what is the official path, and is it up right now — plus any recent observations from other agents. It is meant for an agent whose web step is blocked (access denied, login wall, human verification, service error): instead of retrying blindly or handing the task back to a person sooner than needed, the agent first reads the host's own declared policy and official path. Agents read the answer over REST/OpenAPI or MCP; the human website shows the same answer in English and Korean. Steps that genuinely need a person's confirmation or decision are handed to that person.

Agent Help Network is an independent project. It is not an official service of, and is not affiliated with, endorsed by, or sponsored by, any AI provider or platform, any site it describes, or any provider whose status it links.

Install

Reading is free and needs no account.

claude plugin marketplace add agent-help-network/agent-help-network   # Claude Code plugin (source: plugins/claude-code/ahn)

claude plugin install ahn@agent-help-network pip install ahn-client # Python client (source: clients/python) pip install "ahn-client[langchain]" # or [crewai], [openai-agents], [claude-agent-sdk]: framework adapters

Install in a client: the connect page has setup for the Claude Code plugin, Cursor, the OpenAI Agents SDK, and any other remote MCP client. For Python code (Playwright, Browser Use, plain HTTP) use the read-only ahn-client package from PyPI, which has no dependencies and sends only a hostname and enum codes. From version 0.3.0 it also has optional adapters that add a one-line answer when a web tool fails inside LangChain v1 ([langchain]), CrewAI ([crewai]), the OpenAI Agents SDK ([openai-agents]) or the Claude Agent SDK ([claude-agent-sdk]), and a Browser Use example. None of these is an official OpenAI, Meta, Anthropic, Muse, or dots integration.

Install in your coding agent: remote HTTP server, no account or key. Each client asks you to confirm before saving. Formats are from each vendor's docs: Cursor, VS Code, Cline, Codex.

• Cursor and VS Code one-click buttons: the connect page (GitHub does not render cursor:// or vscode: links, and the vendors document no https redirect for them)
• VS Code, in mcp.json: {"servers": {"agent-help-network": {"type": "http", "url": "https://agenthelpnetwork.com/mcp"}}}
• Cline, in cline_mcp_settings.json: {"mcpServers": {"agent-help-network": {"type": "streamableHttp", "url": "https://agenthelpnetwork.com/mcp"}}}
• Codex, in ~/.codex/config.toml:

[mcp_servers.agent-help-network]

url = "https://agenthelpnetwork.com/mcp"

Plugin demo video: watch the Claude Code plugin work (WebM, 1 min 18 s, with English captions; captions file). GitHub does not play WebM inline, so this opens the file; the same video is embedded on the connect page.

A real response

Send the hostname only — never a URL path, query, credential, or conversation text — and avoid sensitive hostnames.

curl "https://agenthelpnetwork.com/v1/incidents/check?site_host=github.com&error_class=site_access"

A response for github.com, captured from the live service on 2026-10-18 and trimmed to the key fields (summary_line is the current sentence of its row, not the captured text): robots.rules held 22 agent-token entries at capture time (it has one entry per token in AGENT_USER_AGENTS in ahn/access_profile.py, and that table has grown since, so agents_blocked and agents_allowed below list only the tokens known then) and is cut to three here, path-sample lists are cut to at most three entries, and each next_checks entry also carries an English text. robots_detail, llms_detail, crawl_delay, the path samples, sitemaps, wildcard_crawl_delay, read_host, and provider_status.error_detail are shown as a fresh read under the current contract returns them (the profile cached at capture time predated them). summary_line and next_action are the short form: read them first. They are computed after the answer is decided and never change recommendation or next_checks, which stay the verdict (D51; fields in the contract).

{

"site_host": "github.com", "summary_line": "An official developer API is listed with a no-sign-up option (official_paths.access.auth). For API work use it, not page automation; for a task in the user's own account, hand the step to your user.", "next_action": {"do": "use_official_path", "url": "https://docs.github.com/en/rest", "retry_after_seconds": null}, "links": { "feedback": "https://github.com/agent-help-network/agent-help-network/discussions/categories/field-reports", "changelog": "https://github.com/agent-help-network/agent-help-network/blob/main/docs/feedback-changelog.md" }, "current_site_status": "unknown", "evidence_level": "no_reports", "summary_code": "NO_MATCHING_REPORTS_STATUS_UNKNOWN", "observations": [], "recommendation": { "action": "use_official_path", "confidence": "medium", "reasons": ["official_path_available"] }, "access_profile": { "robots_status": "ok", "robots": { "rules": [ {"agent": "ChatGPT-User", "kind": "user_agent", "explicit_group": false, "root_allowed": true, "disallow_count": 162, "crawl_delay": null, "disallow_paths": ["/account-login", "/copilot/", "/copilot/c/"]}, {"agent": "GPTBot", "kind": "training_crawler", "explicit_group": true, "root_allowed": true, "disallow_count": 162, "crawl_delay": 1.0, "disallow_paths": ["/account-login", "/copilot/", "/copilot/c/"]}, {"agent": "Bytespider", "kind": "training_crawler", "explicit_group": true, "root_allowed": false, "disallow_count": 1, "crawl_delay": null, "disallow_paths": ["/"]} ], "wildcard_root_allowed": true, "sitemaps": [], "wildcard_crawl_delay": null, "wildcard_disallow_paths": ["/account-login", "/copilot/", "/copilot/c/"], "agents_blocked": ["Bytespider"], "agents_allowed": ["OAI-SearchBot", "PerplexityBot", "Bingbot", "GPTBot", "ClaudeBot", "anthropic-ai"] }, "robots_detail": "http_200", "llms_txt_status": "present", "llms_detail": "too_large", "read_host": "github.com", "source_urls": {"robots_txt": "https://github.com/robots.txt", "llms_txt": "https://github.com/llms.txt"}, "fetched_at": "2026-10-18T03:53:58.695938Z", "freshness": "fresh" }, "official_paths": { "name": "GitHub", "api_docs": "https://docs.github.com/en/rest", "developer_portal": "https://docs.github.com/", "note": null }, "provider_status": { "source_name": "GitHub Status", "source_url": "https://www.githubstatus.com/", "indicator": "none", "freshness": "fresh", "error_detail": null }, "provider_source_state": "feed_connected", "next_checks": [ {"code": "locate_failure_stage"}, {"code": "robots_allows_agents"}, {"code": "llms_txt_present"}, {"code": "official_path_available"}, {"code": "provider_clear"}, {"code": "reports_unknown"} ] }

Values change over time; call the service rather than copying this example. The full field reference is in the API contract (English).

When to call it

Call it after a web step has failed, not before. Look the host up when a fetch or browser step reports a block or an outage: HTTP 401, 402, 403, 407, 408, 429, 451 or 5xx, a login wall, a human-verification page, a timeout, or a refused connection. A 404 or another plain 4xx is not a block and needs no lookup. Ask once per host; do not poll.

Limits

• It acts only after a failure. A tool that returns the text of a 403 page as an ordinary result is not a failure to the framework, so no adapter sees it: make the tool raise (response.raise_for_status()) or report an error. The Claude Code plugin likewise does not look up a browser step that "succeeds" but shows a block page, or curl run through Bash; use the ahn-lookup skill or the MCP tool by hand.
• A failure that is not a block or an outage (404, 422, a typo in an address) adds nothing, and the run goes on as it would have.
• The answer is declared policy and published sources, not an access guarantee, and no_reports does not mean a site works (see What the answer contains).
• The first lookup of a host can come back with access_profile.freshness: pending: ask once more after retry_after_seconds, do not poll. A subdomain or tenant host answers profile_not_read: look up the apex host.
• It never attempts your task (see What we read and never do).

REST and MCP reference

People can copy the full agent instructions from the Human page and paste them into an agent chat. The public site opens on the agent guide; the Agent | Human switch at the top right leads to the human search page, which shows declared policy, llms.txt, official path, provider status, and observations in that order.

• REST: GET https://agenthelpnetwork.com/v1/incidents/check?site_host= Optional: error_class (site_access, login_auth, human_verification, service_error), failure_stage (before_target_response, response_observed, access_denial_observed, unknown), task_step (send status_check for a pure up/down check; a lookup after a failure should