Skip to main content
Glama
tokenmarkdown-mcp

tokenmarkdown-mcp

Official

⚡ 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.

License: MIT MCP Part of Quite Good Project npm version


🧭 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 (curl tokenmarkdown.com/https://...)

Native MCP (Stdio + SSE)

❌ No

Partial

✅ Yes (npx -y tokenmarkdown-mcp)


🚀 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.com in args to 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.com

3. 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


🌐 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.


📄 License

MIT © 2026 The Quite Good Project.

Available Tools

2 tools
check_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

    A4.3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: one performs the core extraction, the other monitors usage. There is no possible confusion between them.

    Naming Consistency5/5

    Both tool names follow the same verb_noun pattern (extract_markdown, check_quota), creating a predictable and clean naming convention.

    Tool Count4/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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