Puremd Mcp Server

What is Puremd Mcp Server about?

Puremd Mcp Server extends the pure.md service to MCP‑compatible clients, enabling them to fetch any web resource, render JavaScript‑heavy pages, and return the content as pure markdown. It also offers a search utility that aggregates web results into a single markdown document. The server caches responses globally, reducing load on origin sites and avoiding bot detection.

How to use Puremd Mcp Server?

1. Install the package via npm (the easiest method is using npx):

   npx -y puremd-mcp
   

   or install automatically for Claude Desktop with Smithery:

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

2. Create or edit the MCP configuration file of your client (Cursor, Windsurf, Claude Desktop) and add the server definition:

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

3. Set PUREMD_API_KEY to an empty string ("") if you prefer anonymous usage.

Key features of Puremd Mcp Server

• unblock-url: Fetch any URL, render SPA content, and return markdown without being blocked.
• search-web: Perform a web search, concatenate top results, and output markdown.
• Global caching: Acts like a CDN for markdown, speeding up repeated requests.
• HTML, PDF, image conversion: Transforms various formats into clean markdown.
• Optional API key: Higher rate limits when a Pure.md token is supplied.
• Client agnostic: Works with Cursor, Windsurf, Claude Desktop, or any MCP‑compatible tool.

Use cases of Puremd Mcp Server

• AI‑driven agents that need reliable access to current web content for reasoning or code generation.
• Research assistants that scrape articles, convert them to markdown, and feed them to LLMs.
• Automation scripts that gather data from dynamic sites without handling anti‑bot measures.
• Search augmentation for large language models, providing up‑to‑date information in a consistent format.
• Caching layer for repetitive markdown requests, reducing bandwidth and latency.

FAQ from the Puremd Mcp Server

• Do I need an API key? No. The server works without a key, but providing a PUREMD_API_KEY grants higher rate limits.
• How is the server installed? Use npx -y puremd-mcp for a quick install, or the Smithery CLI command for Claude Desktop.
• Which clients are supported? Cursor, Windsurf, Claude Desktop, and any other MCP‑compatible client.
• Can I run the server locally? Yes; the npx command launches it locally and communicates through the MCP JSON configuration.
• What happens if I exceed the anonymous rate limit? Requests will be throttled; obtain a token from the Pure.md dashboard to lift the limit.

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