mcp-gauge

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

Documentação

mcp-gauge — Fatos verificáveis para agentes de IA, pagamento por chamada via x402

Verifique fatos oficiais antes que seu agente de IA aja. Mais de 180 sinais do USGS, NOAA, SEC EDGAR, EPA e outros — cada resposta inclui validação cruzada de múltiplas fontes e um recibo à prova de adulteração ancorado no Bitcoin via OpenTimestamps (provando que o conjunto de registros existia no máximo até o horário do carimbo, não que foi coletado no dia dos dados). Sem chave de API, sem cadastro. Pague por chamada em USDC na Base via x402.

Início rápido

Claude Desktop

Adicione à sua configuração (~/Library/Application Support/Claude/claude_desktop_config.json no macOS, %APPDATA%\Claude\claude_desktop_config.json no Windows):

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

Cursor

Adicione ao .cursor/mcp.json na raiz do seu projeto (ou configuração 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

Outros hosts MCP

Qualquer cliente MCP que suporte transporte stdio funciona. Comando: npx -y mcp-gauge-x402, defina EVM_PRIVATE_KEY no ambiente para ferramentas pagas.

Alternativa: instalar a partir do GitHub (sem necessidade de conta npm):
npx -y github:CHANGCHINFU/mcp-gauge

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

Configuração de pagamento

	Sem `EVM_PRIVATE_KEY`	Com `EVM_PRIVATE_KEY`
Ferramentas gratuitas	Sim	Sim
Ferramentas pagas	Não (ferramentas visíveis, mas chamadas falham)	Sim (pagamento automático via x402)

Como funciona: Quando seu agente chama uma ferramenta paga, o servidor GAUGE retorna um desafio de pagamento x402. O cliente MCP paga automaticamente em USDC na Base (EIP-3009 sem gás — sem necessidade de ETH) e tenta a requisição novamente. O recibo é incluído em cada resposta.

Segurança da carteira:

Use uma carteira descartável dedicada com saldo pequeno de USDC — nunca sua carteira principal
A chave privada nunca sai da sua máquina (processada localmente pelo x402-fetch)
Carregue apenas USDC suficiente para o uso esperado
Rede: Base mainnet (L2 da Coinbase)

Ferramentas

Gratuitas (sem necessidade de carteira)

Ferramenta	O que faz
`gauge_catalog`	Navegue por mais de 180 sinais disponíveis
`gauge_preview`	Cobertura, menu de preços, conteúdo dos pacotes
`gauge_sample`	Registro de amostra completo com recibo Bitcoin
`gauge_river_free`	Leitura de medidor de rio dos EUA (USGS) com recibo
`gauge_anchor`	Consulte a prova Bitcoin para qualquer `record_hash`

Pagas — verificação de fonte única

Ferramenta	O que faz
`verify_signal`	Verifique um fato oficial de mais de 180 sinais. Recibo ancorado no Bitcoin (prova que existia no máximo até o horário do carimbo).
`gauge_flood_risk`	Alias de hidrologia / ar / precipitação do `verify_signal`
`gauge_resolution_as_of`	Liquidação de mercado de previsão — fato oficial + evidência + recibo

Pagas — pacotes de validação cruzada com 3 fontes

Ferramenta	O que verifica cruzadamente
`gauge_region`	Qualidade do ar + precipitação + nível do rio
`gauge_crop_drought`	Severidade da seca + calor/GDD + saúde das culturas via satélite
`gauge_grid_stress`	Pressão de demanda + produção renovável + inflação de energia
`gauge_route_disruption`	Estado do mar + causa das ondas + tráfego ao vivo de embarcações AIS
`gauge_filing_check`	Eventos SEC 8-K + atraso de arquivamento + compra/venda de insiders
`gauge_stablecoin_lifecycle`	Desvio de paridade + aceleração de resgate + exposição do protocolo
`gauge_rwa_lifecycle`	Ciclo de vida do emissor + pressão de resgate + exposição downstream
`gauge_lrt_lifecycle`	Desconto sobre NAV + fila de retirada + cascata de garantias
`gauge_defi_lending`	Utilização + pressão de dívida inadimplente + contágio
`gauge_depin_network`	Atividade da rede + rotatividade de recompensas + exposição downstream

Os preços são definidos pelo desafio x402 ao vivo (use gauge_preview para verificar os preços atuais). Se você usar a API com seu próprio cliente x402, defina maxValue para pelo menos $0,25 — o padrão de $0,10 faz seu cliente rejeitar ferramentas de pacote localmente.

Variáveis de ambiente

Chave	Obrigatória	Descrição
`EVM_PRIVATE_KEY`	Para ferramentas pagas	Chave privada da carteira Base mainnet (0x...). Precisa de USDC, sem ETH.
`GAUGE_BASE_URL`	Não	Endpoint da API. Padrão: `https://api.truthbear.co`
`GAUGE_MAX_USDC`	Não	Limite atômico por chamada em USDC (6 decimais). Padrão: `350000`

Verificação de confiança zero

Cada registro pago carrega um record_hash (SHA-256 canônico). Raízes Merkle diárias são carimbadas no Bitcoin via OpenTimestamps. O carimbo prova que o conjunto de registros existia no máximo até stamped_at. Re-verifique a qualquer momento:

Ferramenta gauge_anchor (gratuita)
POST /verify ou /proof/:record_hash na API GAUGE
Baixe os bytes de atestado e verifique com o CLI oficial ots

FAQ

Preciso de ETH para gás? Não. x402 usa EIP-3009 (transferência USDC sem gás). Você só precisa de USDC na Base.

E se eu não definir uma chave privada? Você ainda pode usar todas as 5 ferramentas gratuitas. As ferramentas pagas serão listadas, mas retornarão erro quando chamadas.

Minha chave privada é enviada ao servidor? Não. A chave permanece na sua máquina. O x402-fetch assina o pagamento localmente e envia apenas a autorização assinada ao servidor GAUGE.

O que acontece se os dados não estiverem disponíveis? A ferramenta falha honestamente sem cobrança. Você só paga quando obtém um resultado.

Posso verificar o recibo sem o seu servidor? Sim. Baixe o atestado OpenTimestamps via gauge_anchor e verifique com a ferramenta CLI padrão ots contra qualquer nó Bitcoin — isso prova que o conjunto de registros existia no máximo até o horário do carimbo, não que foi coletado no dia dos dados.