tokenmarkdown-mcp
OfficialThis server provides TokenMarkdown MCP tools for fast, LLM-friendly web page extraction and API credit management.
extract_markdown: Fetches any HTTP/HTTPS URL and converts it to clean, dense Markdown, stripping HTML bloat, cookie banners, tracking scripts, and SVGs to preserve context windows.
Configurable image handling: Optionally include or exclude image links in the extracted Markdown output.
check_quota: Lets you check remaining TokenMarkdown API credits and usage status.
Useful for RAG pipelines, AI agents, and research workflows that need low-latency, token-efficient web content extraction.
Provides an n8n workflow blueprint with a webhook extractor node for automated research agents to fetch web pages and convert them to clean Markdown.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tokenmarkdown-mcp Convert https://stripe.com/docs/api to clean markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
⚡ TokenMarkdown (tokenmarkdown.com)
Sub-150ms Web-to-Markdown Engine & Model Context Protocol (MCP) Server
Engineered for LLM context window efficiency, RAG pipelines, and autonomous AI coding agents.
🧭 The Problem: Prompt Bloat & Token Degradation
When autonomous agents or RAG pipelines scrape the web using Puppeteer, Jina, or Firecrawl, they dump 25,000+ tokens of navigation trees, cookie popups, tracking scripts, and inline SVGs directly into the prompt.
High Cost: $0.08+ per page in Claude 3.5 Sonnet token fees.
Slow Latency: 4 to 8 seconds per scrape.
Context Poisoning: LLMs hallucinate on irrelevant footer links and cookie consent disclaimers.
TokenMarkdown compresses web pages by 95% into dense, clean Markdown in sub-150ms, preserving your context budget and boosting reasoning accuracy.
Related MCP server: AnswerRail MCP Server
⚡ Comparison Benchmark
Feature | Raw HTML / Scrapers | Firecrawl / Jina | TokenMarkdown.com |
Average Latency | 6,200ms | 2,100ms | ⚡ 148ms |
Tokens Consumed | ~28,500 tokens | ~3,200 tokens | 🎯 ~940 tokens (95% Savings) |
Prompt Cost (Sonnet) | $0.0855 / call | $0.0096 / call | 💰 $0.0028 / call |
Zero-SDK URL Proxy | ❌ No | ❌ No | ✅ Yes ( |
Native MCP (Stdio + SSE) | ❌ No | Partial | ✅ Yes ( |
🚀 Quickstart
1. Zero-SDK Terminal / cURL Prefix Proxy
You don't even need an API key for quick testing. Prepend https://tokenmarkdown.com/ to any URL:
curl -s "https://tokenmarkdown.com/https://stripe.com/docs/api"2. Claude Desktop & Cursor IDE Setup (MCP)
Add to your Claude Desktop configuration (claude_desktop_config.json) or Cursor MCP settings.
🎁 Free Sandbox Bonus: Pass
--email you@company.cominargsto instantly double your free sandbox quota from 50 to 100 requests! Zero credit card required.
{
"mcpServers": {
"tokenmarkdown": {
"command": "npx",
"args": ["-y", "@quitegoodproject/tokenmarkdown-mcp", "--email", "you@company.com"]
}
}
}Or run via CLI:
npx -y @quitegoodproject/tokenmarkdown-mcp --email you@company.com3. REST API (POST /v1/extract)
curl -X POST "https://tokenmarkdown.com/v1/extract" \
-H "Authorization: Bearer <TOKENMARKDOWN_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"url": "https://linear.app/blog/rethinking-issue-tracking",
"include_images": false
}'Response:
{
"url": "https://linear.app/blog/rethinking-issue-tracking",
"title": "Rethinking issue tracking — Linear Blog",
"markdown": "# Rethinking issue tracking\n\nMost issue trackers are built as databases...",
"tokens": 820,
"savings_percent": 96.2,
"execution_ms": 142
}📦 1-Click Blueprints for Agencies & Automation
Clay.com Blueprint: Drop-in HTTP enrichment column to cut Clay AI credits by 90%.
n8n Workflow Blueprint: Instant webhook extractor node for automated research agents.
🌐 Server-Side Ingestion Standard: RFC-2602 & AnswerRail
TokenMarkdown is the client-side engine for agents scraping the web. For website owners who want their own sites to be natively ingestible by AI agents without scraping latency:
RFC-2602 Specification: Open Inbound AI Ingestion Protocol (AIP) for context-ceiling preservation and deterministic content negotiation (
Accept: text/markdown).Empirical SaaS Truncation Benchmark: Research report analyzing why 84% of top SaaS applications are truncated at 25,000 tokens by Perplexity and ChatGPT Search.
AnswerRail (Reference Edge Gateway): Deploy RFC-2602 at your Cloudflare Anycast edge in <60s to serve sub-15ms clean Markdown, byte-0 schema tables, and Ed25519 provenance with zero origin code changes.
🏛️ developer suite & Governance
TokenMarkdown is an official developer primitive engineered by The Quite Good Project.
Parent Specification: RFC-2601 Developer Primitives Spec & RFC-2602 AI Ingestion Protocol
Reference Inbound Rail: AnswerRail.com
Companion Tool: TokenEnrich.com (Sub-140ms ~180-Token Firmographics)
📄 License
MIT © 2026 The Quite Good Project.
Available Tools
2 toolscheck_quotaA
Check remaining TokenMarkdown API credits and usage status.
Inputs: no named parameters.
extract_markdownA
Sub-150ms clean web-to-markdown extraction. Strips 95% of HTML bloat, cookie banners, tracking scripts, and SVGs to preserve LLM context windows.
Inputs: url (required), include_images.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: one performs the core extraction, the other monitors usage. There is no possible confusion between them.
Both tool names follow the same verb_noun pattern (extract_markdown, check_quota), creating a predictable and clean naming convention.
With only two tools, the count is slightly under the typical 3-15 range, but it fits the narrow scope of a single-purpose extraction API with quota checking. No unnecessary tools are present.
The tool surface fully covers the service's obvious domain: extracting web content to markdown and checking API quota. There are no missing operations for this focused utility.
Related MCP Connectors
Strips 85-97% of HTML bloat into clean Markdown, <200-token skeletons, or BM25 excerpts via MCP.
Convert any webpage to clean LLM-ready markdown, extraction-first, with article and news modes.
Turn any webpage into clean Markdown for LLM/agent pipelines. Free tier; paid 1 USDC = 1000 req.
Web scraping for AI agents. Converts URLs to clean, LLM-ready Markdown with anti-bot bypass.
Related MCP Servers
- FlicenseBqualityBmaintenanceEnables MCP-compatible AI clients to extract live web content and convert it into structured Markdown for LLM ingestion, RAG pipelines, and agentic workflows.16-
- AlicenseAqualityBmaintenanceEnables auditing URLs for AI crawler readiness, including 25,000-token RAG truncation, /llms.txt discovery, Lighthouse 13.5 ard-schema compliance, and JSON-LD entities, plus generating manifests and clean Byte-0 Markdown inside MCP clients.5699 npmMIT
- FlicenseNot gradedqualityAmaintenanceEnables AI agents and MCP clients to fetch webpages and crawl sites, extract main content, and convert it into clean Markdown with preserved links for fast, token-efficient scraping.-
- AlicenseNot gradedqualityAmaintenanceEnables MCP clients and AI agents to fetch individual webpages or crawl sites and receive clean, link-preserving Markdown with caching and robots.txt-aware rate limiting, reducing token usage for downstream pipelines.MIT