TokenTool MCP

Implementa y gestiona tokens conformes desde Claude, Cursor o cualquier agente de IA — escribiendo una oración.

Documentación

TokenTool MCP

Implementa y gestiona tokens conformes desde Claude, Cursor o cualquier agente de IA — simplemente escribiendo una frase.

Construido sobre Bitbond TokenTool — más de 8.300 implementaciones, contratos auditados por CertiK y conformidad incorporada.

TokenTool MCP Demo

Míralo en acción

"Deploy a token called Green Bond A, 1M supply on Base, with whitelist and pausable."

→ ERC-20 auditado por CertiK implementado en cadena en ~30 segundos. Se devuelve la dirección del contrato. No se requiere Solidity.

Instalación

Claude Desktop

Añade a ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "token-tool": {
      "command": "npx",
      "args": ["-y", "token-tool-mcp"],
      "env": {
        "BITBOND_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Cursor

→ Instalación con un clic para Cursor

O añádelo manualmente a .cursor/mcp.json:

{
  "mcpServers": {
    "token-tool": {
      "command": "npx",
      "args": ["-y", "token-tool-mcp"],
      "env": {
        "BITBOND_PRIVATE_KEY": "0x..."
      }
    }
  }
}

VS Code

→ Instalación con un clic para VS Code

O añádelo a .vscode/mcp.json en tu espacio de trabajo:

{
  "servers": {
    "token-tool": {
      "command": "npx",
      "args": ["-y", "token-tool-mcp"],
      "env": {
        "BITBOND_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Claude Code

claude mcp add token-tool -- npx -y token-tool-mcp

Luego configura tu clave en el entorno: export BITBOND_PRIVATE_KEY=0x...

Ejemplos de prompts

Una vez conectado, prueba estos:

Prompt	Qué sucede
"Implementa un token de gobernanza llamado DAO Vote, con suministro de 10M en Polygon, acuñable y quemable"	Implementa un ERC-20 auditado con acuñación y quema habilitadas
"Estima el costo de implementar en Arbitrum vs Base"	Devuelve estimaciones de gas + tarifas para ambas cadenas
"Acuña 500K tokens más a 0x1234..."	Acuña a la dirección objetivo y confirma la transacción
"Pausa todas las transferencias en el contrato 0xabcd..."	Activa la parada de emergencia
"Muéstrame todo lo que he implementado"	Enumera todos los tokens del registro local
"Implementa un token de seguridad RWA en Ethereum con lista blanca, transferencia forzada y URI de documento que enlace al prospecto"	Token de cumplimiento completo con restricciones para inversores y referencia a documento legal

Herramientas

17 herramientas en todo el ciclo de vida del token:

Herramienta	Descripción
`deploy_token`	Implementa un ERC-20 auditado por CertiK con funciones de cumplimiento opcionales
`estimate_cost`	Cotiza el costo de implementación (gas + tarifa) antes de comprometer fondos
`list_chains`	Enumera las 12 redes compatibles con sus IDs de cadena y alias
`get_token_info`	Estado en vivo del token en cadena: nombre, símbolo, suministro, estado de pausa, propietario
`list_deployed_tokens`	Registro local completo de implementaciones
`mint_tokens`	Acuña suministro adicional a cualquier dirección
`burn_tokens`	Destruye tokens de forma permanente
`pause_token`	Parada de emergencia: detiene todas las transferencias de inmediato
`unpause_token`	Reanuda las transferencias después de una pausa
`transfer_tokens`	Envía tokens a cualquier dirección
`get_wallet_info`	Dirección de la wallet del implementador y saldo nativo
`add_to_whitelist`	Añade direcciones a la lista blanca del token (admite lotes)
`remove_from_whitelist`	Elimina direcciones de la lista blanca del token
`get_whitelist`	Consulta el estado de la lista blanca y todas las direcciones permitidas
`add_to_blacklist`	Bloquea una dirección de las interacciones con el token
`remove_from_blacklist`	Desbloquea una dirección previamente bloqueada
`get_compliance_status`	Verifica la configuración de lista blanca y lista negra de un token

Redes compatibles

EVM (8): Ethereum · Polygon · BNB Chain · Arbitrum · Base · Optimism · Avalanche · Peaq

No EVM (2): Solana (tokens SPL) · Stellar (activos de Stellar)

Testnets (5): Sepolia · Base Sepolia · BNB Testnet · Solana Devnet · Stellar Testnet

Los alias fáciles de recordar funcionan en todas partes: eth, polygon, bnb, arb, base, op, avax, peaq, sol, stellar

Funciones de cumplimiento

Indicadores opcionales en cada implementación: las funciones que necesitan los emisores institucionales y las plataformas RWA:

Función	Indicador	Qué hace
Lista blanca	`--whitelist`	Solo las direcciones aprobadas pueden poseer o recibir tokens
Lista negra	`--blacklist`	Bloquea direcciones específicas de cualquier interacción
Pausable	`--pausable`	El propietario puede congelar todas las transferencias al instante
Transferencia forzada	`--force-transfer`	El propietario puede mover tokens entre direcciones (recuperación regulatoria)
URI de documento	`--document-uri`	Adjunta un prospecto, hoja de términos o documento legal en cadena
Límite máximo de suministro	`--max-supply`	Tope máximo del suministro total, aplicado a nivel de contrato

Cómo funciona

You (natural language) → MCP Client (Claude/Cursor/VS Code) → TokenTool MCP Server (local)
    → Bitbond TokenTool API → Smart contract factory → On-chain deployment

Escribes un prompt en tu cliente MCP
El cliente llama a la herramienta adecuada en el servidor MCP local (transporte stdio: nada sale de tu máquina hasta el paso 3)
El servidor MCP construye una transacción de implementación y la envía a la fábrica de contratos inteligentes TokenTool de Bitbond en la cadena de destino
La fábrica implementa un contrato ERC-20 auditado por CertiK con tus parámetros
La dirección del contrato y el hash de la transacción se devuelven a tu cliente MCP

Tu clave privada firma las transacciones localmente. Se lee desde una variable de entorno, nunca se pasa como argumento y nunca se transmite a Bitbond ni a terceros. El propio servidor MCP no tiene estado: el único estado local es un registro de implementaciones opcional en data/registry.json.

CLI

TokenTool MCP también funciona como CLI independiente para scripts, CI/CD y agentes que no son MCP:

# List all supported chains
token-tool chains

# Estimate cost before deploying
token-tool cost --chain base

# Deploy a token
token-tool deploy \
  --chain base \
  --name "My Token" \
  --symbol MTK \
  --supply 1000000 \
  --mintable \
  --pausable

# Post-deployment management
token-tool mint --chain base --address 0x... --to 0x... --amount 500000
token-tool burn --chain base --address 0x... --amount 10000
token-tool pause --chain base --address 0x...
token-tool info --chain base --address 0x...

# View your deployment history
token-tool registry

Todos los comandos generan JSON estructurado. Instálalo globalmente con npm install -g token-tool-mcp para usar token-tool directamente.

Indicadores de implementación

Indicador	Descripción
`--chain`	Red de destino (consulta los alias anteriores)
`--name`	Nombre del token
`--symbol`	Símbolo del token
`--supply`	Suministro inicial (legible para humanos, p. ej., `1000000`)
`--decimals`	Decimales (predeterminado: 18)
`--mintable`	Habilita la acuñación después de la implementación
`--burnable`	Habilita la quema
`--pausable`	Habilita pausar/reanudar
`--whitelist`	Habilita transferencias solo con lista blanca
`--blacklist`	Habilita la lista negra de direcciones
`--force-transfer`	Habilita transferencias forzadas iniciadas por el propietario
`--document-uri`	Adjunta una URL de documento en cadena
`--max-supply`	Tope máximo del suministro total del token
`--owner`	Dirección del propietario del token (predeterminada: el implementador)

Seguridad

La clave privada permanece local. Se lee únicamente de la variable de entorno BITBOND_PRIVATE_KEY: nunca se pasa como argumento de CLI, nunca se registra, nunca se transmite
Transporte stdio. El servidor MCP se comunica con tu cliente localmente. Sin listener de red, sin puertos abiertos
Contratos auditados por CertiK. Estás implementando contratos inteligentes probados en combate, no Solidity generado
Testnet por defecto. Recomendamos comenzar en Sepolia o Base Sepolia: es gratis y funcionalmente idéntico a mainnet
Supervisión humana. Para implementaciones en mainnet ($299 cada una), activa los prompts de confirmación en tu cliente MCP antes de ejecutar transacciones

Precios

Entorno	Costo
Testnet (Sepolia, Base Sepolia, BNB Testnet)	Solo gas (~gratis)
Mainnet (todas las cadenas de producción)	$299 tarifa fija por implementación + gas

La tarifa de $299 es el precio estándar de TokenTool de Bitbond: la misma tanto si implementas a través de la interfaz web, la API o este servidor MCP. Se paga en el token nativo de la cadena (ETH, MATIC, BNB, etc.) en el momento de la implementación. Sin suscripción, sin clave de API, sin cargos por llamada.

Arquitectura

token-tool-mcp/
├── src/
│   ├── index.js          ← MCP server (stdio transport)
│   ├── cli.js            ← CLI interface
│   ├── tokenTool.js      ← Core engine (shared by CLI + MCP)
│   ├── chains.js         ← Network registry + aliases
│   ├── solana.js         ← SPL token adapter
│   └── stellar.js        ← Stellar asset adapter
├── data/
│   └── registry.json     ← Local deployment history
├── SKILL.md              ← OpenClaw agent skill descriptor
├── CHANGELOG.md
└── README.md

Construido sobre TokenTool

Bitbond TokenTool es una de las plataformas de implementación de tokens más utilizadas en Web3:

Más de 8.300 tokens implementados en redes de producción
Contratos inteligentes auditados por CertiK — informe de auditoría
Utilizado por empresas, DAOs y desarrolladores en más de 50 países
Activo desde 2020, mantenido por Bitbond GmbH (Berlín)

TokenTool MCP envuelve esta misma infraestructura de producción para agentes de IA.

Contribuciones

git clone https://github.com/thendrix-eng/token-tool-mcp
cd token-tool-mcp
npm install
node src/index.js   # start MCP server
node src/cli.js     # run CLI

Los issues y PRs son bienvenidos.

Licencia

MIT — Bitbond GmbH