token-tool

TokenTool MCP

只需输入一句话，即可通过 Claude、Cursor 或任何 AI Agent 部署和管理代币。

基于 Bitbond TokenTool 构建：已部署 7,000 多种代币，合约经 CertiK 审计，并内置发行方控制功能（允许列表、阻止列表、暂停、强制转账）。

---

实际演示

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

→ 经 CertiK 审计的 ERC-20 约 30 秒内即可部署到链上，并返回合约地址。无需 Solidity。

---

安装

Claude Desktop

添加到 ~/.claude/claude_desktop_config.json：

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

Cursor

→ 一键安装 Cursor

或手动添加到 .cursor/mcp.json：

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

VS Code

→ 一键安装 VS Code

或添加到工作区中的 .vscode/mcp.json：

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

然后在环境中设置密钥：export BITBOND_PRIVATE_KEY=0x...

---

示例提示词

连接后，可以试试以下提示词：

提示词	执行内容
"部署一个名为 DAO Vote 的治理代币，Polygon 上发行量为 10M，支持铸造和销毁"	部署经审计且启用了铸造和销毁功能的 ERC-20
"估算在 Arbitrum 和 Base 上部署的成本"	返回这两条链的 Gas 和费用估算
"再向 0x1234... 铸造 500K 枚代币"	向目标地址铸造，并确认交易
"暂停合约 0xabcd... 上的所有转账"	启用紧急停止
"显示我部署的所有内容"	列出本地注册表中的所有代币
"在 Ethereum 上部署一个 RWA 证券型代币，支持白名单、强制转账，并通过文档 URI 链接到招股说明书"	具有投资者转账限制以及链上法律文件引用的证券型代币

---

工具

覆盖代币完整生命周期的 17 个工具：

工具	描述
deploy_token	部署经 CertiK 审计的 ERC-20，可选发行方控制功能
estimate_cost	在投入资金前估算部署成本（Gas + 费用）
list_chains	列出支持的网络（10 个生产网络、5 个测试网）及其链 ID 和别名
get_token_info	获取代币实时链上状态——名称、符号、供应量、暂停状态、所有者
list_deployed_tokens	完整的本地部署注册表
mint_tokens	向任意地址铸造额外代币
burn_tokens	永久销毁代币
pause_token	紧急停止——立即暂停所有转账
unpause_token	暂停后恢复转账
transfer_tokens	向任意地址发送代币
get_wallet_info	部署者钱包地址和原生代币余额
add_to_whitelist	将地址添加到代币白名单（支持批量操作）
remove_from_whitelist	从代币白名单中移除地址
get_whitelist	查看白名单状态及所有白名单地址
add_to_blacklist	阻止某地址与代币交互
remove_from_blacklist	解除对先前列入阻止列表地址的限制
get_compliance_status	检查代币的白名单和阻止列表配置

---

支持的网络

EVM（8 个）： Ethereum · Polygon · BNB Chain · Arbitrum · Base · Optimism · Avalanche · Peaq

非 EVM（2 个）： Solana（SPL 代币）· Stellar（Stellar 资产）

测试网（5 个）： Sepolia · Base Sepolia · BNB Testnet · Solana Devnet · Stellar Testnet

易于记忆的别名在所有地方均可使用：eth、polygon、bnb、arb、base、op、avax、peaq、sol、stellar

---

发行方控制

每次部署都可以使用这些可选标志，满足机构发行方和 RWA 平台的需求。这些工具用于发行方自身的合规流程；代币本身并不能使发行行为合规。

功能	标志	功能说明
白名单	--whitelist	只有获批地址才能持有或接收代币
黑名单	--blacklist	阻止特定地址进行任何交互
可暂停	--pausable	所有者可以立即冻结所有转账
强制转账	--force-transfer	所有者可以在地址之间转移代币（用于监管要求下的资产追回）
文档 URI	--document-uri	在链上附加招股说明书、条款清单或法律文件
最大供应量上限	--max-supply	在合约层面强制执行的总供应量硬性上限

---

工作原理

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

1. 在 MCP 客户端中输入提示词
2. 客户端在 本地 MCP 服务上调用相应工具（stdio 传输——直到步骤 3 之前，任何内容都不会离开你的设备）
3. MCP 服务构建部署交易，并将其提交到目标链上的 Bitbond TokenTool 智能合约工厂
4. 工厂部署一个带有你所设参数、经 CertiK 审计的 ERC-20 合约
5. 合约地址和交易哈希会返回给你的 MCP 客户端

你的私钥在本地签署交易。 私钥从环境变量读取，不会作为参数传递，也不会传输给 Bitbond 或任何第三方。MCP 服务本身是无状态的——唯一的本地状态是可选的部署注册表 data/registry.json。

---

CLI

TokenTool MCP 也可作为独立 CLI 使用，适用于脚本、CI/CD 和非 MCP Agent：

# 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

所有命令都会输出结构化 JSON。运行 npm install -g token-tool-mcp 进行全局安装，即可直接使用 token-tool。

部署标志

标志	说明
--chain	目标网络（见上方别名）
--name	代币名称
--symbol	代币符号
--supply	初始供应量（易读格式，例如 1000000）
--decimals	小数位数（默认值：18）
--mintable	启用部署后的铸造功能
--burnable	启用销毁功能
--pausable	启用暂停/恢复功能
--whitelist	启用仅限白名单地址转账
--blacklist	启用地址黑名单
--force-transfer	启用所有者发起的强制转账
--document-uri	在链上附加文档 URL
--max-supply	代币总供应量硬性上限
--owner	代币所有者地址（默认为部署者）

---

安全性

• 私钥保留在本地。 仅从 BITBOND_PRIVATE_KEY 环境变量读取——绝不作为 CLI 参数传递、绝不记录日志、绝不传输
• stdio 传输。 MCP 服务在本地与客户端通信。没有网络监听器，也不开放端口
• 经 CertiK 审计的合约。 你部署的是经过实战检验的智能合约，而非生成的 Solidity 代码
• 默认使用测试网。 建议从 Sepolia 或 Base Sepolia 开始——免费且功能上与主网完全相同
• 人在回路中。 对于主网部署（每次 $499，见定价），请在 MCP 客户端中启用确认提示，再执行交易

定价

环境	费用
测试网（Sepolia、Base Sepolia、BNB Testnet）	仅需 Gas 费（~免费）
主网（所有生产链）	每次部署收取 $499 固定费用 + Gas 费

MCP 部署的是 TokenTool 的资产代币合约（包含白名单、黑名单、强制转账和文档 URI），因此费用与 TokenTool 定价页面上的 创建资产代币 相同，无论通过 Web UI、API 还是此 MCP 服务部署均如此。estimate_cost 会在你确认前返回实时报价。费用在部署时以链的原生代币（ETH、MATIC、BNB 等）支付。无需订阅、无需 API 密钥，也不按调用次数收费。

---

架构

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

---

基于 TokenTool 构建

Bitbond TokenTool 是 Web3 中使用最广泛的代币部署平台之一：

• 已在生产网络上部署 8,300+ 个代币
• 经 CertiK 审计的智能合约 — 审计报告
• 已被 50 多个国家和地区的企业、DAO 和开发者使用
• 自 2020 年起持续运行，由 Bitbond GmbH（柏林）维护

TokenTool MCP 为 AI Agent 提供对同一生产基础设施的封装。

---

贡献

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

欢迎提交问题和 PR。

---

许可证

MIT — Bitbond GmbH