mcp-gauge

Datos del gobierno de EE. UU. (USGS/NOAA/SEC/FDA) con prueba criptográfica; pago por llamada x402, sin clave API

Documentación

mcp-gauge — Hechos verificables para agentes de IA, pago por llamada vía x402

Verifica hechos oficiales antes de que tu agente de IA actúe. Más de 180 señales de USGS, NOAA, SEC EDGAR, EPA y más — cada respuesta incluye validación cruzada de múltiples fuentes y un recibo a prueba de manipulación anclado a Bitcoin mediante OpenTimestamps (lo que demuestra que el conjunto de registros existía a más tardar en el momento del sellado, no que fue recopilado en el día de los datos). Sin clave API, sin registro. Paga por llamada en USDC en Base vía x402.

Inicio rápido

Claude Desktop

Agrega a tu configuración (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "mcpServers": {
    "gauge": {
      "command": "npx",
      "args": ["-y", "mcp-gauge-x402"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."   // optional — omit for free tools only
      }
    }
  }
}

Cursor

Agrega a .cursor/mcp.json en la raíz de tu proyecto (o configuración global):

{
  "mcpServers": {
    "gauge": {
      "command": "npx",
      "args": ["-y", "mcp-gauge-x402"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."   // optional — omit for free tools only
      }
    }
  }
}

Claude Code

claude mcp add gauge -- npx -y mcp-gauge-x402
# For paid tools, add the env:
claude mcp add gauge --env EVM_PRIVATE_KEY=0x... -- npx -y mcp-gauge-x402

Otros hosts MCP

Cualquier cliente MCP que admita transporte stdio funciona. Comando: npx -y mcp-gauge-x402, establece EVM_PRIVATE_KEY en el entorno para herramientas de pago.

Alternativa: instalar desde GitHub (sin necesidad de cuenta npm):
npx -y github:CHANGCHINFU/mcp-gauge

Desde el código fuente

git clone https://github.com/CHANGCHINFU/mcp-gauge && cd mcp-gauge
npm install && npm run build
node dist/index.js

Configuración de pago

	Sin `EVM_PRIVATE_KEY`	Con `EVM_PRIVATE_KEY`
Herramientas gratuitas	Sí	Sí
Herramientas de pago	No (las herramientas son visibles pero las llamadas fallan)	Sí (pago automático vía x402)

Cómo funciona: Cuando tu agente llama a una herramienta de pago, el servidor GAUGE devuelve un desafío de pago x402. El cliente MCP paga automáticamente en USDC en Base (EIP-3009 sin gas — no se necesita ETH) y reintenta la solicitud. El recibo se incluye en cada respuesta.

Seguridad de la billetera:

Usa una billetera desechable dedicada con un saldo pequeño de USDC — nunca tu billetera principal
La clave privada nunca sale de tu máquina (se procesa localmente mediante x402-fetch)
Fondea con solo el USDC suficiente para tu uso esperado
Red: Base mainnet (L2 de Coinbase)

Herramientas

Gratuitas (sin necesidad de billetera)

Herramienta	Qué hace
`gauge_catalog`	Explora más de 180 señales disponibles
`gauge_preview`	Cobertura, menú de precios, contenido de paquetes
`gauge_sample`	Registro de muestra completo con recibo de Bitcoin
`gauge_river_free`	Lectura de medidor de ríos de EE. UU. (USGS) con recibo
`gauge_anchor`	Consulta la prueba de Bitcoin para cualquier `record_hash`

De pago — verificación de fuente única

Herramienta	Qué hace
`verify_signal`	Verifica un hecho oficial de más de 180 señales. Recibo anclado a Bitcoin (demuestra que existía a más tardar en el momento del sellado).
`gauge_flood_risk`	Alias de hidrología / aire / precipitación de `verify_signal`
`gauge_resolution_as_of`	Liquidación de mercados de predicción — hecho oficial + evidencia + recibo

De pago — paquetes de validación cruzada de 3 fuentes

Herramienta	Qué verifica de forma cruzada
`gauge_region`	Calidad del aire + precipitación + nivel de ríos
`gauge_crop_drought`	Severidad de sequía + calor/GDD + salud de cultivos por satélite
`gauge_grid_stress`	Presión de demanda + producción renovable + inflación energética
`gauge_route_disruption`	Estado del mar + causa de olas + tráfico de embarcaciones AIS en vivo
`gauge_filing_check`	Eventos SEC 8-K + presentación tardía + compra/venta de información privilegiada
`gauge_stablecoin_lifecycle`	Desviación de paridad + aceleración de reembolsos + exposición del protocolo
`gauge_rwa_lifecycle`	Ciclo de vida del emisor + presión de reembolso + exposición aguas abajo
`gauge_lrt_lifecycle`	Descuento sobre NAV + cola de retiros + cascada de garantías
`gauge_defi_lending`	Utilización + presión de deuda incobrable + contagio
`gauge_depin_network`	Actividad de la red + rotación de recompensas + exposición aguas abajo

Los precios los establece el desafío x402 en vivo (usa gauge_preview para consultar los precios actuales). Si usas la API con tu propio cliente x402, establece maxValue en al menos $0.25 — el valor predeterminado de $0.10 hace que tu cliente rechace las herramientas de paquetes localmente.

Variables de entorno

Clave	Requerida	Descripción
`EVM_PRIVATE_KEY`	Para herramientas de pago	Clave privada de billetera en Base mainnet (0x...). Necesita USDC, no ETH.
`GAUGE_BASE_URL`	No	Punto final de API. Predeterminado: `https://api.truthbear.co`
`GAUGE_MAX_USDC`	No	Límite atómico por llamada en USDC (6 decimales). Predeterminado: `350000`

Verificación de confianza cero

Cada registro de pago lleva un record_hash (SHA-256 canónico). Las raíces Merkle diarias se sellan en Bitcoin mediante OpenTimestamps. El sello demuestra que el conjunto de registros existía a más tardar en stamped_at. Vuelve a verificar en cualquier momento:

Herramienta gauge_anchor (gratuita)
POST /verify o /proof/:record_hash en la API de GAUGE
Descarga los bytes de atestación y verifica con el CLI oficial de ots

Preguntas frecuentes

¿Necesito ETH para el gas? No. x402 usa EIP-3009 (transferencia de USDC sin gas). Solo necesitas USDC en Base.

¿Qué pasa si no configuro una clave privada? Aún puedes usar las 5 herramientas gratuitas. Las herramientas de pago aparecerán listadas pero devolverán un error al llamarlas.

¿Se envía mi clave privada al servidor? No. La clave permanece en tu máquina. x402-fetch firma el pago localmente y envía solo la autorización firmada al servidor GAUGE.

¿Qué sucede si los datos no están disponibles? La herramienta falla honestamente sin cobrar. Solo pagas cuando obtienes un resultado.

¿Puedo verificar el recibo sin tu servidor? Sí. Descarga la atestación de OpenTimestamps mediante gauge_anchor y verifica con la herramienta CLI estándar de ots contra cualquier nodo de Bitcoin — demuestra que el conjunto de registros existía a más tardar en el momento del sellado, no que fue recopilado en el día de los datos.

Enlaces

Sitio web: truthbear.co
Recepción: gauge-frontdesk.zeabur.app
Descubrimiento de API: https://api.truthbear.co/.well-known/x402, /llms.txt
Smithery: smithery.ai/servers/a98741263/mcp-gauge
GitHub: CHANGCHINFU/mcp-gauge

MIT · AEML-DS Vanished-Data Exchange