io.github.bitbond/token-tool

编码与调试

by bitbond

让任意 AI agent 部署合规 ERC-20 代币的工具集,含 17 个工具、覆盖 10 条链,并经 CertiK 审计。

什么是 io.github.bitbond/token-tool

让任意 AI agent 部署合规 ERC-20 代币的工具集,含 17 个工具、覆盖 10 条链,并经 CertiK 审计。

README

TokenTool MCP

npm version License: MIT Node.js ≥18 10 Networks CertiK Audited

Deploy and manage compliant tokens from Claude, Cursor, or any AI agent — by typing a sentence.

Built on Bitbond TokenTool — 8,300+ deployments, CertiK-audited contracts, compliance built in.

<p align="center"> <img src="https://raw.githubusercontent.com/thendrix-eng/token-tool-mcp/main/assets/demo-final.gif" alt="TokenTool MCP Demo" width="720"> </p>

See It in Action

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

→ CertiK-audited ERC-20 deployed on-chain in ~30 seconds. Contract address returned. No Solidity required.


Install

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

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

Cursor

→ One-click install for Cursor

Or add manually to .cursor/mcp.json:

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

VS Code

→ One-click install for VS Code

Or add to .vscode/mcp.json in your workspace:

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

Claude Code

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

Then set your key in the environment: export BITBOND_PRIVATE_KEY=0x...


Example Prompts

Once connected, try these:

PromptWhat happens
"Deploy a governance token called DAO Vote, 10M supply on Polygon, mintable and burnable"Deploys an audited ERC-20 with mint + burn enabled
"Estimate the cost to deploy on Arbitrum vs Base"Returns gas + fee estimates for both chains
"Mint 500K more tokens to 0x1234..."Mints to target address, confirms tx
"Pause all transfers on contract 0xabcd..."Activates the emergency stop
"Show me everything I've deployed"Lists all tokens from local registry
"Deploy an RWA security token on Ethereum with whitelist, force transfer, and document URI linking to the prospectus"Full compliance token with investor restrictions and legal doc reference

Tools

17 tools across the full token lifecycle:

ToolDescription
deploy_tokenDeploy a CertiK-audited ERC-20 with optional compliance features
estimate_costQuote deployment cost (gas + fee) before committing funds
list_chainsList all 12 supported networks with chain IDs and aliases
get_token_infoLive on-chain token state — name, symbol, supply, paused status, owner
list_deployed_tokensFull local deployment registry
mint_tokensMint additional supply to any address
burn_tokensPermanently destroy tokens
pause_tokenEmergency stop — halt all transfers immediately
unpause_tokenResume transfers after a pause
transfer_tokensSend tokens to any address
get_wallet_infoDeployer wallet address and native balance
add_to_whitelistAdd addresses to token whitelist (batch supported)
remove_from_whitelistRemove addresses from token whitelist
get_whitelistView whitelist status and all whitelisted addresses
add_to_blacklistBlock an address from token interactions
remove_from_blacklistUnblock a previously blacklisted address
get_compliance_statusCheck whitelist and blacklist configuration for a token

Supported Networks

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

Non-EVM (2): Solana (SPL tokens) · Stellar (Stellar assets)

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

Human-friendly aliases work everywhere: eth, polygon, bnb, arb, base, op, avax, peaq, sol, stellar


Compliance Features

Optional flags on every deployment — the features institutional issuers and RWA platforms need:

FeatureFlagWhat it does
Whitelist--whitelistOnly approved addresses can hold or receive tokens
Blacklist--blacklistBlock specific addresses from any interaction
Pausable--pausableOwner can freeze all transfers instantly
Force Transfer--force-transferOwner can move tokens between addresses (regulatory recovery)
Document URI--document-uriAttach a prospectus, term sheet, or legal document on-chain
Max Supply Cap--max-supplyHard ceiling on total supply, enforced at the contract level

How It Works

code
You (natural language) → MCP Client (Claude/Cursor/VS Code) → TokenTool MCP Server (local)
    → Bitbond TokenTool API → Smart contract factory → On-chain deployment
  1. You type a prompt in your MCP client
  2. The client calls the appropriate tool on the local MCP server (stdio transport — nothing leaves your machine until step 3)
  3. The MCP server constructs a deployment transaction and submits it to Bitbond's TokenTool smart contract factory on the target chain
  4. The factory deploys a CertiK-audited ERC-20 contract with your parameters
  5. The contract address and transaction hash are returned to your MCP client

Your private key signs transactions locally. It is read from an environment variable, never passed as an argument, and never transmitted to Bitbond or any third party. The MCP server itself is stateless — the only local state is an optional deployment registry at data/registry.json.


CLI

TokenTool MCP also works as a standalone CLI for scripts, CI/CD, and non-MCP agents:

bash
# 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

All commands output structured JSON. Install globally with npm install -g token-tool-mcp to use token-tool directly.

Deploy Flags

FlagDescription
--chainTarget network (see aliases above)
--nameToken name
--symbolToken symbol
--supplyInitial supply (human-readable, e.g. 1000000)
--decimalsDecimal places (default: 18)
--mintableEnable minting after deployment
--burnableEnable burning
--pausableEnable pause/unpause
--whitelistEnable whitelist-only transfers
--blacklistEnable address blacklisting
--force-transferEnable owner-initiated forced transfers
--document-uriAttach a document URL on-chain
--max-supplyHard cap on total token supply
--ownerToken owner address (defaults to deployer)

Security

  • Private key stays local. Read from BITBOND_PRIVATE_KEY env var only — never passed as a CLI argument, never logged, never transmitted
  • stdio transport. The MCP server communicates with your client locally. No network listener, no open ports
  • CertiK-audited contracts. You're deploying battle-tested smart contracts, not generated Solidity
  • Testnet by default. We recommend starting on Sepolia or Base Sepolia — it's free and functionally identical to mainnet
  • Human-in-the-loop. For mainnet deployments ($299 each), enable confirmation prompts in your MCP client before executing transactions

Pricing

EnvironmentCost
Testnet (Sepolia, Base Sepolia, BNB Testnet)Gas only (~free)
Mainnet (all production chains)$299 flat fee per deployment + gas

The $299 fee is Bitbond's standard TokenTool pricing — the same whether you deploy via the web UI, the API, or this MCP server. It's paid in the chain's native token (ETH, MATIC, BNB, etc.) at the time of deployment. No subscription, no API key, no per-call charges.


Architecture

code
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

Built on TokenTool

Bitbond TokenTool is one of the most widely used token deployment platforms in Web3:

  • 8,300+ tokens deployed across production networks
  • CertiK-audited smart contracts — audit report
  • Used by enterprises, DAOs, and developers in 50+ countries
  • Live since 2020, maintained by Bitbond GmbH (Berlin)

TokenTool MCP wraps this same production infrastructure for AI agents.


Contributing

bash
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 and PRs welcome.


License

MIT — Bitbond GmbH

常见问题

io.github.bitbond/token-tool 是什么?

让任意 AI agent 部署合规 ERC-20 代币的工具集,含 17 个工具、覆盖 10 条链,并经 CertiK 审计。

相关 Skills

前端设计

by anthropics

Universal
热门

面向组件、页面、海报和 Web 应用开发,按鲜明视觉方向生成可直接落地的前端代码与高质感 UI,适合做 landing page、Dashboard 或美化现有界面,避开千篇一律的 AI 审美。

想把页面做得既能上线又有设计感,就用前端设计:组件到整站都能产出,难得的是能避开千篇一律的 AI 味。

编码与调试
未扫描165.3k

网页应用测试

by anthropics

Universal
热门

用 Playwright 为本地 Web 应用编写自动化测试,支持启动开发服务器、校验前端交互、排查 UI 异常、抓取截图与浏览器日志,适合调试动态页面和回归验证。

借助 Playwright 一站式验证本地 Web 应用前端功能,调 UI 时还能同步查看日志和截图,定位问题更快。

编码与调试
未扫描165.3k

网页构建器

by anthropics

Universal
热门

面向复杂 claude.ai HTML artifact 开发,快速初始化 React + Tailwind CSS + shadcn/ui 项目并打包为单文件 HTML,适合需要状态管理、路由或多组件交互的页面。

在 claude.ai 里做复杂网页 Artifact 很省心,多组件、状态和路由都能顺手搭起来,React、Tailwind 与 shadcn/ui 组合效率高、成品也更精致。

编码与调试
未扫描165.3k

相关 MCP Server

GitHub

编辑精选

by GitHub

热门

GitHub 是 MCP 官方参考服务器,让 Claude 直接读写你的代码仓库和 Issues。

这个参考服务器解决了开发者想让 AI 安全访问 GitHub 数据的问题,适合需要自动化代码审查或 Issue 管理的团队。但注意它只是参考实现,生产环境得自己加固安全。

编码与调试
89.1k

by Context7

热门

Context7 是实时拉取最新文档和代码示例的智能助手,让你告别过时资料。

它能解决开发者查找文档时信息滞后的问题,特别适合快速上手新库或跟进更新。不过,依赖外部源可能导致偶尔的数据延迟,建议结合官方文档使用。

编码与调试
60.0k

by tldraw

热门

tldraw 是让 AI 助手直接在无限画布上绘图和协作的 MCP 服务器。

这解决了 AI 只能输出文本、无法视觉化协作的痛点——想象让 Claude 帮你画流程图或白板讨论。最适合需要快速原型设计或头脑风暴的开发者。不过,目前它只是个基础连接器,你得自己搭建画布应用才能发挥全部潜力。

编码与调试
49.5k

评论