Token Minter MCP

1[![MseeP.ai Security Assessment Badge](https://mseep.net/mseep-audited.png)](https://mseep.ai/app/kukapay-token-minter-mcp)
2 
3# Token Minter MCP
4 
5An MCP server providing tools for AI agents to mint ERC-20 tokens, supporting 21 blockchains.
6 
7![License](https://img.shields.io/badge/license-MIT-blue.svg)
8![Node.js](https://img.shields.io/badge/Node.js-18.x-green.svg)
9![Status](https://img.shields.io/badge/status-active-brightgreen.svg)
10 
11## Features
12 
13- Deploy new ERC-20 tokens with customizable parameters.
14- Query token metadata (name, symbol, decimals, total supply).
15- Initiate token transfers (returns transaction hash without confirmation).
16- Retrieve transaction details by hash.
17- Check native token balance of the current account.
18- Access token metadata via URI.
19- Interactive prompt for deployment guidance.
20 
21### Tools
22 
23- **deployToken**: Deploys a new ERC-20 token (name, symbol, initialSupply, decimals, chainId).
24- **transferToken**: Transfers ERC-20 tokens (tokenAddress, toAddress, amount, chainId).
25- **getTransactionInfo**: Retrieves transaction details (txHash, chainId).
26- **getTokenBalance**: Queries the balance of a specific ERC-20 token for the current account.
27- **getTokenInfo**: Queries ERC-20 token metadata (tokenAddress, chainId).
28- **getBalance**: Checks native token balance (chainId).
29 
30### Resources
31 
32- **tokenMetadata**: Exposes token metadata via `token://{chainId}/{address}`.
33 
34### Prompts
35 
36- **deployTokenGuide**: Guides token deployment with required parameters (chainId).
37 
38## Prerequisites
39 
40- [Node.js](https://nodejs.org/) v18.x or higher
41- [npm](https://www.npmjs.com/) (typically bundled with Node.js)
42- A valid [Infura API key](https://infura.io/) for EVM network access
43- An Ethereum private key for signing transactions
44 
45## Installation
46 
471. **Clone the Repository**:
48   ```bash
49   git clone https://github.com/kukapay/token-minter-mcp.git
50   cd token-minter-mcp/server
51   ```
52 
532. **Install Dependencies**:
54   ```bash
55   npm install
56   ```
57 
58## Configuration
59 
60```json
61{
62  "mcpServers": {
63    "Token-Minter-MCP": {
64      "command": "node",
65      "args": ["path/to/token-minter-mcp/server/index.js"],
66      "env": {
67        "INFURA_KEY": "your infura key",
68        "PRIVATE_KEY": "your private key"
69      }
70    }
71  }
72}
73```
74 
75 
76 
77## Usage
78 
791. **Examples**:
80 
81    > 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.
82    
83    ```
84    Token deployment initiated on Arbitrum (chainId: 42161)!
85    Name: RewardToken
86    Symbol: RWD
87    Decimals: 6
88    Initial Supply: 5000000 tokens
89    Transaction Hash: 0xabc123...
90    Note: Use 'getTransactionInfo' to check deployment status.
91    ```
92 
93    > Can you tell me how much POL I have in my wallet on the Polygon network?
94 
95    ```
96    Account Balance on Polygon (chainId: 137):
97    Address: 0xYourAddressHere
98    Balance: 25.3478 POL
99    ```
100    
101    > What’s the balance of my newly created token on Polygon?
102    
103    ```
104    Token Balance on Polygon (chainId: 137):
105    Address: 0xYourAddressHere
106    Token: 0xYourTokenAddressHere
107    Symbol: ABCD
108    Balance: 10000000.00 ABCD
109    ```    
110 
111    > Please transfer 150.75 USDC from my account to 0xRecipientAddressHere on Polygon."
112 
113    ```
114    Transfer initiated on Polygon (chainId: 137)!
115    Token: 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
116    To: 0xRecipientAddressHere
117    Amount: 150.75 (150.75 tokens)
118    Transaction Hash: 0xdef456...
119    Note: Use 'getTransactionInfo' to check transfer status.
120    ```
121 
122    > What’s the status of my token deployment transaction with hash 0xabc123... on Arbitrum?
123 
124    ```
125    Transaction Info on Arbitrum (chainId: 42161):
126    Hash: 0xabc123...
127    From: 0xYourAddressHere
128    To: Contract Creation
129    Value: 0 ETH
130    Status: Success
131    Deployed Contract Address: 0xNewTokenAddressHere
132    ```
133 
134    > Give me the details of the token at address 0xNewTokenAddressHere on Arbitrum.
135 
136    ```
137    Token Info on Arbitrum (chainId: 42161):
138    Address: 0xNewTokenAddressHere
139    Name: RewardToken
140    Symbol: RWD
141    Decimals: 6
142    Total Supply: 5000000
143    ```
144 
145    > How do I deploy a token on Polygon? What details do I need to provide?
146 
147    ```
148    To deploy a token on Polygon (chainId: 137), use the "deployToken" tool with these parameters:
149    - name: The token's full name (e.g., "MyToken")
150    - symbol: The token's ticker (e.g., "MTK")
151    - initialSupply: Amount in token units (e.g., 1000000 for 1M tokens, default 1,000,000)
152    - decimals: Optional number of decimals (default is 18)
153    - chainId: Optional chain ID (default is 1 for Ethereum)
154    ```
155 
1562. **Local Testing**:
157 
158    Intall dependencies:
159    
160    ```bash
161    cd token-minter-mcp
162    npm install
163    ```
164 
165    Start a local Hardhat node:
166    
167    ```
168    npx hardhat node
169    ```
170    
171    Use chainId: 1337 in your prompts to test locally.  
172 
173## Supported Networks
174 
175| Chain ID       | Network Name | Native Token |
176|----------------|--------------|--------------|
177| 1              | Ethereum     | ETH          |
178| 137            | Polygon      | POL          |
179| 56             | BSC          | BNB          |
180| 42161          | Arbitrum     | ETH          |
181| 10             | Optimism     | ETH          |
182| 59144          | Linea        | ETH          |
183| 8453           | Base         | ETH          |
184| 81457          | Blast        | ETH          |
185| 11297108109    | Palm         | PALM         |
186| 43114          | Avalanche    | AVAX         |
187| 42220          | Celo         | CELO         |
188| 324            | zkSync       | ETH          |
189| 5000           | Mantle       | MNT          |
190| 204            | opBNB        | BNB          |
191| 534352         | Scroll       | ETH          |
192| 1923           | Swellchain   | ETH          |
193| 130            | Unichain     | ETH          |
194| 23448594291968334 | Starknet  | ETH          |
195| 80094          | Berachain    | BERA         |
196| 999            | Hyperliquid  | HYPE         |
197| 146            | Sonic        | S            |
198| 1337           | Localhost    | ETH          |
199    
200 
201## License
202 
203This project is licensed under the [MIT License](LICENSE). See the `LICENSE` file for details.
204 
205