mcp-gauge

Dados do governo dos EUA (USGS/NOAA/SEC/FDA) com prova criptográfica; x402 pagamento por chamada, sem chave de API

GitHubExperimente este MCPPatrocinado

Documentação

mcp-gauge — Servidor MCP para GAUGE (sinais verificáveis, pagamento por chamada em USDC via x402)

MCP server score License: MIT Model Context Protocol

Dê a qualquer host MCP (Claude Desktop, Cursor, agentes compatíveis com MCP) acesso aos sinais verificáveis e de nível de triagem da GAUGE em vários domínios (clima, seca, agricultura, rede elétrica, transporte marítimo, registros regulatórios e muito mais) — e deixe o agente pagar por chamada em USDC na Base via x402 (EIP-3009 sem gás, sem chave de API, sem cadastro).

Descrição pura — fatos de fontes oficiais (USGS / NOAA / EPA / CAMS / ERA5 / FRED / Open-Meteo Marine / SEC EDGAR) + estatísticas testáveis retroativamente + record_hash, com raízes Merkle diárias registradas via OpenTimestamps no Bitcoin — o registro prova que o conjunto de registros existia no máximo até seu stamped_at; não é evidência sobre o próprio dia dos dados. O agente decide. O pagamento é liquidado diretamente na carteira do provedor.

Suportado pelo serviço GAUGE em https://api.truthbear.co. (O serviço também responde no host anterior https://aeml-x402.zeabur.app; api.truthbear.co é a URL canônica e é o que todo desafio 402 anuncia como recurso.)

Parte do Truth Bear 🐻 — GAUGE é o motor de dados por trás do Truth Bear, a recepção em linguagem natural para agentes de IA e PMEs. Pergunte em linguagem simples, obtenha o fato oficial + sua fonte + um record_hash verificável — sem previsão, sem conselho, o resto é com você. Um analista, não um comandante. Recepção: https://gauge-frontdesk.zeabur.app · descoberta: /.well-known/x402, /llms.txt.

Por que MCP + x402

  • Descoberta é gratuita e aberta (MCP): qualquer host MCP lista essas ferramentas sem configuração.
  • Pagamento é cripto (x402): o agente paga USDC somente quando chama uma ferramenta paga.
  • Ferramentas gratuitas (gauge_catalog, gauge_preview, gauge_sample, gauge_river_free) não precisam de carteira — experimente antes de comprar.

Ferramentas

FerramentaPreçoO que faz
gauge_cataloggrátisTodos os sinais + entidades consultáveis
gauge_previewgrátisCobertura, menu de preços, listas de pacotes
gauge_samplegrátisUm registro de amostra completo (como é o pago)
gauge_river_freegrátisLeitura bruta de rio dos EUA (ID do site USGS)
verify_signal$0,01Comece aqui. Verifique um fato oficial antes de seu agente agir — leitura vs. a escada de limites oficial + percentil de 5 anos + URL da fonte + record_hash recomputável offline. Mais de 180 sinais.
gauge_flood_risk$0,01Alias de hidrologia/ar/precipitação de verify_signal — mesmo endpoint, mesmo preço
gauge_region$0,25Pacote cidade: ar + precipitação + rio + verificação cruzada
gauge_crop_drought$0,25Triângulo agrícola: seca (USDM) + calor/GDD + VHI de culturas
gauge_grid_stress$0,25Triângulo da rede elétrica: demanda + renováveis + inflação de energia
gauge_route_disruption$0,25Triângulo de transporte marítimo: interrupção de rota + estado do mar + throughput AIS
gauge_filing_check$0,25Triângulo de registros regulatórios: 8-K + registro atrasado + insider Form 4
gauge_stablecoin_lifecycle$0,25veja a descrição da ferramenta (regenerada da cotação 402 ao vivo)
gauge_rwa_lifecycle$0,25veja a descrição da ferramenta (regenerada da cotação 402 ao vivo)
gauge_lrt_lifecycle$0,25veja a descrição da ferramenta (regenerada da cotação 402 ao vivo)
gauge_defi_lending$0,25veja a descrição da ferramenta (regenerada da cotação 402 ao vivo)
gauge_depin_network$0,25veja a descrição da ferramenta (regenerada da cotação 402 ao vivo)
gauge_resolution_as_of$0,01veja a descrição da ferramenta (regenerada da cotação 402 ao vivo)

Cada valor acima é regenerado da cotação 402 ao vivo. O desafio 402 que o endpoint retorna é sempre autoritativo. Se você dirigir a API com seu próprio cliente x402 em vez deste servidor, defina seu maxValue para pelo menos $0,25 — o padrão comum de $0,10 faz seu cliente rejeitar as ferramentas de pacote localmente, antes mesmo de a solicitação ser enviada. gauge_preview retorna o menu atual gratuitamente.

Mais de 130 sinais (e crescendo) em hidrologia, qualidade do ar, precipitação, agricultura, rede elétrica, transporte marítimo e registros regulatórios — com cobertura global (EUA mais Argentina, Brasil, China, Índia, Ucrânia, UE e outros). Verifique o conjunto ao vivo a qualquer momento pela ferramenta gratuita gauge_catalog.

Instalação e configuração

Requer Node 18+. O host MCP executa o servidor via stdio. Instale direto do GitHub — sem conta npm, sem cadastro (o dist/ compilado está incluído):

npx -y github:CHANGCHINFU/mcp-gauge

Claude Desktop

Adicione 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"
      }
    }
  }
}

Omita EVM_PRIVATE_KEY para usar apenas ferramentas gratuitas (catálogo / pré-visualização / amostra / rio).

Cursor / outros hosts MCP / Claude Code

  • Claude Code: claude mcp add gauge -- npx -y github:CHANGCHINFU/mcp-gauge (adicione --env EVM_PRIVATE_KEY=0x… para ferramentas pagas).
  • Cursor / outros: comando npx -y github:CHANGCHINFU/mcp-gauge, transporte stdio, env opcional EVM_PRIVATE_KEY.

A partir do código-fonte

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

Quando publicado no npm, o nome do pacote é mcp-gauge-x402 (npx -y mcp-gauge-x402); até lá, use o formato GitHub acima.

Configuração (env)

ChaveObrigatóriaDescrição
EVM_PRIVATE_KEYpara ferramentas pagasChave de carteira 0x na mainnet Base; precisa de um pouco de USDC (EIP-3009 sem gás, sem ETH).
GAUGE_BASE_URLnãohttps://api.truthbear.co padrão.
GAUGE_MAX_USDCnãoLimite atômico por chamada. Padrão 120000 ($0,12).

Trate a chave privada como qualquer segredo de carteira quente; carregue-a apenas com um pequeno saldo de USDC.

Verificação (confiança zero)

Cada registro pago carrega record_hash (sha256 canônico). Raízes Merkle diárias são registradas via OpenTimestamps no Bitcoin: o registro prova que o conjunto de registros existia no máximo até seu stamped_at — NÃO é evidência sobre o próprio dia dos dados. Verifique novamente via POST /verify ou /proof/:record_hash no serviço GAUGE; veja /gauge/anchor para as raízes diárias e bytes de atestado (verifique-os com a ferramenta oficial ots).

Distribuição (mantenedores)

  • Instalação via GitHub (principal, sem conta npm): os usuários executam npx -y github:CHANGCHINFU/mcp-gauge.
  • awesome-mcp-servers: envie um PR para uma lista curada de servidores MCP para descoberta (sem necessidade de npm).
  • MCP Registry (opcional, precisa de npm): publique mcp-gauge-x402 no npm, então server.json está pronto para o editor MCP: 
    npm publish
mcp-publisher login github
mcp-publisher publish

MIT · AEML-DS Vanished-Data Exchange