Token Minter

What is Token Minter about?

Token Minter offers a set of MCP‑compatible tools that enable AI agents—or any automated workflow—to create, transfer, and query ERC‑20 tokens on 21 supported networks. It abstracts away low‑level contract interactions, exposing high‑level operations such as deployToken, transferToken, and getTransactionInfo.

How to use Token Minter?

1. Install dependencies

   git clone https://github.com/kukapay/token-minter-mcp.git
   cd token-minter-mcp/server
   npm install
   

2. Configure environment variables

   {
     "INFURA_KEY": "<YOUR_INFURA_KEY>",
     "PRIVATE_KEY": "<YOUR_PRIVATE_KEY>"
   }
   

3. Start the MCP server (example using npx)

   npx -y token-minter-mcp
   

4. Invoke tools via MCP prompts, e.g.
   • deployToken with parameters name, symbol, initialSupply, decimals, chainId.
   • transferToken with tokenAddress, toAddress, amount, chainId.
   • getBalance, getTokenInfo, getTransactionInfo, etc.

Key features of Token Minter

• Multi‑chain support: Works on Ethereum, Polygon, BSC, Arbitrum, Optimism and 17 other EVM‑compatible networks.
• Full token lifecycle: Deploy new ERC‑20 contracts, query metadata, check balances, and initiate transfers.
• Transaction utilities: Retrieve raw transaction details and monitor deployment status.
• Interactive prompts: Guidance tools such as deployTokenGuide help users provide required parameters.
• Resource URI: Access token metadata through token://{chainId}/{address} format.

Use cases of Token Minter

• AI‑driven finance bots that need to issue custom reward tokens on demand.
• Automated testing environments for smart‑contract developers using a local Hardhat node.
• Cross‑chain token distribution services that mint and allocate tokens on several networks simultaneously.
• Decentralized applications that let end‑users create their own utility tokens without writing Solidity code.

FAQ from Token Minter

Q: Which networks are supported? A: 21 networks including Ethereum (1), Polygon (137), BSC (56), Arbitrum (42161), Optimism (10) and many others listed in the README.

Q: Do I need an Infura key for every network? A: A single Infura project key provides access to all supported EVM networks.

Q: How are transaction fees handled? A: Fees are paid from the account associated with the provided private key on the target chain.

Q: Can I test locally? A: Yes. Run npx hardhat node and use chainId: 1337 in prompts.

Q: Is the server already running when I execute npx token-minter-mcp? A: The npx command launches the MCP server defined in the package, reading the environment variables for configuration.

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:

   git clone https://github.com/kukapay/token-minter-mcp.git
   cd token-minter-mcp/server
   

2. Install Dependencies:

   npm install
   

Configuration

{
  "mcpServers": {
    "Token-Minter-MCP": {
      "command": "node",
      "args": ["path/to/token-minter-mcp/server/index.js"],
      "env": {
        "INFURA_KEY": "your infura key",
        "PRIVATE_KEY": "your private key"
      }
    }
  }
}

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.

   Token deployment initiated on Arbitrum (chainId: 42161)!
   Name: RewardToken
   Symbol: RWD
   Decimals: 6
   Initial Supply: 5000000 tokens
   Transaction Hash: 0xabc123...
   Note: Use 'getTransactionInfo' to check deployment status.
   

   Can you tell me how much POL I have in my wallet on the Polygon network?

   Account Balance on Polygon (chainId: 137):
   Address: 0xYourAddressHere
   Balance: 25.3478 POL
   

   What’s the balance of my newly created token on Polygon?

   Token Balance on Polygon (chainId: 137):
   Address: 0xYourAddressHere
   Token: 0xYourTokenAddressHere
   Symbol: ABCD
   Balance: 10000000.00 ABCD
   

   Please transfer 150.75 USDC from my account to 0xRecipientAddressHere on Polygon."

   Transfer initiated on Polygon (chainId: 137)!
   Token: 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
   To: 0xRecipientAddressHere
   Amount: 150.75 (150.75 tokens)
   Transaction Hash: 0xdef456...
   Note: Use 'getTransactionInfo' to check transfer status.
   

   What’s the status of my token deployment transaction with hash 0xabc123... on Arbitrum?

   Transaction Info on Arbitrum (chainId: 42161):
   Hash: 0xabc123...
   From: 0xYourAddressHere
   To: Contract Creation
   Value: 0 ETH
   Status: Success
   Deployed Contract Address: 0xNewTokenAddressHere
   

   Give me the details of the token at address 0xNewTokenAddressHere on Arbitrum.

   Token Info on Arbitrum (chainId: 42161):
   Address: 0xNewTokenAddressHere
   Name: RewardToken
   Symbol: RWD
   Decimals: 6
   Total Supply: 5000000
   

   How do I deploy a token on Polygon? What details do I need to provide?

   To deploy a token on Polygon (chainId: 137), use the "deployToken" tool with these parameters:
   - name: The token's full name (e.g., "MyToken")
   - symbol: The token's ticker (e.g., "MTK")
   - initialSupply: Amount in token units (e.g., 1000000 for 1M tokens, default 1,000,000)
   - decimals: Optional number of decimals (default is 18)
   - chainId: Optional chain ID (default is 1 for Ethereum)
   

2. Local Testing:

   Intall dependencies:

   cd token-minter-mcp
   npm install
   

   Start a local Hardhat node:

   npx 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
10	Optimism	ETH
59144	Linea	ETH
8453	Base	ETH
81457	Blast	ETH
11297108109	Palm	PALM
43114	Avalanche	AVAX
42220	Celo	CELO
324	zkSync	ETH
5000	Mantle	MNT
204	opBNB	BNB
534352	Scroll	ETH
1923	Swellchain	ETH
130	Unichain	ETH
23448594291968334	Starknet	ETH
80094	Berachain	BERA
999	Hyperliquid	HYPE
146	Sonic	S
1337	Localhost	ETH

License

This project is licensed under the MIT License. See the LICENSE file for details.