# Base Token Factory MCP

Deploy ERC-20 tokens on Base mainnet via the SimpleTokenFactory contract. One command, one token.

## Quick Start

Add to your `.mcp.json`:

```json
{
  "mcpServers": {
    "base-token-factory": {
      "command": "npx",
      "args": ["-y", "base-token-factory-mcp"],
      "env": {
        "RPC_URL": "https://mainnet.base.org",
        "DEPLOYER_PRIVATE_KEY": "your-key-here"
      }
    }
  }
}
```

`DEPLOYER_PRIVATE_KEY` is only needed for `deploy_token`. Read-only tools work without it.

## Tools

| Tool | Description |
|------|-------------|
| `deploy_token` | Deploy a new ERC-20 (name, symbol, supply, decimals, recipient). Fee: 0.0005 ETH |
| `get_deployment` | Get deployment details by ID |
| `get_deployer_tokens` | List all tokens deployed by an address |
| `get_factory_info` | Factory stats — fee, total deployed, treasury |
| `get_token_info` | Token details — name, symbol, supply, holder balance |

## Contract

- **Factory**: [`0x39D878F6c3AABFAe898ee1B2Bd5f2949784181F1`](https://basescan.org/address/0x39D878F6c3AABFAe898ee1B2Bd5f2949784181F1)
- **Chain**: Base mainnet (chainId 8453)
- **Fee**: 0.0005 ETH per deploy

## License

MIT