Obtén URLs públicas como visitante desde países específicos con recibos Ed25519 firmados para demostrar el origen.
También conocido como regionfetch/regionfetch, mcp, regionfetch-mcp
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.1.1
- Último commit
- 1 sept 2026
- Licencia
- MIT
¿Qué es Region Fetch MCP?
Obtén URLs públicas como visitante desde países específicos con recibos Ed25519 firmados para demostrar el origen.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Region Fetch
Region Fetch ofrece una forma de visualizar URLs públicas HTTPS desde la perspectiva de un visitante en países específicos. Utiliza una única herramienta llamada regionfetch para recuperar contenido web, proporcionando un recibo Ed25519 firmado que demuestra el origen de la solicitud. Este servidor está diseñado para desarrolladores que necesitan verificar cómo se ven los sitios web en diferentes ubicaciones geográficas como US, DE, JP, BR o IN.
El servidor se ejecuta mediante transporte stdio usando Node 20.11 o superior. Los usuarios pueden configurarlo usando npx o mediante variables de entorno. Para un uso continuo, el modo wallet recomendado requiere una REGION_FETCH_WALLET_PRIVATE_KEY y un límite REGION_FETCH_MAX_PAYMENT. Existe un modo de firma estática para pruebas, pero solo permite una única solicitud. La herramienta es compatible con los modos http y browser para la obtención de datos.
Qué puedes hacer con él
- 1Verificar contenido regional de sitios webSolicita una URL específica para ver cómo aparece ante un usuario ubicado en Japón.
- 2Demostrar el origen de la solicitudObtén un recibo firmado para confirmar que los datos fueron recuperados desde un país específico.
- 3Probar la compatibilidad de una sola solicitudRealiza una comprobación de un solo uso utilizando una firma de autorización predefinida.
- 4Validar la integridad de la respuestaComprueba que el cuerpo devuelto coincida con el recibo firmado utilizando el campo de verificación.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Region Fetch MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Region Fetch MCP en Claude Code
$ 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-mcpInstalar Region Fetch MCP en Cursor
~/.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>"
}
}
}
}Instalar Region Fetch MCP en VS Code
.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>"
}
}
}
}Instalar Region Fetch MCP en VS Code CLI
$ 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>"}}'Instalar Region Fetch MCP en Claude Desktop
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>"
}
}
}
}Instalar Region Fetch MCP en Codex
$ 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-mcpInstalar Region Fetch MCP en Codex config.toml
~/.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>"
Instalar Region Fetch MCP en Gemini CLI
$ 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-mcpInstalar Region Fetch MCP en Gemini settings.json
~/.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>"
}
}
}
}Configuración
REGION_FETCH_PAYMENT_SIGNATURESecretoA 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_KEYSecretoPrivate 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.
| Nombre | Descripción | Tipo |
|---|---|---|
| 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. | Secreto |
| 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. | Secreto |
| REGION_FETCH_BASE_URL | Deployment origin. | |
| REGION_FETCH_MAX_PAYMENT | Per-payment ceiling, for example "$0.10". Use "off" to disable the cap. |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleregionfetch/regionfetch is public and reachablegithub.com/regionfetch/regionfetch ↗Aprobado
- El paquete indica este repositorio como su origenregionfetch-mcp names regionfetch/regionfetch as sourcenpmjs.com/package/regionfetch-mcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-09-01github.com/regionfetch/regionfetch ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from regionfetch-mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias117 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubregionfetch-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
Preguntas sobre Region Fetch MCP
¿Cómo agrego Region Fetch MCP a Claude Code?
Ejecuta 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 en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Region Fetch MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Cómo puedo usar el servidor para múltiples solicitudes?
Usa el modo Wallet proporcionando una clave privada de una wallet de Base con fondos en las variables de entorno.
¿Qué países son compatibles para la obtención de datos?
La herramienta actualmente es compatible con US, DE, JP, BR e IN.
¿Puedo usar una única firma de pago para realizar pruebas?
Sí, puedes usar una firma estática para comprobaciones de compatibilidad de un solo uso, pero la segunda llamada a la herramienta fallará.