puremd

The puremd MCP server brings web content access and manipulation capabilities to MCP clients by exposing two main tools: unblock-url and search-web. unblock-url fetches a given web page and returns its content rendered as markdown, helping you bypass simple blocks and render dynamic content as markdown for downstream agents. search-web performs a query-based lookup of web results and concatenates them into a single markdown document, enabling concise, readable summaries for LLMs and agents. When you run the MCP server, clients like Cursor, Windsurf, and Claude Desktop can invoke these tools through the MCP interface, using the shared mcpServers configuration to load the pure.md capabilities into your workflow. To use the server, configure your MCP client to point at the pure.md entry (for example, via the provided JSON snippets) and supply an API key if you have one for higher rate limits.

In practice, you’ll set up a client to reference the pure.md MCP server and then call the available tools by name (unblock-url or search-web) with the appropriate parameters. The API key (PUREMD_API_KEY) is optional; leaving it empty enables anonymous usage with lower quotas. For authenticated usage, obtain a token from pure.md, place it in your client’s environment, and the MCP client will apply it when calling the server.

Prerequisites:

• Node.js and npm installed on your machine
• Access to the internet to fetch the MCP server package

Option A: Run via npx (no local install required)

1. Ensure you have Node.js and npm installed.
2. Run the MCP server using npx: npx -y puremd-mcp
3. If you need to pass an API key, set the environment variable PUREMD_API_KEY before launching: PUREMD_API_KEY=<your-token> npx -y puremd-mcp

Option B: Install via Smithery for CLI-based installation (recommended for Claude Desktop integration)

1. Install Smithery CLI if you don’t have it: npm install -g @smithery/cli
2. Install the MCP server for a specific client, e.g., Claude Desktop: npx -y @smithery/cli install @puremd/puremd-mcp --client claude
3. Follow Smithery’s prompts to complete the installation and configure the client with your PUREMD_API_KEY if desired.

Option C: Local development (clone and run from source)

1. Clone the repository (or use the npm package if you have access): npm i puremd-mcp
2. Start the server directly: node path/to/server.js
3. Set PUREMD_API_KEY in the environment if you have a token: PUREMD_API_KEY=<token> node path/to/server.js

Tips and considerations:

• If you don’t have a PUREMD_API_KEY, you can run anonymously but expect lower rate limits.
• The two MCP tools are unblock-url (markdown rendering of web pages) and search-web (web search results concatenated into markdown). Design your MCP client requests to target these commands by name.
• When using Smithery for Claude Desktop, ensure you’ve chosen the correct client (claude) during installation to enable native integration.
• If you encounter issues with long URLs or heavy pages, consider pre-processing the URL or adjusting client timeouts to accommodate rendering delays.
• Keep your PUREMD_API_KEY secure; avoid shipping it in public configs. Use environment variables in your MCP client configuration as shown in the examples.
• If you upgrade the MCP server package, verify compatibility with your MCP client by revalidating the mcpServers configuration in your client files.