TokenTool MCP

Implante e gerencie tokens em conformidade a partir do Claude, Cursor ou qualquer agente de IA — digitando uma frase.

Documentação

TokenTool MCP

Implante e gerencie tokens em conformidade a partir do Claude, Cursor ou qualquer agente de IA — digitando uma frase.

Construído sobre o Bitbond TokenTool — mais de 8.300 implantações, contratos auditados pela CertiK, conformidade integrada.

TokenTool MCP Demo

Veja em Ação

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

→ ERC-20 auditado pela CertiK implantado on-chain em ~30 segundos. Endereço do contrato retornado. Sem necessidade de Solidity.

Instalação

Claude Desktop

Adicione ao ~/.claude/claude_desktop_config.json:

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

Cursor

→ Instalação com um clique para Cursor

Ou adicione manualmente ao .cursor/mcp.json:

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

VS Code

→ Instalação com um clique para VS Code

Ou adicione ao .vscode/mcp.json no seu workspace:

{
  "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

Depois defina sua chave no ambiente: export BITBOND_PRIVATE_KEY=0x...

Exemplos de Prompts

Depois de conectado, experimente estes:

Prompt	O que acontece
"Implante um token de governança chamado DAO Vote, 10M de supply na Polygon, mintable e burnable"	Implanta um ERC-20 auditado com mint + burn habilitados
"Estime o custo para implantar na Arbitrum vs Base"	Retorna estimativas de gas + taxas para ambas as redes
"Minta mais 500K tokens para 0x1234..."	Mina para o endereço de destino, confirma a transação
"Pause todas as transferências no contrato 0xabcd..."	Ativa a parada de emergência
"Mostre tudo o que eu implantei"	Lista todos os tokens do registro local
"Implante um token de segurança RWA na Ethereum com whitelist, transferência forçada e URI de documento vinculado ao prospecto"	Token de conformidade completo com restrições de investidor e referência a documento legal

Ferramentas

17 ferramentas em todo o ciclo de vida do token:

Ferramenta	Descrição
`deploy_token`	Implanta um ERC-20 auditado pela CertiK com recursos de conformidade opcionais
`estimate_cost`	Cotar custo de implantação (gas + taxa) antes de comprometer fundos
`list_chains`	Listar todas as 12 redes suportadas com chain IDs e aliases
`get_token_info`	Estado on-chain do token em tempo real — nome, símbolo, supply, status de pausa, proprietário
`list_deployed_tokens`	Registro completo de implantações local
`mint_tokens`	Mint de supply adicional para qualquer endereço
`burn_tokens`	Destruir tokens permanentemente
`pause_token`	Parada de emergência — interrompe todas as transferências imediatamente
`unpause_token`	Retomar transferências após uma pausa
`transfer_tokens`	Enviar tokens para qualquer endereço
`get_wallet_info`	Endereço da carteira do deployer e saldo nativo
`add_to_whitelist`	Adicionar endereços à whitelist do token (suporte a lote)
`remove_from_whitelist`	Remover endereços da whitelist do token
`get_whitelist`	Visualizar status da whitelist e todos os endereços na whitelist
`add_to_blacklist`	Bloquear um endereço de interações com o token
`remove_from_blacklist`	Desbloquear um endereço previamente na blacklist
`get_compliance_status`	Verificar configuração de whitelist e blacklist de um token

Redes Suportadas

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

Não-EVM (2): Solana (tokens SPL) · Stellar (ativos Stellar)

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

Aliases amigáveis funcionam em todos os lugares: eth, polygon, bnb, arb, base, op, avax, peaq, sol, stellar

Recursos de Conformidade

Flags opcionais em cada implantação — os recursos que emissores institucionais e plataformas RWA precisam:

Recurso	Flag	O que faz
Whitelist	`--whitelist`	Apenas endereços aprovados podem manter ou receber tokens
Blacklist	`--blacklist`	Bloquear endereços específicos de qualquer interação
Pausável	`--pausable`	O proprietário pode congelar todas as transferências instantaneamente
Transferência Forçada	`--force-transfer`	O proprietário pode mover tokens entre endereços (recuperação regulatória)
URI de Documento	`--document-uri`	Anexar um prospecto, term sheet ou documento legal on-chain
Limite Máximo de Supply	`--max-supply`	Teto rígido no supply total, aplicado no nível do contrato

Como Funciona

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

Você digita um prompt no seu cliente MCP
O cliente chama a ferramenta apropriada no servidor MCP local (transporte stdio — nada sai da sua máquina até o passo 3)
O servidor MCP constrói uma transação de implantação e a submete à factory de contratos inteligentes do TokenTool da Bitbond na rede de destino
A factory implanta um contrato ERC-20 auditado pela CertiK com seus parâmetros
O endereço do contrato e o hash da transação são retornados ao seu cliente MCP

Sua chave privada assina transações localmente. Ela é lida de uma variável de ambiente, nunca passada como argumento e nunca transmitida à Bitbond ou a terceiros. O servidor MCP em si é stateless — o único estado local é um registro de implantações opcional em data/registry.json.

CLI

O TokenTool MCP também funciona como CLI autônomo para scripts, CI/CD e agentes não-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 os comandos geram JSON estruturado. Instale globalmente com npm install -g token-tool-mcp para usar token-tool diretamente.

Flags de Implantação

Flag	Descrição
`--chain`	Rede de destino (veja aliases acima)
`--name`	Nome do token
`--symbol`	Símbolo do token
`--supply`	Supply inicial (legível, ex.: `1000000`)
`--decimals`	Casas decimais (padrão: 18)
`--mintable`	Habilitar mint após a implantação
`--burnable`	Habilitar burn
`--pausable`	Habilitar pause/unpause
`--whitelist`	Habilitar transferências somente via whitelist
`--blacklist`	Habilitar blacklist de endereços
`--force-transfer`	Habilitar transferências forçadas iniciadas pelo proprietário
`--document-uri`	Anexar uma URL de documento on-chain
`--max-supply`	Teto rígido no supply total do token
`--owner`	Endereço do proprietário do token (padrão: deployer)

Segurança

Chave privada permanece local. Lida apenas da variável de ambiente BITBOND_PRIVATE_KEY — nunca passada como argumento de CLI, nunca registrada em log, nunca transmitida
Transporte stdio. O servidor MCP se comunica com seu cliente localmente. Sem listener de rede, sem portas abertas
Contratos auditados pela CertiK. Você está implantando contratos inteligentes testados em batalha, não Solidity gerado
Testnet por padrão. Recomendamos começar na Sepolia ou Base Sepolia — é gratuito e funcionalmente idêntico à mainnet
Humano no circuito. Para implantações em mainnet (US$ 299 cada), habilite prompts de confirmação no seu cliente MCP antes de executar transações

Preços

Ambiente	Custo
Testnet (Sepolia, Base Sepolia, BNB Testnet)	Apenas gas (~grátis)
Mainnet (todas as redes de produção)	US$ 299 taxa fixa por implantação + gas

A taxa de US$ 299 é o preço padrão do TokenTool da Bitbond — o mesmo se você implantar via interface web, API ou este servidor MCP. É paga no token nativo da rede (ETH, MATIC, BNB, etc.) no momento da implantação. Sem assinatura, sem chave de API, sem cobranças por chamada.

Arquitetura

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

Construído sobre o TokenTool

O Bitbond TokenTool é uma das plataformas de implantação de tokens mais usadas no Web3:

Mais de 8.300 tokens implantados em redes de produção
Contratos inteligentes auditados pela CertiK — relatório de auditoria
Usado por empresas, DAOs e desenvolvedores em mais de 50 países
Ativo desde 2020, mantido pela Bitbond GmbH (Berlim)

O TokenTool MCP envolve essa mesma infraestrutura de produção para agentes de IA.

Contribuindo

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

Issues e PRs são bem-vindos.

Licença

MIT — Bitbond GmbH