
RoamProxy
Fetch pages and build proxy URLs through residential, datacenter and mobile IPs worldwide
- 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-mcpAdd 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

Scrapling MCP Server
MCP serverMCP 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

Firecrawl MCP Server
MCP serverMCP server that lets AI agents search, scrape and interact with web pages
- 3 tools
- Remote
- Freemium
- 7.8K GitHub stars
- Web search and scraping

SearXNG Search
MCP serverMCP 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

NeuralVerge
MCP serverStructured, source-tagged business and people data from 300+ sources for agents
- 200 tools
- Remote
- Free trial
- 1 GitHub star
- Web search and scraping

AI-Powered directory
MCP serverSearch AI tools, agents and MCP servers and get install configs from inside your AI assistant.
- 4 tools
- Remote
- Free
- Developer tools

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce