Deja que Claude, ChatGPT, Cursor y Codex lean la documentación, creen facturas de prueba y revisen pedidos por ti. Solo cobra y lee datos. No puede sacar dinero.
https://blockwallets.io/mcpInicio de sesión OAuth, o un token MCP (Bearer) del panel. Todas las herramientas.
https://blockwallets.io/mcp/publicSolo herramientas públicas: documentación, redes, precios, explicación de la firma, lista de integración.
Qué hace
Mientras escribes la integración, tu IA lee directamente nuestra documentación y las reglas de firma, sin copiar y pegar.
Con un token de prueba, la IA crea una factura de prueba, tú simulas el pago y ella comprueba el estado de principio a fin.
En el día a día, pregunta “¿cuánto cobramos ayer?” o “¿está pagado order_1042?” y obtén la respuesta.
Instalar
Crea tokens en el panel, en “Desarrolladores › Herramientas de IA (MCP)”; el token se muestra una sola vez. Empieza con un token de prueba.
claude mcp add --transport http blockwallets https://blockwallets.io/mcp \ --header "Authorization: Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Con token; o quita --header y ejecuta /mcp dentro de Claude Code para iniciar sesión con OAuth.
claude mcp add --transport http blockwallets-docs https://blockwallets.io/mcp/public
{
"mcpServers": {
"blockwallets": {
"url": "https://blockwallets.io/mcp",
"headers": {
"Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}{
"mcpServers": {
"blockwallets": {
"serverUrl": "https://blockwallets.io/mcp",
"headers": {
"Authorization": "Bearer bw_mcp_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}[mcp_servers.blockwallets] url = "https://blockwallets.io/mcp" bearer_token_env_var = "BLOCKWALLETS_MCP_TOKEN"
Pon el token en la variable de entorno BLOCKWALLETS_MCP_TOKEN; requiere una versión reciente de Codex con soporte de MCP por HTTP.
Conectores
https://blockwallets.io/mcphttps://blockwallets.io/mcp y autenticación OAuth¿No quieres iniciar sesión? Usa https://blockwallets.io/mcp/public para usar solo las herramientas públicas de documentación.
Herramientas
| Herramienta | Qué hace | Permiso |
|---|---|---|
search_docs | Busca en la documentación de integración; devuelve secciones y enlaces relevantes | público |
get_doc | Lee una sección de la documentación en Markdown | público |
list_networks | Monedas y redes, confirmaciones, importes mínimos | público |
get_pricing | Comisiones y tramos por volumen | público |
explain_signature | Explica paso a paso cómo se calcula la firma (nunca pide la API key) | público |
integration_checklist | Pasos de integración y lista de aceptación para tu stack | público |
create_payment | Crea una factura y devuelve su página de pago (idempotente por order_id) | payments:create |
create_payment_link | Crea un enlace de pago y un código QR | payments:create |
get_payment | Lee una factura por order_id o uuid | read |
list_payments | Lista facturas por estado y fecha | read |
get_balance | Lee el saldo real (solo lectura, sin retiros) | read |
Seguridad
Retiros, pagos, reembolsos, direcciones de retiro, URL de callback y claves no están en MCP ni tienen permiso. Solo tú puedes hacerlo en el panel.
Las credenciales de prueba solo crean facturas en testnets y solo ven datos de prueba. Nada de dinero real.
Las credenciales reales ven pedidos y saldos reales. Da solo lectura salvo que necesites crear facturas. Las cuentas con verificación en dos pasos piden un código para credenciales reales, y te avisamos por correo cada vez.
Los tokens y las autorizaciones OAuth están en una misma lista del panel. Revoca uno y sus tokens dejan de funcionar al instante.
Los tokens y los códigos se guardan como sha256; el token se muestra una vez. Cada llamada del comercio queda auditada y cada credencial tiene un límite de 60 peticiones por minuto.
Preguntas
El Model Context Protocol, un estándar abierto para que las herramientas de IA llamen a servicios externos. Una vez conectados, Claude, ChatGPT, Cursor y otros pueden llamar directamente a las herramientas de blockwallets.
No. No hay ninguna herramienta para retiros, pagos, reembolsos ni para cambiar direcciones o claves, y no existe permiso para ello.
El modo de prueba funciona en testnets públicas con facturas y datos de prueba; el modo real es tu cuenta de verdad. Haz que el flujo funcione primero en modo de prueba.
Por ahora, usa en Cursor un token del panel. OAuth funciona con clientes que usan redirección https o loopback, como Claude, ChatGPT y Claude Code.
Busca el token o la autorización en el panel, en “Desarrolladores › Herramientas de IA (MCP)”, y revócalo; surte efecto al instante.