# token-tool

Use an AI agent to deploy and manage ERC-20 tokens across supported networks. The server also estimates deployment costs and handles token controls such as pausing and address lists.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: bitbond
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bitbond/token-tool-mcp
- Updated: 2026-10-07
- HTML: https://affpapa.org/en/nevibecode/mcp/token-tool

## What it does

The server routes an agent’s request through the Bitbond TokenTool API to a smart contract factory on the chosen network. Its 17 tools cover token deployment, cost estimates, contract status, minting and burning. The agent can also inspect the deployer wallet and view tokens recorded in the local registry.

Optional controls include pausing transfers, managing allowlists and blocklists, and attaching a document URI to a contract. Supported networks include Ethereum, Polygon, Base, Solana and others. Set `BITBOND_PRIVATE_KEY` for transaction signing; the key is read locally, while deployment transactions go to the selected chain. These token controls do not, by themselves, make an offering compliant.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BITBOND_PRIVATE_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add token-tool -e BITBOND_PRIVATE_KEY=<BITBOND_PRIVATE_KEY> -- npx -y token-tool-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add token-tool --env BITBOND_PRIVATE_KEY=<BITBOND_PRIVATE_KEY> -- npx -y token-tool-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "token-tool": {
            "command": "npx",
            "args": [
                "-y",
                "token-tool-mcp"
            ],
            "env": {
                "BITBOND_PRIVATE_KEY": "<BITBOND_PRIVATE_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "token-tool": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "token-tool-mcp"
            ],
            "env": {
                "BITBOND_PRIVATE_KEY": "<BITBOND_PRIVATE_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BITBOND_PRIVATE_KEY=<BITBOND_PRIVATE_KEY> token-tool npx -y token-tool-mcp
```
Replace <…> with your own values

## When to use it
- deploy an ERC-20 with a chosen name and supply
- estimate deployment costs on a target network
- add wallet addresses to a token allowlist
- pause transfers and resume them later
- inspect contract state and deployed tokens

## Example prompts
- Deploy an ERC-20 named Green Bond with the requested supply on Base and enable an allowlist.
- Compare the deployment cost on Arbitrum and Base.
- Pause transfers for contract `0xabcd...`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md