# RoamProxy

> RoamProxy is an open-source MCP server for web search and scraping. Fetch pages and build proxy URLs through residential, datacenter and mobile IPs worldwide. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://roamproxy.com/mcp
- **Repository:** https://github.com/roamproxy/roamproxy-mcp
- **MCP Registry name:** io.github.roamproxy/roamproxy-mcp
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [Chanroll: YouTube Channel Video Scraper (Official API)](https://ai-powered.com/mcp/chanroll-youtube-channel-video-scraper-official-api): Chanroll: YouTube Channel Video Scraper (Official API) is a paid MCP server for design and media.
- [Vidvett: YouTube Video Details Scraper (Official API)](https://ai-powered.com/mcp/vidvett-youtube-video-details-scraper-official-api): Vidvett: YouTube Video Details Scraper (Official API) is a paid MCP server for design and media.

---
Source: https://ai-powered.com/mcp/roamproxy
