Puremd Mcp

Puremd Mcp

What is Puremd Mcp about?

Puremd Mcp offers tools that let AI‑driven applications retrieve web content without being blocked, transform it into pure markdown, and cache the results globally. It acts as a markdown delivery network, ensuring that repeated requests for the same resource are served quickly from cache rather than hitting the original site.

How to use Puremd Mcp?

1. Install the package via npm (or Smithery) using npx -y puremd-mcp.
2. Configure your MCP client (Cursor, Windsurf, Claude Desktop, etc.) to invoke the server with the installed command and provide an optional PUREMD_API_KEY for higher rate limits.
3. Run one of the two built‑in commands:
   • unblock-url <url> – fetches the page, renders JavaScript if needed, and returns markdown.
   • search-web <query> – performs a web search, concatenates the top results, and returns them as markdown.
4. The server caches each response, so subsequent identical requests are served instantly.

Key features

• Web unblocking: Bypasses bot detection and renders SPA JavaScript.
• Markdown conversion: Turns HTML, PDFs, images, and other formats into clean markdown.
• Global caching: CDN‑like cache reduces load on origin sites and speeds up repeat queries.
• Search integration: search-web aggregates results into a single markdown document.
• MCP compatible: Works out‑of‑the‑box with Cursor, Windsurf, Claude Desktop, and any MCP‑enabled client.
• Optional API key: Supply PUREMD_API_KEY for increased rate limits; otherwise operates anonymously.

Use cases

• Agent‑driven web research: Enable custom AI agents to fetch and process up‑to‑date web information without hitting rate limits.
• Content summarisation: Retrieve articles, PDFs, or documentation and feed markdown directly into LLM prompts.
• Data enrichment: Augment AI‑generated outputs with live web data while keeping a consistent markdown format.
• Caching heavy queries: Reduce latency for frequently accessed resources in collaborative AI tools.

FAQ

Do I need an API key? No. The service works anonymously, but providing a key raises rate limits. What formats are supported? HTML pages, SPAs (via JS rendering), PDFs, images, and any content that can be rendered to markdown. How is caching handled? Responses are stored globally; identical future requests are served from cache instantly. Can I use this with other MCP clients? Yes, any client that can invoke an MCP server with a command line interface. Is there a CLI only? The primary interface is through the two CLI commands (unblock-url and search-web), which can be invoked by any MCP‑compatible client.

pure.md MCP server

Welcome to the Model Context Protocol (MCP) server for pure.md.

pure.md lets your scripts, APIs, apps, agents, etc reliably access web content in markdown format -- simply prefix any URL with pure.md/. It avoids bot detection and renders JavaScript for SPAs, and can convert HTML, PDFs, images, and more into pure markdown. Like a CDN for markdown content, it globally caches responses for future requests to the same resource, relieving stress on origin web servers.

Without puremd-mcp, local agents may fail to fetch web content. puremd-mcp teaches MCP clients like Cursor, Windsurf, and Claude Desktop how to adopt the functionality of pure.md, giving them web unblocking and searching capabilities.

puremd-mcp comes with two tools:

• unblock-url - Extract markdown from web pages without getting blocked
• search-web - Search the web for a query and concatenate results into markdown

The Model Context Protocol, developed by Anthropic, is an open standard that enables AI systems to seamlessly interact with an ecosystem of tooling. With it, MCP clients like Cursor, Windsurf, and Claude Desktop can learn how to use a variety of APIs and other functionality.

Authentication

Generating an API key is an optional step that unlocks higher rate limits. If you'd like to use the pure.md MCP server anonymously, simply set your PUREMD_API_KEY value to empty string ("").

1. Sign up for a new account at pure.md — it's free to sign up!
2. In the dashboard, generate a new API token
3. Copy the token, and use it for the PUREMD_API_KEY value in your MCP client's configuration file (see below)

Client configuration

Cursor

Add the following to your ~/.cursor/mcp.json file:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

Windsurf

Add the following to your ./codeium/windsurf/model_config.json file:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

Claude Desktop

Add the following to your ~/Library/Application\ Support/Claude/claude_desktop_config.json file:

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

Installing via Smithery

To install puremd-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @puremd/puremd-mcp --client claude