x402-agent-data

npx add-mcp 'https://x402-agent.majighufron.workers.dev/mcp'

x402-agent-data

Dados on-chain pagos para agentes de IA (e humanos). Pague por chamada em USDC na Base via HTTP 402 (x402) — sem cadastro, sem chave de API, sem conta. O dinheiro vai direto para a carteira anunciada na resposta 402; nada é retido pelo serviço.

• Descoberta / landing: https://x402-agent.majighufron.workers.dev
• Servidor MCP (remoto, HTTP streamable): https://x402-agent.majighufron.workers.dev/mcp
• Catálogo legível por máquina: https://x402-agent.majighufron.workers.dev/api
• Instruções para agentes: https://x402-agent.majighufron.workers.dev/llms.txt

Serviços

Serviço	Preço	O que você recebe
token_report · GET /api/token-report	$0,01	Metadados ERC-20, supply, atividade recente de transferências, saldo de pool opcional. Chains: Base, Base Sepolia, Robinhood Chain
pool_risk · GET /api/pool-risk	$0,02	Reservas da pool, preço implícito, slippage de produto constante para um notional dado
wallet_profile · GET /api/wallet-profile	$0,03	Transferências de entrada/saída, contrapartes distintas, primeiro e último bloco vistos
contract_dd · GET /api/contract-dd	$0,05	Sinais de due diligence: seletores arriscados presentes no bytecode, owner + status de renúncia, atividade, participação da maior transferência

Endpoints gratuitos: / descoberta · /api catálogo · /llms.txt texto do agente · /api/sample relatório truncado para você verificar o formato dos dados antes de pagar · /mcp servidor MCP (a ferramenta service_catalog é gratuita).

Use a partir de um cliente MCP

Adicione o servidor remoto a qualquer cliente MCP (Claude Desktop, Cursor ou seu próprio agente):

{
  "mcpServers": {
    "x402-agent-data": {
      "type": "streamable-http",
      "url": "https://x402-agent.majighufron.workers.dev/mcp"
    }
  }
}

Ferramentas: service_catalog (gratuita), token_report, pool_risk, wallet_profile, contract_dd. Chame uma ferramenta paga uma vez sem payment_signature e ela retorna os requisitos de pagamento; pague, depois chame novamente com payment_signature = base64 de {"txHash":"0x…"}.

Use via HTTP simples

# 1. Ask without paying -> HTTP 402 + payment requirements
curl -s "https://x402-agent.majighufron.workers.dev/api/token-report?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

# 2. Send the quoted USDC amount to the payTo address on Base (USDC, 6 decimals)

# 3. Retry with the proof
TX=0x…   # your transfer hash
PROOF=$(printf '{"txHash":"%s"}' "$TX" | base64)
curl -s -H "PAYMENT-SIGNATURE: $PROOF" \
  "https://x402-agent.majighufron.workers.dev/api/token-report?chain=base&token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

Uma prova é de uso único e deve ser dos últimos 15 minutos. Se o próprio serviço falhar (throttling de RPC upstream), ele responde 503 retryable: true e libera sua prova, para que você possa chamar novamente sem pagar duas vezes.

Veja examples/pay_and_fetch.py para um passo a passo executável.

Por que existe

Dados on-chain geralmente são vendidos como assinatura mensal atrás de uma chave de API. Software de agente não consegue preencher formulários de cadastro, então isso expõe os mesmos dados por chamada: a resposta HTTP 402 é a lista de preços, e a carteira é a identidade.

Limites honestos

• RPCs públicos upstream limitam IPs de egress compartilhados, então uma chamada pode ocasionalmente responder 503; as provas são liberadas para que tentativas sejam gratuitas.
• contract_dd reporta sinais, não veredictos: a presença de seletor diz o que está no bytecode, não como ele se comporta. Proxies e código morto ambos escondem intenção.
• O pagamento usa uma transferência USDC simples mais um cabeçalho de prova (autoverificado). Não é o fluxo facilitador EIP-3009 ainda.

Licença

MIT