x402-agent-data

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

x402-agent-data

Datos on-chain de pago para agentes de IA (y humanos). Paga por llamada en USDC en Base a través de HTTP 402 (x402) — sin registro, sin clave API, sin cuenta. El dinero va directamente a la wallet anunciada en la respuesta 402; nada es retenido por el servicio.

• Descubrimiento / landing: https://x402-agent.majighufron.workers.dev
• Servidor MCP (remoto, HTTP streamable): https://x402-agent.majighufron.workers.dev/mcp
• Catálogo legible por máquina: https://x402-agent.majighufron.workers.dev/api
• Instrucciones para agentes: https://x402-agent.majighufron.workers.dev/llms.txt

Servicios

Servicio	Precio	Qué obtienes
token_report · GET /api/token-report	$0.01	Metadatos ERC-20, suministro, actividad reciente de transferencias, saldo de pool opcional. Cadenas: Base, Base Sepolia, Robinhood Chain
pool_risk · GET /api/pool-risk	$0.02	Reservas del pool, precio implícito, slippage de producto constante para un nocional dado
wallet_profile · GET /api/wallet-profile	$0.03	Transferencias entrantes/salientes, contrapartes distintas, primer y último bloque visto
contract_dd · GET /api/contract-dd	$0.05	Señales de debida diligencia: selectores riesgosos presentes en el bytecode, propietario + estado de renuncia, actividad, participación de la transferencia más grande

Endpoints gratuitos: / descubrimiento · /api catálogo · /llms.txt texto de agente · /api/sample informe truncado para que puedas verificar la forma de los datos antes de pagar · /mcp servidor MCP (la herramienta service_catalog es gratuita).

Úsalo desde un cliente MCP

Añade el servidor remoto a cualquier cliente MCP (Claude Desktop, Cursor, o tu propio agente):

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

Herramientas: service_catalog (gratuita), token_report, pool_risk, wallet_profile, contract_dd. Llama a una herramienta de pago una vez sin payment_signature y devuelve los requisitos de pago; paga, luego llama de nuevo con payment_signature = base64 de {"txHash":"0x…"}.

Úsalo sobre HTTP simple

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

Una prueba es de un solo uso y debe ser de los últimos 15 minutos. Si el propio servicio falla (limitación de RPC upstream), responde 503 retryable: true y libera tu prueba, para que puedas llamar de nuevo sin pagar dos veces.

Consulta examples/pay_and_fetch.py para un recorrido ejecutable.

Por qué existe

Los datos on-chain suelen venderse como suscripción mensual detrás de una clave API. El software de agentes no puede rellenar formularios de registro, así que esto expone los mismos datos por llamada: la respuesta HTTP 402 es la lista de precios, y la wallet es la identidad.

Límites honestos

• Los RPC públicos upstream limitan las IPs de salida compartidas, por lo que una llamada ocasionalmente puede responder 503; las pruebas se liberan para que los reintentos sean gratuitos.
• contract_dd reporta señales, no veredictos: la presencia de un selector dice qué hay en el bytecode, no cómo se comporta. Los proxies y el código muerto ocultan la intención.
• El pago usa una transferencia USDC simple más un encabezado de prueba (autoverificado). No es el flujo facilitador EIP-3009 todavía.

Licencia

MIT