Skip to content
MCP server

RoamProxy

Fetch pages and build proxy URLs through residential, datacenter and mobile IPs worldwide

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
0.1.1
Listing updated
1 day ago

About RoamProxy

RoamProxy is an open-source MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

Run locally via npx, the server sends requests to RoamProxy's gateway, so a page can be opened from a chosen country, state or city. Every tool accepts country, state, city, session and product, where an unchanged session id keeps the same IP and omitting it rotates. If a city has no stock, the gateway falls back to the state and then the country.

Tools fetch a URL as markdown, text or HTML, build a http or socks5 proxy URL with Playwright config, check the exit IP and ISP, and show wallet balance and usage. The API token only exposes your proxy credentials and account summary and cannot top up or change settings.

The server is MIT licensed and free; traffic is billed to your Roam wallet at $2/GB residential, falling to $1.20/GB with volume top-ups, and $0.80/GB datacenter. Node.js 20 is required.

Install

Run in a terminal

claude mcp add roamproxy-mcp --env ROAM_API_TOKEN='<ROAM_API_TOKEN>' -- npx -y roamproxy-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "roamproxy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "roamproxy-mcp"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "roamproxy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "roamproxy-mcp"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "roamproxy-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "roamproxy-mcp"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "roamproxy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "roamproxy-mcp"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "roamproxy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "roamproxy-mcp"
      ],
      "env": {
        "ROAM_API_TOKEN": "<ROAM_API_TOKEN>"
      }
    }
  }
}

Configuration

  • ROAM_API_TOKENYour RoamProxy API token (member dashboard > Rotating residential > API)Required

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

fetch_url
Fetch a URL through a proxy IP in a chosen location
get_proxy
Build an http or socks5 proxy URL and Playwright config
check_ip
Show exit IP, city, region and ISP
account_status
Wallet balance, prices, usage and static IPs

What it does

Geo-targeted fetch
Open pages from a chosen location.
Proxy URL builder
HTTP or SOCKS5 with Playwright config.
IP check
Verify exit IP and ISP.
Account status
Balance, prices and usage.
Sticky sessions
Keep the same IP.

Good for

  • Compare google.de and google.fr results
  • Check a price from a US city
  • Get a proxy for Playwright
  • Check balance

Pricing

Open source

MIT; residential $2/GB, datacenter $0.80/GB

Prices change. Check roamproxy.com before you buy.

RoamProxy FAQ

Is the server free?

Yes, MIT; traffic is billed.

Is a token needed?

Yes, ROAM_API_TOKEN.

Can it spend my money?

No top-ups.

Where does fetch run?

On your machine.

Is RoamProxy free?

Yes. RoamProxy is open source, so you can use and self-host it for free.

How do I add RoamProxy to Claude Code?

Run this command in your terminal: claude mcp add roamproxy-mcp --env ROAM_API_TOKEN='<ROAM_API_TOKEN>' -- npx -y roamproxy-mcp

What are the best alternatives to RoamProxy?

The closest alternatives to RoamProxy are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

Alternatives to RoamProxy

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools
  6. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce