x402-buyer-mcp

El agente comprador universal para la economía x402.

Un servidor MCP que permite a los usuarios de Claude Desktop, Cursor y Claude Code descubrir, pagar y llamar a cualquier endpoint x402, automáticamente. Hazle una pregunta a Claude y este pagará por la respuesta con USDC.

Sin billeteras. Sin conocimientos de cripto. Sin claves de API. Solo preguntas y respuestas.

Qué hace esto

El protocolo x402 permite a los agentes de IA pagar por llamadas a API con USDC. Pero hasta ahora, la mayoría de las herramientas en el ecosistema son vendedores: endpoints que aceptan pagos. Este es el comprador: el agente que gasta.

Cuando le preguntas a Claude "¿es seguro stripe.com?", este MCP:

1. Descubre el endpoint x402 correcto (Domain Shield — VirusTotal + seguridad DNS)

2. Paga $0.12 en USDC en Base a través de tu billetera AgentCash

3. Devuelve el informe de seguridad completo y puntuado a Claude

4. Claude sintetiza la respuesta de forma natural

Nunca tocas una billetera. Nunca ves una cadena de bloques. Solo obtienes respuestas respaldadas por datos premium.

Instalación

Requisitos previos

1. Financia una billetera AgentCash (una sola vez, 2 minutos):

   npx agentcash install

   Sigue las instrucciones para crear una billetera y financiarla con USDC en Base. $5 cubren unas 40 llamadas.

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "x402-buyer": {
      "command": "npx",
      "args": ["-y", "x402-buyer-mcp"]
    }
  }
}

Cursor

Añade a tu .cursor/mcp.json:

{
  "mcpServers": {
    "x402-buyer": {
      "command": "npx",
      "args": ["-y", "x402-buyer-mcp"]
    }
  }
}

Claude Code

claude mcp add x402-buyer -- npx -y x402-buyer-mcp

Herramientas

x402_discover

Busca endpoints x402 que puedan responder a una pregunta.

"Find endpoints for domain security scanning"
"Search for company intelligence APIs"
"What x402 endpoints handle drug interactions?"

x402_call

Llama a cualquier endpoint x402 con pago automático.

"Call https://www.alderpost.co/api/domain-shield?domain=stripe.com"
"Call https://www.alderpost.co/api/company-xray?domain=hubspot.com"

x402_balance

Consulta el saldo de tu billetera AgentCash.

"What's my x402 balance?"
"How many calls can I afford?"

x402_research ⭐

La función estrella. Investigación paralela en múltiples endpoints. Dale un dominio y llamará a 3-5 endpoints simultáneamente, devolviendo un panorama de inteligencia completo.

"Research stripe.com" → calls 5 endpoints (~$0.64):
  - Domain Shield (security scan)
  - Company X-Ray (firmographics)
  - Threat Pulse (threat intel)
  - Compliance Check (audit)
  - Prospect IQ (contact info)

"Research ibuprofen" → calls 1 endpoint (~$0.10):
  - Health Signal (FDA data + drug interactions)

"Research 123 Main St Milwaukee WI" → calls 1 endpoint (~$0.10):
  - Property Intel (demographics + amenities)

Control de presupuesto: establece max_cost para limitar el gasto total por llamada de investigación.

Endpoints en el registro

El registro integrado incluye endpoints premium respaldados por fuentes de datos de pago:

Todos los endpoints funcionan con Alderpost Intelligence.

Cómo funciona el pago

You ask Claude a question
  → Claude calls x402_research or x402_call
    → This MCP calls AgentCash CLI
      → AgentCash signs a USDC payment on Base
        → The endpoint verifies + settles on-chain
          → Data returned to Claude
            → Claude answers your question

Financias AgentCash una vez. Cada llamada x402 se descuenta de ese saldo. Sin suscripciones. Sin claves de API. Paga exactamente por lo que usas.

Sesión de ejemplo

You: "Tell me everything about hubspot.com"

Claude: I'll run a comprehensive research scan on hubspot.com.
[Calls x402_research with subject "hubspot.com"]

Results from 5 endpoints ($0.64 total):

Domain Shield: Security score 85/100. DMARC=reject, SPF=pass,
DKIM configured. VirusTotal: clean (0/94 engines flagged).

Company X-Ray: HubSpot, Inc. Founded 2006. 10,268 employees.
Computer Software. Cambridge, MA. Public company.
Tech: Cloudflare CDN, Google Workspace, Next.js.

Threat Pulse: Threat score 92/100. No blacklist hits.
AbuseIPDB: 0 reports. Clean reputation.

Compliance Check: SSL Labs grade A. 6/6 security headers.
DNSSEC not enabled. Cookie consent detected.

Prospect IQ: Prospect score 82/100 (hot). 5 verified email
contacts found via Hunter.io. Email pattern: {first}@hubspot.com.

Precios

Este servidor MCP es gratuito. Solo pagas por los endpoints x402 que llamas. Costos típicos:

• Llamada a un solo endpoint: $0.10 - $0.15

• Investigación completa de dominio (5 endpoints): ~$0.64

• Consulta de salud/propiedad/deportes: ~$0.10

$5 en AgentCash cubren aproximadamente 40 llamadas individuales u 8 informes de investigación completos.

Por qué existe esto

El protocolo x402 está diseñado para que los agentes paguen por los datos de forma autónoma. Pero el ecosistema tiene un problema de arranque en frío: los vendedores han creado endpoints, pero no hay suficientes compradores llamándolos. Este MCP es la infraestructura del lado del comprador que hace que x402 funcione según lo previsto.

Cada instalación crea un nuevo comprador en la economía x402. Cada llamada de investigación genera 3-5 transacciones reales en la cadena. Así es como la economía de agentes arranca.

Enlaces

• Alderpost Intelligence — Proveedor de endpoints

• AgentCash — Infraestructura de billetera y pago

• x402scan — Explorador del ecosistema

• Protocolo x402 — Especificación del protocolo

Licencia

MIT — Alderpost LLC, Wisconsin