{
"name": "MCP server — Markdown Lane Check",
"what": "Can an agent read your site as markdown? Checks .md twins, /llms.txt, Accept: text/markdown negotiation, /sitemap.md and the alternate-link pointer, each with a verdict and the exact fix. Plus a parser and critic for llms.txt itself. No key, no signup.",
"url": "https://www.pathwren.workers.dev/mcp-markdown.json",
"twin_of": "https://www.pathwren.workers.dev/mcp-markdown.html",
"page": {
"path": "/mcp-markdown.html",
"url": "https://www.pathwren.workers.dev/mcp-markdown.html",
"type": "text/html"
},
"generated_at": "2026-09-06T10:24:27+00:00",
"generated_from": "the bytes of /mcp-markdown.html, by surfaces/ai-crawler-index/build.py, in the same pass that wrote the page — one source, so the page and this document cannot disagree about what this host says.",
"license": {
"document": "CC0-1.0",
"url": "https://creativecommons.org/publicdomain/zero/1.0/"
},
"access": {
"api_key": "none",
"account": "none",
"rate_limit": "none",
"cors": "*",
"auth": "none — every document here is a public GET"
},
"commands": [
"https://www.pathwren.workers.dev/mcp/markdown",
"no auth, read-only, public",
"{",
" \"mcpServers\": {",
" \"markdown-lane-check\": {",
" \"type\": \"streamable-http\",",
" \"url\": \"https://www.pathwren.workers.dev/mcp/markdown\"",
" }",
" }",
"}",
"claude mcp add --transport http markdown-lane-check https://www.pathwren.workers.dev/mcp/markdown",
"curl -s https://www.pathwren.workers.dev/mcp/markdown \\",
" -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \\",
" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"markdown_lane_self_report\",\"arguments\":{}}}' \\",
" | jq -r '.result.content[0].text' | head -3",
"You are calling as: curl/8.7.1",
"From: 203.0.113.7 (CF-Connecting-IP)",
"Our own instrument books that user-agent as: agent.",
"# no arguments, nothing to sign up for: what YOUR client has fetched here, and this host's",
"# own lane in numbers",
"curl -s https://www.pathwren.workers.dev/mcp/markdown \\",
" -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \\",
" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"markdown_lane_self_report\",\"arguments\":{}}}'",
"# your site, the real thing: six checks, each with a verdict and the exact fix",
"curl -s https://www.pathwren.workers.dev/mcp/markdown \\",
" -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \\",
" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"check_markdown_lane\",",
" \"arguments\":{\"url\":\"https://example.com/docs/getting-started\"}}}' \\",
" | jq -r '.result.structuredContent.checks[] | \"\\(.pass)\\t\\(.check)\\t\\(.verdict)\"'"
],
"sections": [
{
"heading": "Markdown Lane Check — MCP server",
"text": [],
"commands": [],
"tables": [],
"links": []
},
{
"heading": "Connect it: one paste, one call",
"text": [
"That is the whole endpoint and those are its terms: Streamable HTTP (MCP), no API key, no account, no OAuth, no session to keep alive, nothing to install. Every tool is read-only, and two of them fetch the URL you name — and both refuse this host, ephemeral tunnels, IP literals and private names before any socket opens.",
"The JSON a connector config wants — Claude Desktop, Cursor, VS Code, Windsurf, Cline, LibreChat, Continue, anything that takes an mcpServers block. Complete as it stands; there is no field to fill in:",
"Claude Code takes one line instead:",
"Then call markdown_lane_self_report first. It takes no arguments at all, so there is nothing to invent and nothing to look up before you can see this server work — the subject of the answer is the request you just sent:",
"Those are the answer's own first three lines. The first two are whatever YOU sent — the sample shows a plain curl from a documentation address — and the third is what this host's own classifier makes of it. The rest of the answer adds which markdown addresses your own client has fetched on this host, and the .md address of every page it took as HTML instead, whether we have seen you here before, and what our robots policy says to your user-agent. Nothing is fetched to answer it, no argument exists. whoami is the second zero-argument call — the same body with the name changed, the one that works unchanged on all seven MCP servers here, and also a plain GET at /tools/whoami — and example is the third: it runs this server's own worked example for real and hands back exactly what a real call returns. All three are safe first calls.",
"An agent that reads your documentation as HTML spends most of its context on your navigation, your cookie banner and your footer. The fix is not a rewrite: it is the same document at a second address, in markdown, plus something that says where it is. Four conventions do that job — llms.txt, the .md twin, Accept: text/markdown, and — and almost every site that adopts one of them stops there, which leaves clients that use the other three where they started."
],
"commands": [
"https://www.pathwren.workers.dev/mcp/markdown",
"no auth, read-only, public",
"{",
" \"mcpServers\": {",
" \"markdown-lane-check\": {",
" \"type\": \"streamable-http\",",
" \"url\": \"https://www.pathwren.workers.dev/mcp/markdown\"",
" }",
" }",
"}",
"claude mcp add --transport http markdown-lane-check https://www.pathwren.workers.dev/mcp/markdown",
"curl -s https://www.pathwren.workers.dev/mcp/markdown \\",
" -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \\",
" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"markdown_lane_self_report\",\"arguments\":{}}}' \\",
" | jq -r '.result.content[0].text' | head -3",
"You are calling as: curl/8.7.1",
"From: 203.0.113.7 (CF-Connecting-IP)",
"Our own instrument books that user-agent as: agent."
],
"tables": [],
"links": [
"/tools/whoami",
"https://llmstxt.org/"
]
},
{
"heading": "Why this server exists: the lane is not hypothetical",
"text": [
"This host publishes every page at a second address with .md appended, and counts what fetches it. In the 24 hours to 2026-09-06-ish, measured from its own request log with our own self-checks excluded, the markdown lane carried 1,220 hits from 276 distinct external client keys — 8.2% of every client key this host saw in the day, and 1,173 of those keys were crawlers. The numbers behind that sentence are published as data, rebuilt every six hours: /data/markdown-lane.json (CC0). This server exists because somebody is walking that lane in volume on the open web, and most sites do not serve it."
],
"commands": [
"# no arguments, nothing to sign up for: what YOUR client has fetched here, and this host's",
"# own lane in numbers",
"curl -s https://www.pathwren.workers.dev/mcp/markdown \\",
" -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \\",
" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"markdown_lane_self_report\",\"arguments\":{}}}'",
"# your site, the real thing: six checks, each with a verdict and the exact fix",
"curl -s https://www.pathwren.workers.dev/mcp/markdown \\",
" -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \\",
" -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"check_markdown_lane\",",
" \"arguments\":{\"url\":\"https://example.com/docs/getting-started\"}}}' \\",
" | jq -r '.result.structuredContent.checks[] | \"\\(.pass)\\t\\(.check)\\t\\(.verdict)\"'"
],
"tables": [],
"links": [
"/data/markdown-lane.json"
]
},
{
"heading": "Tools",
"text": [],
"commands": [],
"tables": [
{
"headers": [
"Tool",
"What it does"
],
"rows": [
[
"check_markdown_lane",
"Reads the markdown lane of a URL you name and returns six verdicts with the exact fix for each: /llms.txt, /llms-full.txt, the .md twin of the page, Accept: text/markdown negotiation on the page itself, /sitemap.md, and whether the page ADVERTISES its twin with or the equivalent Link header. Each check reports served / missing / soft-404 / gated / unreachable — a 200 carrying an HTML 404 page is called out as the trap it is, because a client stores it as content. It makes one GET per check to the host you name, identified as pathwren-markdown-lane-check/1.0, and it refuses its own publisher and every ephemeral hostname before opening a socket. Example: arguments={\"url\":\"https://example.com/\"} returns the six verdicts for that origin."
],
[
"explain_llms_txt",
"Parses an llms.txt — pasted as text, or fetched from a url you name — into its title, blockquote summary, sections and links, and returns findings by severity with the fix for each: no H1, no summary, links that point at HTML instead of the markdown twin, relative links that break when the file is copied into somebody else's index, a sitemap dump wearing an llms.txt name, HTML tags in the body, duplicate targets, and a missing `## Optional` section on a long list. Returns a ready-to-edit skeleton with every answer. Pasted text is parsed in the request and discarded; nothing is stored. Example: arguments={\"url\":\"https://example.com\"} fetches https://example.com/llms.txt and critiques it."
],
[
"whoami",
"Takes no arguments. Safe to call. Deterministic. Touches no third party. Classifies the request you just sent: the user-agent you claim, the address you came from, the class this host's own instrument books you as, whether we have seen you here before and what you fetched, and what this host's robots policy says about you. Every fact comes from the headers on your own request or from a file this host already publishes — nothing is fetched, nothing about you is invented, no argument exists. Example: arguments={} returns your user-agent, your address, the class we book you as and whether we have seen you here before."
],
[
"example",
"Takes no arguments. Safe to call. Deterministic. Touches no third party. Runs this server's own worked example end to end — one of its real tools, on a canned input taken from this host's own published data — 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. No URL of yours is fetched and no third party is touched. Example: arguments={} runs it and returns the real answer."
]
]
}
],
"links": []
},
{
"heading": "The six checks, and what each one is worth",
"text": [
"/llms.txt. The first file an agent asks for. Its absence is a 404 in your log with no name on it — you never learn who wanted it.",
"/llms-full.txt. Optional: the whole corpus in one file, for a client that would rather take one request than forty. Reported as optional, never as a failure.",
"The .md twin. The same page at the same address with .md appended (or .html.md, if your URLs carry .html). No chrome, no nav. This is the check that decides how much of your content survives the trip into a context window.",
"Accept: text/markdown. The only way a client can ask for markdown without knowing your URL conventions. If it negotiates but omits Vary: Accept, a shared cache will hand your markdown to a browser and your HTML to an agent — reported as a warning, with the header to add.",
"/sitemap.md. Discovery. sitemap.xml tells a crawler where your pages are; this tells an agent where the readable copies are.",
"The pointer. in the page, or the equivalent Link: header. A twin nobody can discover is a twin nobody fetches, and this is the check most sites with a markdown lane still fail.",
"Every check reports served, missing, soft-404, gated or unreachable. A 200 carrying an HTML 404 page is called out as the trap it is: it is worse than a 404, because a client stores it as your content and never asks again."
],
"commands": [],
"tables": [],
"links": []
},
{
"heading": "What it will not fetch",
"text": [
"It refuses to fetch this host. Point it at www.pathwren.workers.dev, at a subdomain of it, at an ephemeral tunnel or preview hostname, at an IP literal, at localhost, at a private name, at a URL carrying credentials or at a non-HTTP scheme, and it returns a refusal before any socket is opened. It uses the same guard as agent-discovery-doctor — imported from that server's source, not copied, so the day a new hostname of ours is added it is refused by every fetch tool here at once. A tool that fetches whatever URL a stranger hands it is an SSRF proxy with a friendly description; one published by a host that counts its own arrivals would also be a way to manufacture its own traffic.",
"A full lane check is seven requests to one host — six checks plus the page itself — with a 7-second timeout each and a 256 KB body cap, identified as pathwren-markdown-lane-check/1.0. Your URL is never stored, and text you paste into explain_llms_txt is parsed in the request and discarded."
],
"commands": [],
"tables": [],
"links": [
"/mcp-doctor.html"
]
},
{
"heading": "Every tool answers with no arguments at all",
"text": [
"markdown_lane_self_report, whoami and example take no arguments and make no outbound request whatsoever. example runs explain_llms_txt for real against this server's own reference skeleton, so you can read the shape of an answer before you send anything of yours. The other two tools accept {} as well and answer with their documented worked example, labelled as one."
],
"commands": [],
"tables": [],
"links": []
},
{
"heading": "How is this different from the other six?",
"text": [
"agent-discovery-doctor fetches /llms.txt among twenty well-known documents and reports whether it is served. It never parses it, never looks for a .md twin, never negotiates Accept, and has no idea whether the links inside your llms.txt lead anywhere a model can read. This server does exactly those things and nothing else. No tool name in common with doctor, or with ai-crawler-index, crawler-log-triage, robots-policy-lint, crawler-ip-verifier or mcp-endpoint-lint.",
"Protocol versions 2025-06-18, negotiated per call. server/discover answers for clients on 2026-07-28, initialize for everyone else. Stateless, no key, no session. Everything on this page is also markdown at /mcp-markdown.md, which is the convention the server checks."
],
"commands": [],
"tables": [],
"links": [
"/mcp-doctor.html",
"/mcp.html",
"/mcp-triage.html",
"/mcp-robots.html",
"/mcp-netcheck.html",
"/mcp-lint.html",
"/mcp-markdown.md"
]
}
],
"machine_doors": [
{
"url": "https://www.pathwren.workers.dev/tools/?s=client-dossiers",
"name": "6 keyless GET tools",
"what": "The read-only MCP tools of this host as plain GET endpoints — no JSON-RPC, no key"
},
{
"url": "https://www.pathwren.workers.dev/documents.json",
"name": "documents.json",
"what": "Every document here with its strong ETag and the date its bytes changed"
},
{
"url": "https://www.pathwren.workers.dev/changes",
"name": "changes",
"what": "What moved since your cursor — poll this instead of re-downloading anything"
},
{
"url": "https://www.pathwren.workers.dev/llms.txt",
"name": "llms.txt",
"what": "The whole map in one text file"
},
{
"url": "https://www.pathwren.workers.dev/openapi.json",
"name": "openapi.json",
"what": "Every read endpoint, described formally"
},
{
"url": "https://www.pathwren.workers.dev/.well-known/agent-card.json",
"name": "agent card",
"what": "A2A agent card"
},
{
"url": "https://www.pathwren.workers.dev/mcp",
"name": "mcp",
"what": "MCP over JSON-RPC (POST)"
},
{
"url": "https://www.pathwren.workers.dev/a2a",
"name": "a2a",
"what": "A2A (POST message/send)"
}
],
"links": [
{
"rel": "self",
"href": "https://www.pathwren.workers.dev/mcp-markdown.json",
"type": "application/json"
},
{
"rel": "describes",
"href": "https://www.pathwren.workers.dev/mcp-markdown.html",
"type": "text/html",
"title": "The page this document is the JSON twin of: MCP server — Markdown Lane Check"
},
{
"rel": "changes",
"href": "https://www.pathwren.workers.dev/changes.json?since=121",
"type": "application/json",
"title": "What changed since your cursor — poll this instead of re-downloading this document",
"cursor_param": "since",
"head_cursor": 121,
"min_poll_seconds": 21600,
"how": "Read `cursor` from the response and send it back as `since`. It advances only when something really changed, so an unchanged answer is proof rather than luck — about 2.5 KB, or a 304 with no body if you send back the ETag."
},
{
"rel": "related",
"href": "https://www.pathwren.workers.dev/documents.json",
"type": "application/json",
"title": "Every document here with its ETag and last-modified date"
},
{
"rel": "related",
"href": "https://www.pathwren.workers.dev/data/agents.json",
"type": "application/json",
"title": "Every crawler record in one file"
},
{
"rel": "alternate",
"href": "https://www.pathwren.workers.dev/sitemap.md",
"type": "text/markdown",
"title": "Every page of this host as markdown, in one file",
"how": "Any page also answers as markdown at the same address with `.md` — and at `.mdx`, `.html.md` and `.html.mdx`, which are the same bytes. `Accept: text/markdown` on the page itself returns the same document. The HTML page stays canonical and every mirror says so in a Link header."
},
{
"rel": "service-desc",
"href": "https://www.pathwren.workers.dev/openapi.json",
"type": "application/json",
"title": "Every read endpoint, described formally"
},
{
"rel": "describedby",
"href": "https://www.pathwren.workers.dev/llms.txt",
"type": "text/plain",
"title": "The whole map in one text file"
}
]
}