Ermöglicht es AI Agents, das Web über Residential-, Datacenter- und Mobile-Proxy-IPs in über 190 Ländern zu durchsuchen.
Auch bekannt als roamproxy/roamproxy-mcp, roamproxy-mcp
- Stars
- 0
- Tools
- 4
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.1
- Letzter Commit
- 10. Okt. 2026
- Lizenz
- MIT
Was ist RoamProxy MCP?
Ermöglicht es AI Agents, das Web über Residential-, Datacenter- und Mobile-Proxy-IPs in über 190 Ländern zu durchsuchen. Er stellt 4 Tools bereit, etwa fetch_url, get_proxy, check_ip.
Zusammenfassung generiert aus dem README des Projekts
Über RoamProxy MCP server
RoamProxy gibt AI Agents die Möglichkeit, das Internet über Residential-, Datacenter- und Mobile-IP-Adressen in mehr als 190 Ländern zu durchsuchen. Dieser MCP server verbindet Clients wie Claude, Cursor, Windsurf und VS Code mit dem RoamProxy Gateway, sodass Modelle auf Webinhalte aus spezifischen geografischen Standorten zugreifen können. Nutzer müssen einen RoamProxy API Token über Umgebungsvariablen bereitstellen, um ihr Konto zu authentifizieren und auf die Proxy-Services zuzugreifen.
Der Server enthält spezifische Tools für die Web-Interaktion und das Account-Management. Das Tool fetch_url ruft Website-Inhalte als Markdown, Text oder HTML über ein ausgewähltes Land, einen State oder eine Stadt ab. Das Tool get_proxy generiert einsatzbereite HTTP- oder SOCKS5-URLs, inklusive Playwright-Konfigurationen. Nutzer können außerdem check_ip verwenden, um ihren Exit-Standort und ISP zu verifizieren, oder account_status, um Wallet-Guthaben und Nutzungsstatistiken zu überwachen. Die Traffic-Kosten werden basierend auf dem Datenverbrauch direkt über das RoamProxy Wallet des Nutzers abgerechnet.
Was du damit machen kannst
- 1Lokalisierte Web Scraping-AufgabenFordere einen Agenten auf, eine spezifische Produktseite über eine Residential-IP aus einer bestimmten Stadt zu besuchen, um Preise zu prüfen.
- 2Grenzüberschreitender SuchvergleichLass eine KI Suchmaschinenergebnisse aus verschiedenen Ländern vergleichen, um regionale Unterschiede zu sehen.
- 3Automatisierte Browser-KonfigurationGeneriere eine spezifische Proxy-URL und Konfiguration für die Nutzung mit Playwright Testing-Tools.
- 4Account- und NutzungsüberwachungPrüfe das verbleibende Guthaben in deinem Proxy-Account, um deine Datenausgaben zu verwalten.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du RoamProxy MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenRoamProxy MCP in Claude Code installieren
$ claude mcp add --env 'ROAM_API_TOKEN=<YOUR_ROAM_API_TOKEN>' roamproxy-mcp -- npx -y roamproxy-mcpRoamProxy MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"roamproxy-mcp": {
"command": "npx",
"args": [
"-y",
"roamproxy-mcp"
],
"env": {
"ROAM_API_TOKEN": "<YOUR_ROAM_API_TOKEN>"
}
}
}
}RoamProxy MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"roamproxy-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"roamproxy-mcp"
],
"env": {
"ROAM_API_TOKEN": "<YOUR_ROAM_API_TOKEN>"
}
}
}
}RoamProxy MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"roamproxy-mcp","type":"stdio","command":"npx","args":["-y","roamproxy-mcp"],"env":{"ROAM_API_TOKEN":"<YOUR_ROAM_API_TOKEN>"}}'RoamProxy MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"roamproxy-mcp": {
"command": "npx",
"args": [
"-y",
"roamproxy-mcp"
],
"env": {
"ROAM_API_TOKEN": "<YOUR_ROAM_API_TOKEN>"
}
}
}
}RoamProxy MCP in Codex installieren
$ codex mcp add roamproxy-mcp --env 'ROAM_API_TOKEN=<YOUR_ROAM_API_TOKEN>' -- npx -y roamproxy-mcpRoamProxy MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.roamproxy-mcp] command = "npx" args = ["-y", "roamproxy-mcp"] [mcp_servers.roamproxy-mcp.env] ROAM_API_TOKEN = "<YOUR_ROAM_API_TOKEN>"
RoamProxy MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'ROAM_API_TOKEN=<YOUR_ROAM_API_TOKEN>' roamproxy-mcp npx -- -y roamproxy-mcpRoamProxy MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"roamproxy-mcp": {
"command": "npx",
"args": [
"-y",
"roamproxy-mcp"
],
"env": {
"ROAM_API_TOKEN": "<YOUR_ROAM_API_TOKEN>"
}
}
}
}RoamProxy MCP tools 4
Erkannt aus dem READMEfetch_urlget_proxycheck_ipaccount_status
| fetch_url | — | |
| get_proxy | — | |
| check_ip | — | |
| account_status | — |
Konfiguration
ROAM_API_TOKENErforderlichSecretYour RoamProxy API token (member dashboard > Rotating residential > API)
| Name | Beschreibung | Typ |
|---|---|---|
| ROAM_API_TOKEN | Your RoamProxy API token (member dashboard > Rotating residential > API) | ErforderlichSecret |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarroamproxy/roamproxy-mcp is public and reachablegithub.com/roamproxy/roamproxy-mcp ↗Bestanden
- Paket nennt dieses Repository als Quelleroamproxy-mcp names roamproxy/roamproxy-mcp as sourcenpmjs.com/package/roamproxy-mcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for roamproxy-mcpnpmjs.com/package/roamproxy-mcp/v/0.1.1#provenance ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-10github.com/roamproxy/roamproxy-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from roamproxy-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten102 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenRoamProxy MCP Server
An MCP server that lets AI agents (Claude, Cursor, VS Code, Windsurf, …) browse the web through RoamProxy residential, datacenter and mobile IPs in 190+ countries.
Ask your agent things like:
- "Open this product page from a US residential IP in Los Angeles and summarise the price."
- "Compare what google.de and google.fr show for 'running shoes'."
- "Give me a sticky UK proxy for Playwright."
- "How much balance is left on my RoamProxy account?"
Tools
| Tool | What it does |
|---|---|
fetch_url |
Fetch a URL through a proxy IP in the chosen country / state / city. Returns status + body as markdown, text or HTML. |
get_proxy |
Build a ready-to-use http:// or socks5:// proxy URL (plus Playwright config) for any geo, rotating or sticky. |
check_ip |
Show the exit IP, city, region and ISP for a geo/session, to verify targeting. |
account_status |
Wallet balance, per-GB prices, last 7 days of usage, rented static IPs. |
Geo options on every tool: country (us, de, jp…), state (ca, ny… or full US state names), city (Los Angeles), session (same id = same IP; omit to rotate), product (residential default, datacenter, mobile).
Setup
- Create an account at roamproxy.com and copy your API token from the member dashboard (Rotating residential page, API section).
- Add the server to your client. Requires Node.js 20+.
Claude Code
claude mcp add roamproxy -e ROAM_API_TOKEN=your_token -- npx -y roamproxy-mcp
Claude Desktop / Cursor / Windsurf (claude_desktop_config.json, ~/.cursor/mcp.json, …)
{
"mcpServers": {
"roamproxy": {
"command": "npx",
"args": ["-y", "roamproxy-mcp"],
"env": { "ROAM_API_TOKEN": "your_token" }
}
}
}
VS Code (.vscode/mcp.json)
{
"servers": {
"roamproxy": {
"command": "npx",
"args": ["-y", "roamproxy-mcp"],
"env": { "ROAM_API_TOKEN": "your_token" }
}
}
}
Pricing
Traffic is billed to your RoamProxy wallet exactly as if you used the proxy directly — the MCP server itself is free and open source. Residential $2/GB (down to $1.20/GB with volume top-ups), datacenter $0.80/GB, balance never expires. See pricing.
How it works
fetch_url runs on your machine: the request goes to the RoamProxy gateway (gw.roamproxy.com:41080) and leaves from a residential IP in the location you asked for. Your token only unlocks your own proxy credentials and account info — it cannot top up, buy or change anything.
If a city has no stock the gateway falls back to the state, then the country, instead of failing; check_ip shows where you actually landed.
Development
npm install
npm test # offline unit tests
ROAM_API_TOKEN=... node test/e2e.mjs # live check, uses a little traffic
Related
- proxy-examples — code samples for Python, Node, Go, curl
- roamproxy-python — Python SDK
- proxyprobe — proxy checker CLI
MIT © Goldkeep Digital LLC
RoamProxy MCP Fragen
Wie füge ich RoamProxy MCP zu Claude Code hinzu?
Führe claude mcp add --env 'ROAM_API_TOKEN=<YOUR_ROAM_API_TOKEN>' roamproxy-mcp -- npx -y roamproxy-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich RoamProxy MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet RoamProxy MCP?
Er stellt 4 Tools bereit, darunter fetch_url, get_proxy, check_ip, account_status.
Wie viel kostet der MCP server?
Der MCP server ist kostenlos und Open Source, aber der Traffic wird zu Standardtarifen über dein RoamProxy Wallet abgerechnet.
Was passiert, wenn eine bestimmte Stadt nicht verfügbar ist?
Wenn für eine Stadt kein Bestand verfügbar ist, fällt das Gateway automatisch auf die State- oder Country-Ebene zurück, anstatt den Vorgang abzubrechen.