wax-mcp-full

v0.1.0 — un servidor MCP (Model Context Protocol) local para la blockchain de WAX.

Permite que un host de IA (Claude Desktop, Cursor, Grok Build, …) consulte cuentas, estado de la cadena, AtomicAssets / AtomicMarket, historial de Hyperion y precios de WAXP, y prepare transacciones sin firmar para que una cartera las firme. Sin claves API. Mainnet y testnet.

Esta es una versión pública temprana. Es más completa que el archivado yksanjo/wax-mcp-server (8 herramientas, un solo RPC, historial v1 muerto). No es una versión 1.0.

Características

También registra recursos (wax://account/{name}, …) y prompts (inspect-account, market-overview, …).

Requisitos

• Node.js 20+

• Acceso HTTPS a las API públicas de los gremios de WAX (sin claves)

Instalación

git clone https://github.com/eoinjosephcurran-code/wax-mcp-full.git
cd wax-mcp-full
npm install
npm run build
node dist/index.js --help

Dev (sin compilación):

npx tsx src/index.ts --network mainnet

Añadirlo a un host

Reemplaza /ABSOLUTE/PATH/TO/wax-mcp-full con la carpeta que clonaste.

Claude Desktop

claude_desktop_config.json:

{
  "mcpServers": {
    "wax": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js"],
      "env": { "WAX_NETWORK": "mainnet" }
    }
  }
}

Reinicia Claude Desktop.

Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "wax": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js"]
    }
  }
}

Grok Build

~/.grok/config.toml:

[mcp_servers.wax]
command = "node"
args = ["/ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js"]
startup_timeout_sec = 30

O: grok mcp add wax -- node /ABSOLUTE/PATH/TO/wax-mcp-full/dist/index.js

Las plantillas listas para copiar y pegar están en examples/.

Configuración

CLI: --network mainnet|testnet.

Solo se aceptan URLs https. Las herramientas nunca toman un argumento de URL de RPC.

eosjs no está instalado por defecto. Prefiere una cartera. wax_sign_broadcast local requiere npm install eosjs más WAX_ENABLE_SIGNING=1.

Seguridad

• Las herramientas de preparación devuelven JSON sin firmar. Firma en Anchor, WAX Cloud Wallet o cleos.

• wax_simulate_transaction nunca transmite. Los RPC públicos a menudo no pueden ejecutar en seco JSON sin firmar; entonces simulated es false.

• Nunca pongas una clave privada en el chat ni en un argumento de herramienta.

Ejemplos de prompts

• “¿Cuál es el precio de WAXP y el volumen en 24h?”

• “Muestra CPU/NET/RAM y tokens para eosio.”

• “Lista las ventas recientes de AtomicMarket para alien.worlds.”

• “Prepara una transferencia sin firmar de 1.00000000 WAX de alice a bob — no la firmes.”

Más en examples/example-prompts.md.

Pruebas

npm test           # unit + MCP smoke + live probes (skip-soft if offline)
npm run test:live  # live probes; fail if public APIs are down
npm run typecheck

Limitaciones conocidas (v0.1)

• Los nodos públicos de Atomic / Hyperion pueden ser lentos o tener límites de tasa.

• La simulación se hace con el mejor esfuerzo; muchos RPC rechazan JSON sin firmar.

• Los recursos MCP no tienen indicador isError — los fallos aparecen como JSON dentro de una lectura exitosa.

• wax_get_block devuelve cabeceras + transaction_count, no las transacciones completas.

• La firma local opcional es un arma de doble filo. Déjala desactivada.

Licencia

MIT