Skip to content
MCP server

url2md

PDFs, JavaScript pages and ordinary HTML as clean Markdown. Follows robots.txt per RFC…

Install
Runs
Locally or Remotely
Version
0.1.5
Listing updated
6 days ago

About url2md

url2md is an MCP server. It can run locally on your machine or as a hosted remote server.

PDFs, JavaScript pages and ordinary HTML as clean Markdown. Follows robots.txt per RFC 9309.

Install

Run in a terminal

claude mcp add --transport http mcp https://url2md.io/mcp

Add to Settings → Connectors → Add custom connector

https://url2md.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://url2md.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://url2md.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://url2md.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://url2md.io/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • URL2MD_PRIVATE_KEY_FILEPath to a file holding the 0x-prefixed private key of a wallet with USDC on Base. Preferred over URL2MD_PRIVATE_KEY: a path is not a secret, and a key on a command line is visible to every process on the machine. One of the two key variables is required.
  • URL2MD_PRIVATE_KEYThe key itself: 0x followed by 64 hex characters. Use URL2MD_PRIVATE_KEY_FILE instead where you can. One of the two key variables is required.
  • URL2MD_MAX_PRICE_USDThe most this server will commit for one call, in USD, across every payment round of that call. A tolled page takes two rounds and this ceiling covers both.
  • URL2MD_MAX_SPEND_USDThe most this server will commit in total for as long as the process runs. Restarting resets it.
  • URL2MD_BASE_URLThe url2md deployment to call. Must be https (only a loopback address may be plain http), because this is the origin every 402 is checked against.
  • URL2MD_TIMEOUT_MSHow long to wait for one conversion, in milliseconds. The default covers the service's own worst case: 20 s of fetching plus 55 s of headless render. Do not lower it to 30 s — that is the navigation timeout inside the browser, and on a page that needed a browser your payment has already settled by the time the render starts.

url2md FAQ

How do I add url2md to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://url2md.io/mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers