MCP server
url2md
PDFs, JavaScript pages and ordinary HTML as clean Markdown. Follows robots.txt per RFC…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://url2md.io/mcpInstall 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.