{"name":"agent-discovery-doctor","title":"Agent Discovery Doctor — MCP server","version":"1.0.0","transport":"streamable-http","transport_docs":"https://www.pathwren.workers.dev/mcp-transport.html","endpoint":"https://www.pathwren.workers.dev/mcp/doctor","protocol_versions":["2026-07-28","2025-11-25","2025-06-18","2025-03-26","2024-11-05"],"stateless":true,"auth":"none — public, read-only, no key, no rate limit","call_this_first":{"tool":"no_arguments_check_this_hosts_own_discovery_documents","takes_arguments":false,"body":{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"no_arguments_check_this_hosts_own_discovery_documents","arguments":{}}},"curl":"curl -s https://www.pathwren.workers.dev/mcp/doctor -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"no_arguments_check_this_hosts_own_discovery_documents\",\"arguments\":{}}}'","answers":"the whole agent-discovery catalogue checked against THIS host — every document this server tracks, whether this host serves it, its size and content type, which ones are missing, and the part only this server can add: the named clients it has watched ask for each file, when, and the status that request took","also":"whoami and example — the two zero-argument calls every server here carries, same empty arguments. no_arguments_check_this_hosts_own_discovery_documents is this server's own: only it answers the whole agent-discovery catalogue checked against THIS host — every document this server tracks, whether this host serves it, its size and content type, which ones are missing, and the part only this server can add: the named clients it has watched ask for each file, when, and the status that request took.","every_other_tool":"Every other tool here accepts {} and answers with its documented worked example. The one exception is check_discovery_documents: an empty call would have to fetch a host you did not name, so it explains itself instead of fetching anyone.","invitation":"Takes no arguments. Safe to call. Deterministic. Touches no third party.","without_json_rpc":"https://www.pathwren.workers.dev/tools/whoami?s=client-dossiers"},"what_it_is":"The discovery documents an origin publishes for agents: which of 22 it serves, which are missing, which answer 200 with an HTML body, who has been observed asking for each one, and what a 404 costs.","different_from":"https://www.pathwren.workers.dev/mcp identifies crawlers and https://www.pathwren.workers.dev/mcp/triage reads access logs. This server is about the files an origin publishes so agents can read it at all — a different subject, different input, no shared tool.","one_tool_fetches":"check_discovery_documents(host) makes one GET per document, identifying itself as agent-discovery-doctor/1.0 (+https://www.pathwren.workers.dev/mcp-doctor.html; on-demand well-known check for an MCP client). It refuses this server's own publisher, ephemeral tunnel hostnames, IP literals and private names BEFORE any request, so it cannot be used to manufacture traffic on the host that runs it. The other four tools take pasted text and fetch nothing.","catalogue":[{"name":"llms.txt","path":"/llms.txt","group":"agent","observed_askers":2},{"name":"llms-full.txt","path":"/llms-full.txt","group":"agent","observed_askers":1},{"name":"agent-card.json","path":"/.well-known/agent-card.json","group":"agent","observed_askers":2},{"name":"agent.json","path":"/.well-known/agent.json","group":"agent","observed_askers":1},{"name":"ai.txt","path":"/ai.txt","group":"agent","observed_askers":1},{"name":"owners.json","path":"/.well-known/owners.json","group":"mcp","observed_askers":3},{"name":"oauth-protected-resource","path":"/.well-known/oauth-protected-resource","group":"mcp","observed_askers":4},{"name":"oauth-authorization-server","path":"/.well-known/oauth-authorization-server","group":"mcp","observed_askers":3},{"name":"mcp.json","path":"/.well-known/mcp.json","group":"mcp","observed_askers":2},{"name":"mcp-registry-auth","path":"/.well-known/mcp-registry-auth","group":"mcp","observed_askers":1},{"name":"glama.json","path":"/.well-known/glama.json","group":"mcp","observed_askers":1},{"name":"apis.json","path":"/apis.json","group":"api","observed_askers":1},{"name":"well-known-apis.json","path":"/.well-known/apis.json","group":"api","observed_askers":1},{"name":"api-catalog","path":"/.well-known/api-catalog","group":"api","observed_askers":1},{"name":"api-onboarding","path":"/.well-known/api-onboarding","group":"api","observed_askers":1},{"name":"ai-plugin.json","path":"/.well-known/ai-plugin.json","group":"api","observed_askers":1},{"name":"openapi.json","path":"/openapi.json","group":"api","observed_askers":3},{"name":"openapi.yaml","path":"/openapi.yaml","group":"api","observed_askers":1},{"name":"swagger.json","path":"/swagger.json","group":"api","observed_askers":1},{"name":"robots.txt","path":"/robots.txt","group":"web","observed_askers":2},{"name":"sitemap.xml","path":"/sitemap.xml","group":"web","observed_askers":1},{"name":"security.txt","path":"/.well-known/security.txt","group":"web","observed_askers":0},{"name":"x402","path":"/.well-known/x402","group":"agent","observed_askers":1}],"tools":[{"name":"no_arguments_check_this_hosts_own_discovery_documents","title":"No arguments: the discovery check this server runs on a host you name, run on this host","description":"TAKES NO ARGUMENTS. POST {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"no_arguments_check_this_hosts_own_discovery_documents\",\"arguments\":{}}} to https://www.pathwren.workers.dev/mcp/doctor — the answer is the whole agent-discovery catalogue checked against THIS host — every document this server tracks, whether this host serves it, its size and content type, which ones are missing, and the part only this server can add: the named clients it has watched ask for each file, when, and the status that request took. There is nothing to fill in: the input schema is literally empty, `arguments: {}` and no `arguments` key at all both work, and the subject is a file this host already publishes, so the answer does not depend on you at all. No key, no account, no OAuth, no session to open first, read-only, and nothing for you to invent. Nothing is fetched to build it — no request leaves this edge, and none is made to you. whoami and example are here too and take nothing either. Every other tool on this server wants a file pasted in; this one wants nothing. The siblings answer one question each under the tool named beside them: /mcp (whoami), /mcp/lint (whoami), /mcp/triage (no_arguments_triage_this_hosts_own_crawler_log), /mcp/robots (no_arguments_lint_this_hosts_robots_txt), /mcp/netcheck (no_arguments_report_the_crawler_ip_ranges_this_host_mirrors), /mcp/markdown (markdown_lane_self_report). Example: the complete call, exactly as written, nothing to fill in — {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"no_arguments_check_this_hosts_own_discovery_documents\",\"arguments\":{}}} returns a present/missing verdict per tracked document with its byte size, the group each belongs to, the score out of the catalogue, and the observed askers per document with the date and status each one got."},{"name":"whoami","title":"Who is calling? — the one call that needs nothing from you","description":"{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"whoami\",\"arguments\":{}}} — POST that to https://www.pathwren.workers.dev/mcp/doctor and the answer is the user-agent you sent, the class this host's own instrument books it as, whether we have logged you here before — and the part only this server can answer: which of the discovery documents this catalogue tracks (llms.txt, the agent card, mcp.json, apis.json, oauth-protected-resource…) a client like yours has been observed asking THIS host for, when, and what status it took. Takes no arguments. Safe to call. Deterministic. Touches no third party. Nothing is fetched to build it: every fact comes from the headers on your own request or from a file this host already publishes. Only this server answers the last part — its five siblings answer one other question each about you, same empty arguments, each under the tool named beside its path: /mcp (whoami), /mcp/lint (whoami), /mcp/triage (no_arguments_triage_this_hosts_own_crawler_log), /mcp/robots (no_arguments_lint_this_hosts_robots_txt), /mcp/netcheck (no_arguments_report_the_crawler_ip_ranges_this_host_mirrors), /mcp/markdown (markdown_lane_self_report) on https://www.pathwren.workers.dev. Example: arguments={} returns your user-agent, your address, the class we book you as, whether we have seen you here before, and which agent-discovery documents this host has watched a client like yours ask for — the dates, and the status each request took."},{"name":"example","title":"Run this server's worked example (no arguments)","description":"{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"example\",\"arguments\":{}}} — POST that exact body to https://www.pathwren.workers.dev/mcp/doctor and you are done: free, read-only, no API key, no account, no consent prompt, nothing for you to invent, and what comes back is this server's own worked example — validate_llms_txt, run for real on a canned input from this host's own data — so you see the exact shape of an answer before you send anything of yours. Takes no arguments. Safe to call. Deterministic. Touches no third party. Runs this server's own worked example end to end — validate_llms_txt on a four-line llms.txt held as a constant in this file: it exercises the H1, the blockquote summary and an H2 link section, which is the whole format — and it fetches nothing, from us or from anyone — and returns exactly the structuredContent a real call returns, not a mock and not a description of one. Use it to see the shape of an answer before you decide what to send. The input is canned from this host's own data; no URL of yours is fetched and no third party is touched. Example: arguments={} runs validate_llms_txt with {\"text\":\"# Site\\n\\n> One line.\\n\\n## Docs\\n\\n- [Guide](https://e.com/g): start here.\"} and returns its real answer."},{"name":"check_discovery_documents","title":"Which discovery documents does this host serve?","description":"FIRST CALL, needs nothing: {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"no_arguments_check_this_hosts_own_discovery_documents\",\"arguments\":{}}} — Probes 22 documents agents and trust indexes ask for — llms.txt, agent card, owners.json, oauth metadata, mcp.json, apis.json, openapi, robots, sitemap — as served, missing, gated or 200-with-HTML soft-404, and says who asks for each missing one. Refuses private, ephemeral and its own hosts. Example: host='example.com'."},{"name":"explain_document","title":"What is this document, and who reads it?","description":"FIRST CALL, needs nothing: {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"no_arguments_check_this_hosts_own_discovery_documents\",\"arguments\":{}}} — One catalogue entry: what the document is for, the named clients observed asking this host for it with dates and the status they took, what a 404 costs, and the spec URL. No argument lists all 22. Example: name='owners.json' names the bot that asks for it twice."},{"name":"validate_llms_txt","title":"Check a pasted llms.txt","description":"FIRST CALL, needs nothing: {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"no_arguments_check_this_hosts_own_discovery_documents\",\"arguments\":{}}} — Checks pasted llms.txt against the format: one H1, a blockquote summary, H2 sections of `- [name](url): notes`. Errors and warnings with line numbers and fixes, plus the parsed links. Text in, nothing fetched. Example: text='# Site' warns it has no summary and no sections."},{"name":"llms_txt_from_sitemap","title":"Draft an llms.txt from a sitemap","description":"FIRST CALL, needs nothing: {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"no_arguments_check_this_hosts_own_discovery_documents\",\"arguments\":{}}} — Paste sitemap.xml, or one URL per line, and get a draft llms.txt: URLs grouped into H2 sections by path, titles from slugs, lastmod kept, and a TODO wherever only you can write the sentence. A sitemap index is reported as one. Example: xml='https://e.com/docs/a\\nhttps://e.com/blog/b'."},{"name":"validate_agent_card","title":"Check a pasted A2A agent card","description":"FIRST CALL, needs nothing: {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"no_arguments_check_this_hosts_own_discovery_documents\",\"arguments\":{}}} — Validates a pasted /.well-known/agent-card.json against the nine fields A2A marks required and each skill's id/name/description/tags, and warns on capabilities declared true that a reader will then try. Example: json='{\"name\":\"a\"}' returns the eight missing fields."}],"resources":[{"uri":"https://www.pathwren.workers.dev/llms.txt","title":"A working llms.txt to copy the shape of"},{"uri":"https://www.pathwren.workers.dev/.well-known/agent-card.json","title":"A working A2A agent card"},{"uri":"https://www.pathwren.workers.dev/.well-known/apis.json","title":"A working apis.json"},{"uri":"https://www.pathwren.workers.dev/changes.json?since=0","title":"What changed since your cursor"}],"instructions":"{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"no_arguments_check_this_hosts_own_discovery_documents\",\"arguments\":{}}}\n\nPOST that exact body to https://www.pathwren.workers.dev/mcp/doctor and it answers with the whole agent-discovery catalogue checked against THIS host — every document this server tracks, whether this host serves it, its size and content type, which ones are missing, and the part only this server can add: the named clients it has watched ask for each file, when, and the status that request took. It is the first call to make here — no key, no account, no OAuth, read-only, and no argument to invent: the tool is named for the fact that it takes none, its input schema is literally empty, and its subject is a file this host already publishes, so the answer is the same for every caller and nothing is fetched to build it.\n\n{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"whoami\",\"arguments\":{}}}\n\nPOST that exact body to https://www.pathwren.workers.dev/mcp/doctor and it answers with the user-agent you sent, the class this host's own instrument books it as, whether we have logged you here before — and the part only this server can answer: which of the discovery documents this catalogue tracks (llms.txt, the agent card, mcp.json, apis.json, oauth-protected-resource…) a client like yours has been observed asking THIS host for, when, and what status it took.\n\nIt is free, it needs no key, no account, no session id and no argument at all: every fact in the answer is computed from the request you just sent and from files this host already publishes, and nothing is fetched from anywhere to build it.\n\nEVERY TOOL HERE IS READ-ONLY AND UNAUTHENTICATED. None of them writes anything anywhere, none is ever refused for want of a credential, and each says so in its own annotations (readOnlyHint true, destructiveHint false; openWorldHint marks the ones that read a URL you name). Each also carries the same call again under its `_meta` as an object, so nothing here has to be read as prose to be used.\n\nONLY THIS SERVER ANSWERS THAT PART. There are seven MCP servers here and they answer one question each about you — one zero-argument call each, no key, no account, no session. The middle column is the tool to name at that URL, because several of them answer under a name of their own; whoami is answered by all seven and is never an error, so one identical body still walks the whole family if you prefer that.\n  https://www.pathwren.workers.dev/mcp/doctor    no_arguments_check_this_hosts_own_discovery_documents        which agent-discovery documents this host has watched a client like yours ask for — the dates, and the status each request took  <- you are here\n  https://www.pathwren.workers.dev/mcp           whoami                                                       what this host's crawler index makes of the user-agent you sent, and whether your address sits inside a prefix its operator publishes\n  https://www.pathwren.workers.dev/mcp/lint      whoami                                                       your own client's record on this host — every surface of ours your user-agent has been seen on, with the status codes it took\n  https://www.pathwren.workers.dev/mcp/triage    no_arguments_triage_this_hosts_own_crawler_log               your own request triaged as one line of an access log, by the same parser and the same index that read a whole file\n  https://www.pathwren.workers.dev/mcp/robots    no_arguments_lint_this_hosts_robots_txt                      what this host's own robots.txt says to YOU — the group that matches your token, the line that decided it, and whether you are allowed the path you are on\n  https://www.pathwren.workers.dev/mcp/netcheck  no_arguments_report_the_crawler_ip_ranges_this_host_mirrors  whether the address you are calling from falls inside a prefix a crawler operator publishes, and which prefix from which source\n  https://www.pathwren.workers.dev/mcp/markdown  markdown_lane_self_report                                    whether your own client has ever taken this host's markdown lane — which .md addresses it fetched, and the markdown address of every page it took as HTML instead\n\nALSO ON THIS SERVER: check_discovery_documents(host) probes the whole catalogue on a host you name; explain_document(name) gives the named clients we have watched ask for one file and what its 404 cost; validate_llms_txt, llms_txt_from_sitemap and validate_agent_card work on text you paste. Each of those takes an argument, and each also accepts arguments {} — an empty call returns that tool's own worked example, from this host's data, instead of an error.\n\nTHE SAME TOOLS ON THE OTHER PROTOCOL, IF YOU SPEAK IT. This server is also an A2A (Agent2Agent) v1.0 agent at https://www.pathwren.workers.dev/a2a/doctor — every tool here is a skill there under the same name, answered by the same function, so the two cannot drift and the deploy is refused if they do. Its Agent Card is https://www.pathwren.workers.dev/a2a/doctor/.well-known/agent-card.json (the legacy agent.json spelling is served too). To invoke it, POST this complete body — no key, no session, no card to read first:\n\n  {\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"message/send\",\"params\":{\"message\":{\"role\":\"ROLE_USER\",\"messageId\":\"1\",\"parts\":[{\"text\":\"{\\\"skill\\\":\\\"example\\\"}\"}]}}}\n\nIt answers with a Task already in state `completed` in the same response, so there is nothing to poll. Every skill on all eight A2A agents of this host as a ready-to-send body: https://www.pathwren.workers.dev/a2a/example.json — and both lanes with both directions in https://www.pathwren.workers.dev/documents.json under `rpc_endpoints`. If you only speak MCP, ignore all of this: everything is already here.","try_it":"curl -s https://www.pathwren.workers.dev/mcp/doctor -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"explain_document\",\"arguments\":{\"name\":\"owners.json\"}}}'","license":"CC0-1.0","independent":true}