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 — Servidor MCP para GAUGE (señales verificables, pago por llamada en USDC vía x402)

MCP server score License: MIT Model Context Protocol

Dale a cualquier host MCP (Claude Desktop, Cursor, agentes compatibles con MCP) acceso a las señales verificables de nivel de cribado de GAUGE en muchos dominios (clima, sequía, agricultura, red eléctrica, transporte marítimo, presentaciones regulatorias y más) — y deja que el agente pague por llamada en USDC en Base vía x402 (EIP-3009 sin gas, sin clave API, sin registro).

Descripción pura — hechos de fuentes oficiales (USGS / NOAA / EPA / CAMS / ERA5 / FRED / Open-Meteo Marine / SEC EDGAR) + estadísticas contrastables + record_hash, con raíces Merkle diarias selladas vía OpenTimestamps en Bitcoin — el sello prueba que el conjunto de registros existió no más tarde de su stamped_at; no es evidencia sobre el propio día de los datos. El agente decide. El pago se liquida directamente a la cartera del proveedor.

Respaldado por el servicio GAUGE en https://api.truthbear.co. (El servicio también sigue respondiendo en su host anterior https://aeml-x402.zeabur.app; api.truthbear.co es la URL canónica y es lo que cada desafío 402 anuncia como recurso).

Parte de Truth Bear 🐻 — GAUGE es el motor de datos detrás de Truth Bear, la recepción en lenguaje natural para agentes de IA y pymes. Pregunta en lenguaje sencillo, obtén el hecho oficial + su fuente + un record_hash verificable — sin predicción, sin consejo, el resto es decisión tuya. Un analista, no un comandante. Recepción: https://gauge-frontdesk.zeabur.app · descubrimiento: /.well-known/x402, /llms.txt.

Por qué MCP + x402

  • Descubrimiento es gratuito y abierto (MCP): cualquier host MCP lista estas herramientas sin configuración.
  • Pago es cripto (x402): el agente paga USDC solo cuando llama a una herramienta de pago.
  • Las herramientas gratuitas (gauge_catalog, gauge_preview, gauge_sample, gauge_river_free) no necesitan cartera — prueba antes de comprar.

Herramientas

HerramientaPrecioQué hace
gauge_cataloggratisTodas las señales + entidades consultables
gauge_previewgratisCobertura, menú de precios, listas de paquetes
gauge_samplegratisUn registro de muestra completo (cómo se ve el de pago)
gauge_river_freegratisLectura cruda de río de EE. UU. (ID de sitio USGS)
verify_signal$0.01Empieza aquí. Verifica un hecho oficial antes de que tu agente actúe — lectura vs la escalera de umbrales oficiales + percentil de 5 años + URL de la fuente + record_hash recomputable sin conexión. Más de 180 señales.
gauge_flood_risk$0.01Alias de hidrología/aire/precipitación de verify_signal — mismo endpoint, mismo precio
gauge_region$0.25Paquete de ciudad: aire + precipitación + río + verificación cruzada
gauge_crop_drought$0.25Triángulo agrícola: sequía (USDM) + calor/GDD + VHI de cultivos
gauge_grid_stress$0.25Triángulo de red eléctrica: demanda + renovables + inflación energética
gauge_route_disruption$0.25Triángulo de transporte marítimo: interrupción de ruta + estado del mar + rendimiento AIS
gauge_filing_check$0.25Triángulo de presentaciones regulatorias: 8-K + presentación tardía + Formulario 4 de información privilegiada
gauge_stablecoin_lifecycle$0.25ver la descripción de la herramienta (regenerada desde la cotización 402 en vivo)
gauge_rwa_lifecycle$0.25ver la descripción de la herramienta (regenerada desde la cotización 402 en vivo)
gauge_lrt_lifecycle$0.25ver la descripción de la herramienta (regenerada desde la cotización 402 en vivo)
gauge_defi_lending$0.25ver la descripción de la herramienta (regenerada desde la cotización 402 en vivo)
gauge_depin_network$0.25ver la descripción de la herramienta (regenerada desde la cotización 402 en vivo)
gauge_resolution_as_of$0.01ver la descripción de la herramienta (regenerada desde la cotización 402 en vivo)

Cada cifra anterior se regenera desde la cotización 402 en vivo. El desafío 402 que devuelve el endpoint es siempre la autoridad. Si usas la API con tu propio cliente x402 en lugar de este servidor, establece su maxValue al menos en $0.25 — el valor predeterminado común de $0.10 hace que tu cliente rechace las herramientas de paquetes localmente, antes de que la solicitud se envíe. gauge_preview devuelve el menú actual gratis.

Más de 130 señales (y creciendo) en hidrología, calidad del aire, precipitación, agricultura, red eléctrica, transporte marítimo y presentaciones regulatorias — con cobertura global (EE. UU. más Argentina, Brasil, China, India, Ucrania, UE y más). Consulta el conjunto en vivo en cualquier momento con la herramienta gratuita gauge_catalog.

Instalación y configuración

Requiere Node 18+. El host MCP ejecuta el servidor sobre stdio. Instala directamente desde GitHub — sin cuenta npm, sin registro (el dist/ compilado está incluido):

npx -y github:CHANGCHINFU/mcp-gauge

Claude Desktop

Añade a claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{
  "mcpServers": {
    "gauge": {
      "command": "npx",
      "args": ["-y", "github:CHANGCHINFU/mcp-gauge"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_BASE_WALLET_KEY_WITH_A_LITTLE_USDC"
      }
    }
  }
}

Omite EVM_PRIVATE_KEY para usar solo herramientas gratuitas (catálogo / vista previa / muestra / río).

Cursor / otros hosts MCP / Claude Code

  • Claude Code: claude mcp add gauge -- npx -y github:CHANGCHINFU/mcp-gauge (añade --env EVM_PRIVATE_KEY=0x… para herramientas de pago).
  • Cursor / otros: comando npx -y github:CHANGCHINFU/mcp-gauge, transporte stdio, env EVM_PRIVATE_KEY opcional.

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

Una vez publicado en npm, el nombre del paquete es mcp-gauge-x402 (npx -y mcp-gauge-x402); hasta entonces usa el formato de GitHub anterior.

Configuración (env)

ClaveRequeridaDescripción
EVM_PRIVATE_KEYpara herramientas de pagoClave de cartera 0x en Base mainnet; necesita un poco de USDC (EIP-3009 sin gas, sin ETH).
GAUGE_BASE_URLnohttps://api.truthbear.co predeterminado.
GAUGE_MAX_USDCnoLímite atómico por llamada. Predeterminado 120000 ($0.12).

Trata la clave privada como cualquier secreto de cartera activa; cárgala solo con un pequeño saldo de USDC.

Verificación (confianza cero)

Cada registro de pago lleva record_hash (sha256 canónico). Las raíces Merkle diarias se sellan vía OpenTimestamps en Bitcoin: el sello prueba que el conjunto de registros existió no más tarde de su stamped_at — NO es evidencia sobre el propio día de los datos. Vuelve a verificar vía POST /verify o /proof/:record_hash en el servicio GAUGE; consulta /gauge/anchor para las raíces diarias y los bytes de atestación (verifícalos con la herramienta oficial ots).

Distribución (mantenedores)

  • Instalación desde GitHub (principal, sin cuenta npm): los usuarios ejecutan npx -y github:CHANGCHINFU/mcp-gauge.
  • awesome-mcp-servers: envía un PR a una lista curada de servidores MCP para descubrimiento (sin necesidad de npm).
  • Registro MCP (opcional, requiere npm): publica mcp-gauge-x402 en npm, luego server.json está listo para el editor MCP:
    npm publish
    mcp-publisher login github
    mcp-publisher publish
    

MIT · AEML-DS Vanished-Data Exchange