Rufe öffentliche URLs als Besucher aus bestimmten Ländern mit signierten Ed25519-Belegen ab, um den Ursprung zu beweisen.
Auch bekannt als regionfetch/regionfetch, mcp, regionfetch-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.1
- Letzter Commit
- 1. Sept. 2026
- Lizenz
- MIT
Was ist Region Fetch MCP?
Rufe öffentliche URLs als Besucher aus bestimmten Ländern mit signierten Ed25519-Belegen ab, um den Ursprung zu beweisen.
Zusammenfassung generiert aus dem README des Projekts
Über Region Fetch MCP server
Region Fetch bietet eine Möglichkeit, öffentliche HTTPS-URLs aus der Perspektive eines Besuchers in bestimmten Ländern anzuzeigen. Es nutzt ein einzelnes Tool namens regionfetch, um Web-Inhalte abzurufen und gleichzeitig einen signierten Ed25519-Beleg bereitzustellen, der den Ursprung der Anfrage beweist. Dieser Server ist für Entwickler konzipiert, die verifizieren müssen, wie Websites in verschiedenen geografischen Regionen wie den USA, DE, JP, BR oder IN erscheinen.
Der Server läuft über den stdio-Transport mit Node 20.11 oder höher. Nutzer können ihn über npx oder durch Konfigurieren von Umgebungsvariablen einrichten. Für die kontinuierliche Nutzung erfordert der empfohlene Wallet-Modus einen REGION_FETCH_WALLET_PRIVATE_KEY und ein REGION_FETCH_MAX_PAYMENT Limit. Ein statischer Signatur-Modus ist zum Testen verfügbar, erlaubt aber nur eine einzige Anfrage. Das Tool unterstützt sowohl http- als auch Browser-Modi zum Abrufen von Daten.
Was du damit machen kannst
- 1Regionale Website-Inhalte verifizierenFordere eine spezifische URL an, um zu sehen, wie sie einem Nutzer in Japan angezeigt wird.
- 2Anfrageursprung beweisenErhalte einen signierten Beleg, um zu bestätigen, dass die Daten aus einem bestimmten Land abgerufen wurden.
- 3Kompatibilität einzelner Anfragen testenFühre eine einmalige Prüfung mit einer einzigen, vorgefertigten Autorisierungs-Signatur durch.
- 4Antwort-Integrität validierenPrüfe mithilfe des Verification-Feldes, ob der zurückgegebene Body mit dem signierten Beleg übereinstimmt.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Region Fetch MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenRegion Fetch MCP in Claude Code installieren
$ claude mcp add --env 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' --env 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' mcp -- npx -y regionfetch-mcpRegion Fetch MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Region Fetch MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Region Fetch MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","regionfetch-mcp"],"env":{"REGION_FETCH_PAYMENT_SIGNATURE":"<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>","REGION_FETCH_WALLET_PRIVATE_KEY":"<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"}}'Region Fetch MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Region Fetch MCP in Codex installieren
$ codex mcp add mcp --env 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' --env 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' -- npx -y regionfetch-mcpRegion Fetch MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "regionfetch-mcp"] [mcp_servers.mcp.env] REGION_FETCH_PAYMENT_SIGNATURE = "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>" REGION_FETCH_WALLET_PRIVATE_KEY = "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
Region Fetch MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' -e 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' mcp npx -- -y regionfetch-mcpRegion Fetch MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"regionfetch-mcp"
],
"env": {
"REGION_FETCH_PAYMENT_SIGNATURE": "<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>",
"REGION_FETCH_WALLET_PRIVATE_KEY": "<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>"
}
}
}
}Konfiguration
REGION_FETCH_PAYMENT_SIGNATURESecretA single pre-made x402 authorization. Funds exactly one request, so this is for one-shot testing only; prefer the wallet key.
REGION_FETCH_WALLET_PRIVATE_KEYSecretPrivate key of a funded Base wallet. The server signs one fresh x402 authorization per tool call. Keep it in the host's env block; it is never a tool argument.
REGION_FETCH_BASE_URLDeployment origin.
REGION_FETCH_MAX_PAYMENTPer-payment ceiling, for example "$0.10". Use "off" to disable the cap.
| Name | Beschreibung | Typ |
|---|---|---|
| REGION_FETCH_PAYMENT_SIGNATURE | A single pre-made x402 authorization. Funds exactly one request, so this is for one-shot testing only; prefer the wallet key. | Secret |
| REGION_FETCH_WALLET_PRIVATE_KEY | Private key of a funded Base wallet. The server signs one fresh x402 authorization per tool call. Keep it in the host's env block; it is never a tool argument. | Secret |
| REGION_FETCH_BASE_URL | Deployment origin. | |
| REGION_FETCH_MAX_PAYMENT | Per-payment ceiling, for example "$0.10". Use "off" to disable the cap. |
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 erreichbarregionfetch/regionfetch is public and reachablegithub.com/regionfetch/regionfetch ↗Bestanden
- Paket nennt dieses Repository als Quelleregionfetch-mcp names regionfetch/regionfetch as sourcenpmjs.com/package/regionfetch-mcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-09-01github.com/regionfetch/regionfetch ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from regionfetch-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten117 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenregionfetch-mcp
MCP server for Region Fetch — fetch a public HTTPS URL as a visitor in a specific country would see it, with a signed Ed25519 receipt proving where the retrieval came from.
Pre-release. Not yet published to npm. Build from source: https://github.com/regionfetch/regionfetch
npx -y regionfetch-mcp
Node 20.11+. stdio transport. Exposes exactly one tool: regionfetch.
Configuration
Wallet mode (recommended)
{
"mcpServers": {
"regionfetch": {
"command": "npx",
"args": ["-y", "regionfetch-mcp"],
"env": {
"REGION_FETCH_BASE_URL": "https://regionfetch.dev",
"REGION_FETCH_WALLET_PRIVATE_KEY": "0x...",
"REGION_FETCH_MAX_PAYMENT": "$0.10"
}
}
}
}
The server signs one fresh x402 authorization per tool call. This is the only configuration that keeps working past the first request.
Static signature (testing only)
"env": { "REGION_FETCH_PAYMENT_SIGNATURE": "<one x402 authorization>" }
One authorization funds one request, so the second tool call will fail. The server says so on stderr at startup. Useful for a one-shot compatibility check, not for a running server.
Wallet mode wins when both are configured.
Environment variables
| Variable | Default | Purpose |
|---|---|---|
REGION_FETCH_BASE_URL |
https://regionfetch.dev |
Deployment origin. A trailing /api is stripped. |
REGION_FETCH_WALLET_PRIVATE_KEY |
— | Funded Base wallet key. Enables wallet mode. |
REGION_FETCH_MAX_PAYMENT |
$0.10 |
Per-payment ceiling. off disables it. |
REGION_FETCH_PAYMENT_SIGNATURE |
— | A single pre-made authorization. |
REGION_FETCH_RPC_URL |
— | RPC endpoint for on-chain reads during payment construction. |
REGION_FETCH_TIMEOUT_MS |
120000 |
Per-request timeout. |
REGION_FETCH_ALLOW_INSECURE_HTTP |
0 |
Permit an http:// base URL. Development only. |
Legacy GEOFETCH_BASE_URL, GEOFETCH_PAYMENT_SIGNATURE, and PAYMENT_SIGNATURE
are still read, with the canonical names taking precedence. Their use is
reported as deprecated on stderr.
The tool
regionfetch — url (https, ≤ 2048 chars), country
(US | DE | JP | BR | IN), mode (http | browser, default http).
Results use the v1 envelope:
{
"status": 200,
"ok": true,
"response": { "data": { "...": "..." }, "receipt": { "...": "..." } },
"verification": { "valid": true, "signatureValid": true, "bodyHashMatches": true }
}
verification is an additive field: the server verifies each receipt against the
deployment's published key and the returned body before handing it to the model.
Consumers reading only status, ok, and response are unaffected.
Non-2xx responses keep the upstream status and JSON body verbatim and set
isError: true. Terminal paid failures (502, 504) keep their signed
receipts — they are the evidence the paid attempt happened.
Security
- Wallet keys and payment authorizations are never accepted as tool arguments, never written to stdout or stderr, and never returned in tool output.
- stdout carries JSON-RPC only; all diagnostics go to stderr through a redacting logger. Tests assert both.
- Only the
toolscapability is advertised. No resources, prompts, or subscriptions are implemented or claimed.
Full documentation: https://github.com/regionfetch/regionfetch
MIT
Region Fetch MCP Fragen
Wie füge ich Region Fetch MCP zu Claude Code hinzu?
Führe claude mcp add --env 'REGION_FETCH_PAYMENT_SIGNATURE=<YOUR_REGION_FETCH_PAYMENT_SIGNATURE>' --env 'REGION_FETCH_WALLET_PRIVATE_KEY=<YOUR_REGION_FETCH_WALLET_PRIVATE_KEY>' mcp -- npx -y regionfetch-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Region Fetch MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie kann ich den Server für mehrere Anfragen nutzen?
Nutze den Wallet-Modus, indem du einen gefüllten Base-Wallet-Private-Key in den Umgebungsvariablen angibst.
Welche Länder werden beim Abrufen unterstützt?
Das Tool unterstützt derzeit die USA, DE, JP, BR und IN.
Kann ich eine einzelne Zahlungs-Signatur zum Testen verwenden?
Ja, du kannst eine statische Signatur für einmalige Kompatibilitätsprüfungen verwenden, aber der zweite Tool-Aufruf wird fehlschlagen.