Skip to main content

​
Overview

The Web2MD MCP server exposes Web2MD as a set of tools that AI assistants can call directly, using the Model Context Protocol (MCP) — an open standard for connecting AI models to external tools and data sources. Once configured, you can ask Claude, Cursor, or Windsurf to convert pages, search your conversion history, or retrieve saved Markdown without leaving the conversation.
The MCP server requires a Web2MD API key (PRO plan). Generate one from the dashboard.

​
Available tools

The MCP server provides three tools:
ToolDescription
convert_urlConvert any URL to clean Markdown
semantic_searchSearch your saved conversions with natural language
get_conversionRetrieve the full Markdown of a saved conversion by ID

​
convert_url

Fetches a URL and returns the page content as Markdown. Supports the same conversion options as the REST API. Example prompt: “Convert this URL to markdown: https://docs.example.com/getting-started” Searches across all your previously saved conversions using a natural language query. Returns a list of matching conversions with titles, URLs, and relevance scores. Example prompt: “Search my saved pages for articles about database indexing”

​
get_conversion

Retrieves the full Markdown content of a specific saved conversion by its ID. Useful for pulling a complete document into context after finding it with semantic_search. Example prompt: “Get the full content of conversion abc123”

​
Setup

Open your Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the web2md entry under mcpServers:
{
  "mcpServers": {
    "web2md": {
      "command": "npx",
      "args": ["web2md-mcp"],
      "env": {
        "WEB2MD_API_KEY": "w2m_your_key_here"
      }
    }
  }
}
Restart Claude Desktop. You should see the Web2MD tools appear in the tool picker.

​
Usage examples

Once the MCP server is running, you can use natural language in your AI assistant:
You: Convert this URL to markdown: https://react.dev/learn/thinking-in-reactAssistant: (calls convert_url) Here is the converted Markdown for “Thinking in React”…
You: Search my saved pages for anything about authenticationAssistant: (calls semantic_search) I found 3 saved conversions related to authentication:
  1. “OAuth 2.0 Guide” — saved 2 days ago
  2. “JWT Best Practices” — saved last week
  3. …
You: Get the full content of conversion abc123Assistant: (calls get_conversion) Here is the full Markdown content…
Combine tools in a single conversation. For example: “Search my conversions for React docs, then get the full content of the most recent one.”

​
Troubleshooting

Make sure you have restarted the application after editing the configuration file. Verify that npx web2md-mcp runs successfully in your terminal.
Double-check that your WEB2MD_API_KEY is correct and that your PRO subscription is active. You can verify your key on the API keys page.
Try installing the package globally first: npm install -g web2md-mcp, then change the command to web2md-mcp and remove the args field.