SERVIDOR MCP

Herramientas de wallet para agentes para cualquier cliente MCP.

El servidor MCP oficial de Blockchain0x da a un agente compatible con MCP la capacidad de leer wallets, enviar USDC en Base y liquidar facturas. Conecta el endpoint hosted o ejecútalo localmente con un solo comando.

https://mcp.blockchain0x.com/mcp

QUÉ ES

Un servidor. Cinco herramientas. Cada cliente MCP.

Model Context Protocol es la forma estándar en que los clientes de AI - Claude Desktop, Cursor, Cline y otros - llaman herramientas externas. El servidor MCP de Blockchain0x expone tus wallets de agentes a través de ese estándar, para que cualquier cliente MCP pueda mover dinero sin que tengas que escribir una integración personalizada.

El servidor es un proxy ligero y sin estado sobre la API de Blockchain0x. No mantiene fondos ni base de datos; reenvía cada llamada de herramienta a la API usando la clave que proporcionas, y el permiso de gasto de cada agente sigue limitando lo que una herramienta puede hacer.

LAS HERRAMIENTAS

Lo que el agente puede invocar.

get_wallet

Lee la wallet de un agente: dirección, saldo de USDC en Base y metadatos.

list_wallets

Lista las wallets de agentes en tu espacio de trabajo.

get_transaction

Busca una transacción por su id y lee su estado on-chain.

send_payment

Envía USDC desde la wallet de un agente en Base, dentro de su permiso de gasto.

settle_payment_request

Liquida una solicitud de pago que creaste en el panel, con prueba on-chain.

CÓMO USARLO

Dos formas de conectarse.

1. Alojado (Streamable HTTP)

Apunta tu cliente MCP al endpoint hosted y pasa tu API key como encabezado Bearer. No hay nada que instalar.

CONFIGURACIÓN DEL CLIENTE MCP (HOSTED)

{
  "mcpServers": {
    "blockchain0x": {
      "url": "https://mcp.blockchain0x.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

2. Local (stdio, vía npx)

Ejecuta el servidor en tu propia máquina con npx @blockchain0x/mcp. Tu clave permanece en tu entorno y nunca sale de tu dispositivo.

CONFIGURACIÓN DEL CLIENTE MCP (STDIO)

{
  "mcpServers": {
    "blockchain0x": {
      "command": "npx",
      "args": ["@blockchain0x/mcp"],
      "env": { "BLOCKCHAIN0X_API_KEY": "sk_live_..." }
    }
  }
}

Empieza con una clave sk_test_ en Base Sepolia, luego cambia a sk_live_. La configuración completa está en la documentación; para poner precio a tus propias herramientas MCP, consulta la receta de integración MCP.

SEGURIDAD

El permiso de gasto sigue aplicándose.

El servidor nunca retiene tus fondos ni tus claves; reenvía cada llamada a la API de Blockchain0x.
send_payment se comprueba frente al límite por transacción y al monto permitido por período del agente antes de liquidarse, igual que cualquier otra llamada a la API.
Usa una clave de solo lectura (sin permiso de pago) para un agente que solo deba leer wallets y transacciones.
En stdio, la clave permanece en tu entorno local. En hosted, viaja como un encabezado Bearer sobre TLS y no se almacena.

PREGUNTAS FRECUENTES

Tres preguntas sobre el servidor MCP.

¿Dónde se ejecuta el servidor MCP y puedes ver mi clave?

Dos formas de ejecutarlo. Hosted: conecta tu cliente MCP al endpoint HTTP Streamable y envía tu API key como un encabezado Bearer en cada solicitud; el servidor es un proxy sin estado que reenvía las llamadas a la API de Blockchain0x. Local (stdio): ejecuta npx @blockchain0x/mcp en tu propia máquina y tu clave permanece en tu entorno, sin salir nunca de tu dispositivo. Elige stdio si prefieres no enviar la clave a un endpoint alojado.

¿Qué API key debo usar?

Una clave sk_test_ funciona contra Base Sepolia (testnet) para que puedas configurar las herramientas sin mover dinero real; cambia a una clave sk_live_ para mainnet. Los scopes de la clave determinan lo que pueden hacer las herramientas - una clave de solo lectura puede llamar get_wallet, list_wallets y get_transaction, pero no send_payment.

¿Es esto lo mismo que el helper requirePayment?

No. Esta página trata sobre el servidor MCP de Blockchain0x, que proporciona a un cliente MCP herramientas de wallet de agentes (leer wallets, enviar USDC, liquidar facturas). requirePayment es un helper separado en @blockchain0x/mcp que usas para poner precio a tus PROPIAS herramientas MCP devolviendo un desafío x402 402. Consulta la receta de integración MCP para eso.

Dale una wallet a tu cliente MCP.

Crea una wallet de agente, obtén una clave y apunta tu cliente al servidor. Empieza gratis.