PureMD

Unblock, scrape, and search tools for MCP clients

javascript

51

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

Pure.md MCP server enables MCP clients to access and manipulate web content rendered as markdown, providing web unblocking and search capabilities via MCP tooling. It helps agents fetch and convert diverse sources into markdown, with built‑in caching and two practical tools to streamline information retrieval.

How to use

You connect an MCP client to the puremd MCP server by configuring the client to run the server as a local process. The server exposes two built‑in tools you can leverage from your MCP client: unblock-url to extract markdown from web pages without blocks, and search-web to perform web searches and concatenate results into markdown.

How to install

Prerequisites: you need Node.js and npm installed on your system to run MCP clients and execute npm or npx commands.

Install puremd‑mcp for your MCP client using the following command to enable Claude Desktop integration via Smithery:

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

Configure each MCP client to run the puremd MCP server with the API key. Use the provided token value when you have one, or an empty string to use anonymous mode.

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

Below are example client configurations that you can place in your client’s MCP configuration file to connect to the puremd MCP server.

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

Additional notes and security

Authentication is optional. If you prefer anonymous access, set your API key value to an empty string. When an API key is provided, you receive higher rate limits for MCP requests.

The server provides two tools to MCP clients: unblock-url and search-web. Use unblock-url to fetch and render a webpage as markdown, bypassing blocks, and use search-web to query the web and compile the results into a single markdown document.

Available tools

unblock-url

Extract markdown content from web pages while avoiding blocks, enabling clean rendering of dynamic or blocked sources.

search-web

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