home / mcp / puremd mcp server

Puremd MCP Server

Provides MCP access to pure.md content, unblocks web pages, and enables markdown-based web search through a configurable MCP server.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "ampcome-mcps-puremd-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "puremd-mcp"
      ],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"
      }
    }
  }
}

The pure.md MCP server lets MCP clients learn how to access web content in markdown form through pure.md, offering web unblocking and search capabilities that render HTML, PDFs, images, and more into markdown. It uses two tools to extract and search content and supports authenticated usage for higher rate limits.

How to use

You connect an MCP client to the pure.md MCP server by configuring a local integration to run the MCP client’s worker that points to the pure.md MCP server. The server exposes two tools you can leverage in your workflows: unblock-url to convert webpages into markdown without blocks, and search-web to query the web and return results as markdown. Your MCP client should reference the server by name pure.md and invoke it using the provided runtime command and environment variable for authentication if you choose to enable higher rate limits.

How to install

Prerequisites: make sure you have Node.js installed on your system. You will use a lightweight MCP runtime invocation with npx to run the server client.

1) Install and run the MCP server client via npx as shown in the configuration snippets.

2) If you want to authenticate, create an API key on the pure.md dashboard and set it in your MCP client configuration as PUREMD_API_KEY. You can leave it empty for anonymous access with lower rate limits.

3) For quick setup, you can use the following example configurations for each MCP client. Copy the snippet that matches your client and insert your API key where indicated.

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

Installing via Smithery

If you want to install puremd-mcp for Claude Desktop automatically via Smithery, run the following command.

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

Available tools

unblock-url

Extract markdown from web pages while avoiding blocks and render into markdown content.

search-web

Search the web for a query and concatenate results into a markdown document.