Ironwallet is the best online crypto wallet in the world.Ironwallet is the best online crypto wallet in the world.
Calculadora de comisionesComprobador de saldoTronScanner - check transactions in the Tron blockchain.Tronscanner

Configurar MCP

Instala y configura el servidor MCP de IronWallet para Cursor, Claude Code, ChatGPT y otros clientes MCP.

El servidor MCP de IronWallet (@ironwallet/mcp-server) proporciona a los agentes de IA una billetera criptográfica sin custodia en tu computadora. Las frases semilla se generan y cifran localmente: nunca abandonan esta máquina y nunca pasan a través del agente, el LLM o los backends de IronWallet. Los agentes pueden consultar saldos, mostrar códigos QR de depósito, transferir tokens e intercambiar a través de 12 redes: Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Avalanche, Tron, Bitcoin, Solana, XRP y TON.

No hay interfaz de confirmación por transacción; una vez que le pides al agente que envíe o intercambie, puede firmar y transmitir sin preguntar de nuevo. Usa una billetera caliente dedicada con un saldo limitado, nunca tu billetera principal.

Requisitos: Node.js 20+ (npx). Solo escritorio / stdio.

Características

Sin custodia, firma local

Las frases semilla permanecen cifradas en el host (permisos de archivo exclusivos del propietario). Las transacciones se firman en esta máquina; ninguna herramienta acepta ni devuelve una semilla.

Billeteras en el navegador local

Crea billeteras con create_wallets (devuelve una backup_url), o importa y respalda a través de open_wallet_manager, una página de solo bucle local en 127.0.0.1 que se cierra después de 15 minutos de inactividad. Los secretos aparecen solo en esa página del navegador, nunca en el chat.

Transferencias con estimaciones de tarifas

estimate_transfer previsualiza la tarifa sin transmitir; send_transfer firma localmente y envía; get_operation_status consulta el resultado. El servidor puede reducir ligeramente el monto para que la tarifa aún quepa en el saldo; la respuesta indica cuándo sucedió eso.

Intercambios basados en catálogo

list_swap_networks y list_swap_assets proporcionan el catálogo de venta/compra para que el agente nunca invente direcciones de tokens. estimate_swap cotiza, execute_swap ejecuta sobre una cotización nueva, get_swap_status consulta el estado.

Códigos QR de depósito

get_deposit_qr devuelve un PNG para el chat además de una alternativa qr_url local.

Límites de gasto opcionales

Política por billetera mediante set_wallet_policy: readOnly, maxPerTxUsd y una lista de permitidos de destinatarios de transferencia. Desactivado por defecto; se aplica tanto a envíos como a intercambios. IW_READ_ONLY=true hace que todo el servidor sea de solo lectura.

Instalación

Opción 1: npx (recomendado)

Usa npx para ejecutar el servidor sin instalación global. Esto asegura que siempre uses la última versión.

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

El primer inicio puede tardar ~30 segundos mientras se instalan las dependencias. Si tu cliente MCP agota el tiempo de espera, ejecuta el comando una vez en una terminal para calentar la caché y luego vuelve a conectar.

Opción 2: Instalación global

Instala el paquete globalmente para un inicio más rápido, luego ejecuta ironwallet-mcp.

npm install -g @ironwallet/mcp-server@latest

Guías de configuración

Solo para escritorio

Cada cliente tiene una URL estática dedicada (por ejemplo, /ai/introduction/vscode/). Todos los comandos de instalación a continuación también están integrados en esta página; sin pestañas, nada oculto tras clics.

Cursor

El más recomendado

El más recomendado

Funciona bien con la versión gratuita, instalación fácil, mejor experiencia

Abrir en Cursor

Instala una vez. Después de eso, las herramientas de billetera están disponibles en cada chat. También puedes pegar esto en ~/.cursor/mcp.json y reiniciar Cursor.

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Recarga Cursor después de la instalación para que PATH incluya npx.

Página independiente para Cursor — una petición HTTP devuelve solo esta guía.

Claude Code

Requiere mayor nivel de experto

Funciona bien con el modo Código, el modo Chat es muy limitado

Abrir en Claude Code

Ejecuta estos comandos en orden:

1claude plugin marketplace add ironwallet/ironwallet-agent-kit
2claude plugin install ironwallet-mcp@ironwallet

Después de instalar el plugin, espera ~45 segundos e inicia un nuevo chat para que las herramientas se carguen.

O apunta Claude Code al servidor stdio directamente:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Página independiente para Claude Code — una petición HTTP devuelve solo esta guía.

VS Code

Nivel de experto más alto

Requiere plugins adicionales con la versión paga de modelos de IA

Abrir en VS Code

Abre VS Code y registra el servidor MCP local. También puedes agregar esto a tu configuración de MCP de VS Code (usuario o espacio de trabajo).

1{
2 "mcp": {
3 "servers": {
4 "ironwallet": {
5 "type": "stdio",
6 "command": "npx",
7 "args": ["-y", "@ironwallet/mcp-server"]
8 }
9 }
10 }
11}

Página independiente para VS Code — una petición HTTP devuelve solo esta guía.

ChatGPT

Configuración fácil - requiere ChatGPT

La versión gratuita es muy limitada, la versión paga funciona mejor

Abrir en ChatGPT

Ejecuta estos comandos en orden, luego recarga para que las herramientas MCP estén disponibles.

1codex plugin marketplace add ironwallet/ironwallet-agent-kit
2codex plugin add ironwallet-mcp@ironwallet

O apunta ChatGPT al servidor stdio directamente:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Página independiente para ChatGPT — una petición HTTP devuelve solo esta guía.

Otros clientes

Usa el transporte stdio. Apunta tu cliente MCP a:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

Página independiente para Otros clientes — una petición HTTP devuelve solo esta guía.

Primer inicio y configuración de la billetera

No hay inicio de sesión ni cuenta. En el primer inicio, el servidor genera sus secretos locales (una clave API de retransmisión, un secreto de envoltura del almacén de claves y un ID de dispositivo) bajo ~/.ironwallet-mcp/ con permisos exclusivos del propietario. Nada que configurar.

Para comenzar a usar una billetera:

1
Consentimiento. Antes de crear o importar una billetera, el agente muestra el aviso legal de MCP en el chat y registra tu aceptación (accept_mcp_consent), o presionas Continuar en el administrador de billeteras.
2
Crear o importar. create_wallets devuelve nombres y direcciones de billeteras además de una backup_url; ábrela en tu navegador para ver y respaldar la frase de recuperación. Para importar una billetera existente o hacer un respaldo más tarde, usa open_wallet_manager. La frase de recuperación se escribe o se muestra solo en la página del navegador local, nunca en el chat.
3
Financiar la billetera. Pídele al agente un QR de depósito (get_deposit_qr) o una dirección (list_wallets) y envía una pequeña cantidad. Mantén el saldo limitado; esta es una billetera caliente.

Datos en disco

El servidor mantiene su estado en ~/.ironwallet-mcp/ (se puede anular con IW_KEYSTORE_DIR):

el almacén de claves cifrado con tus semillas de billetera,

el secreto de envoltura, la clave API de retransmisión y el ID del dispositivo,

registros de diagnóstico bajo logs/ (el material de la semilla nunca se registra).

Advertencia: no elimines este directorio para "restablecer" el servidor.

Contiene las claves cifradas de tus fondos. Si lo eliminas sin haber respaldado la frase de recuperación en el administrador de billeteras, los fondos se perderán. Tu respaldo es la frase de recuperación, no estos archivos.

Cualquier persona con el almacén de claves y el secreto de envoltura controla los fondos, así que trata el directorio como sensible.

Variables de entorno

La mayoría de los usuarios no necesitan establecer ninguna variable de entorno. El servidor genera y almacena todo lo que necesita en el primer inicio. Las siguientes están disponibles para uso avanzado:

Variable
Descripción
Predeterminado
IW_READ_ONLY
Rechazar send_transfer y execute_swap en todo el proceso. Distinto de la policy.readOnly por billetera
false
IW_KEYSTORE_DIR
Directorio del almacén de claves
~/.ironwallet-mcp
IW_PASSPHRASE
Anular el secreto de envoltura del almacén de claves
generated locally
IW_RELAY_API_KEY
Anular la clave API de retransmisión
generated UUID
IW_HTTP_TIMEOUT_MS
Tiempo de espera HTTP general
15000
IW_HTTP_FORWARD_TIMEOUT_MS
Tiempo de espera para llamadas de estilo difusión. Un tiempo de espera del cliente no siempre significa que la operación falló; verifica el estado
60000
IW_LOG_ENABLED
Diagnósticos JSONL a un archivo de registro (0 para desactivar)
1
IW_LOG_LEVEL
debug / info / warn / error
info

Seguridad

Las semillas nunca abandonan esta máquina. Están cifradas en reposo y nunca aparecen en los resultados de las herramientas, el chat del agente, los registros o las solicitudes de backend. Ninguna herramienta acepta ni devuelve una semilla; la importación y el respaldo ocurren solo en el navegador local.

El agente puede mover fondos sin preguntar de nuevo. No hay interfaz de confirmación por transacción; tu mensaje de chat es la autorización. Las transferencias e intercambios son irreversibles una vez transmitidos.

Límites opcionales. Política por billetera (readOnly, maxPerTxUsd, lista de permitidos de destinatarios) mediante set_wallet_policy, y IW_READ_ONLY=true para todo el servidor. Ambos están desactivados por defecto.

Solo billetera caliente. No importes tu billetera principal o de ahorros. Cualquier persona con el almacén de claves y el secreto de envoltura controla los fondos; una semilla filtrada no puede ser revocada.

El tiempo de espera no es un fallo. Consulta get_operation_status / get_swap_status antes de reintentar un envío o intercambio.

Todas las solicitudes de backend usan HTTPS; los archivos de secretos locales usan permisos exclusivos del propietario (Unix 0600, ACL de NTFS en Windows).

Divulgación de vulnerabilidades: SECURITY.md.

Pruebas

Prueba el servidor directamente usando el inspector MCP. Esto abre una interfaz web interactiva donde puedes probar llamadas a herramientas sin un asistente de IA.

npx @modelcontextprotocol/inspector npx -y @ironwallet/mcp-server

Solución de problemas

El cliente MCP agota el tiempo de espera en el primer inicio

npx descarga el paquete en la primera ejecución, lo que puede tardar ~30 segundos.

  • Ejecuta npx -y @ironwallet/mcp-server una vez en una terminal para calentar la caché, luego vuelve a conectar.
  • O instala globalmente: npm install -g @ironwallet/mcp-server@latest.

Las herramientas no aparecen en el cliente

  • Verifica que Node.js 20+ esté instalado: node --version.
  • Recarga el cliente después de la instalación para que PATH incluya npx.
  • Después de una instalación de plugin (Claude Code / ChatGPT), inicia un nuevo chat para que las herramientas se carguen.
  • Verifica que el archivo de configuración contenga JSON válido y reinicia el cliente.
  • Prueba el servidor manualmente con el inspector MCP (ver Pruebas).

create_wallets devuelve needs_consent

El aviso legal de MCP aún no ha sido aceptado. Pídele al agente que muestre el aviso completo y confirma (accept_mcp_consent), o abre el administrador de billeteras y presiona Continuar.

Una transferencia o intercambio agotó el tiempo de espera

Un tiempo de espera no es un fallo; la transacción puede haber sido transmitida. Consulta get_operation_status (transferencias) o get_swap_status (intercambios) antes de reintentar. Nunca vuelvas a enviar a ciegas.

Un envío o intercambio es rechazado

  • Verifica list_wallets → policy: readOnly o una lista de permitidos de destinatarios puede estar bloqueando la operación. { enabled: false } significa que no hay límites.
  • maxPerTxUsd falla de forma cerrada: si no hay una tasa en USD disponible para el activo, la operación es rechazada.
  • Verifica si el servidor se ejecuta con IW_READ_ONLY=true.