kukapay/token-minter-mcp

An MCP server providing tools for AI agents to mint ERC-20 tokens, supporting 21 blockchains.
Features
- Deploy new ERC-20 tokens with customizable parameters.
- Query token metadata (name, symbol, decimals, total supply).
- Initiate token transfers (returns transaction hash without confirmation).
- Retrieve transaction details by hash.
- Check native token balance of the current account.
- Access token metadata via URI.
- Interactive prompt for deployment guidance.
Tools
- **deployToken**: Deploys a new ERC-20 token (name, symbol, initialSupply, decimals, chainId).
- **transferToken**: Transfers ERC-20 tokens (tokenAddress, toAddress, amount, chainId).
- **getTransactionInfo**: Retrieves transaction details (txHash, chainId).
- **getTokenBalance**: Queries the balance of a specific ERC-20 token for the current account.
- **getTokenInfo**: Queries ERC-20 token metadata (tokenAddress, chainId).
- **getBalance**: Checks native token balance (chainId).
Resources
- **tokenMetadata**: Exposes token metadata via token://{chainId}/{address}.
Prompts
- **deployTokenGuide**: Guides token deployment with required parameters (chainId).
Prerequisites
- Node.js v18.x or higher
- npm (typically bundled with Node.js)
- A valid Infura API key for EVM network access
- An Ethereum private key for signing transactions
Installation
1. **Clone the Repository**:
2. **Install Dependencies**:
Configuration
Usage
1. **Examples**:
> I want to create a new token called 'RewardToken' with the symbol 'RWD' on Arbitrum. It should have 5 million tokens in initial supply and use 6 decimal places.
> Can you tell me how much POL I have in my wallet on the Polygon network?
> What’s the balance of my newly created token on Polygon?
> Please transfer 150.75 USDC from my account to 0xRecipientAddressHere on Polygon."
> What’s the status of my token deployment transaction with hash 0xabc123... on Arbitrum?
> Give me the details of the token at address 0xNewTokenAddressHere on Arbitrum.
> How do I deploy a token on Polygon? What details do I need to provide?
2. **Local Testing**:
Intall dependencies:
Start a local Hardhat node:
Use chainId: 1337 in your prompts to test locally.
Supported Networks
| Chain ID | Network Name | Native Token |
|----------------|--------------|--------------|
| 1 | Ethereum | ETH |
| 137 | Polygon | POL |
| 56 | BSC | BNB |
| 42161 | Arbitrum | ETH |