PDFs, JavaScript pages and ordinary HTML as clean Markdown. Follows robots.txt per RFC 9309.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add url2md --env URL2MD_PRIVATE_KEY='<URL2MD_PRIVATE_KEY>' -- npx -y @url2md-io/mcp~/.codex/config.toml
[mcp_servers.url2md]
command = "npx"
args = ["-y", "@url2md-io/mcp"]
env = { URL2MD_PRIVATE_KEY = "<URL2MD_PRIVATE_KEY>" }
# codex mcp add url2md --env URL2MD_PRIVATE_KEY='<URL2MD_PRIVATE_KEY>' -- npx -y @url2md-io/mcp~/.cursor/mcp.json
{
"mcpServers": {
"url2md": {
"command": "npx",
"args": [
"-y",
"@url2md-io/mcp"
],
"env": {
"URL2MD_PRIVATE_KEY": "<URL2MD_PRIVATE_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"url2md": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@url2md-io/mcp"
],
"env": {
"URL2MD_PRIVATE_KEY": "<URL2MD_PRIVATE_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"url2md": {
"command": "npx",
"args": [
"-y",
"@url2md-io/mcp"
],
"env": {
"URL2MD_PRIVATE_KEY": "<URL2MD_PRIVATE_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"url2md": {
"command": "npx",
"args": [
"-y",
"@url2md-io/mcp"
],
"env": {
"URL2MD_PRIVATE_KEY": "<URL2MD_PRIVATE_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"url2md": {
"command": "npx",
"args": [
"-y",
"@url2md-io/mcp"
],
"env": {
"URL2MD_PRIVATE_KEY": "<URL2MD_PRIVATE_KEY>"
}
}
}
}Remote
claude mcp add --transport http url2md https://url2md.io/mcp~/.codex/config.toml
[mcp_servers.url2md]
url = "https://url2md.io/mcp"
# codex mcp add url2md --url https://url2md.io/mcp~/.cursor/mcp.json
{
"mcpServers": {
"url2md": {
"url": "https://url2md.io/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"url2md": {
"type": "http",
"url": "https://url2md.io/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"url2md": {
"httpUrl": "https://url2md.io/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"url2md": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://url2md.io/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"url2md": {
"url": "https://url2md.io/mcp"
}
}
}Environment variables
URL2MD_PRIVATE_KEY
Replace the placeholders with your own credentials and keep them out of version control.