token-minter-mcp

What is Token Minter MCP?

Token Minter MCP is an MCP (Multi-Chain Protocol) server designed to empower AI agents with the ability to mint and manage ERC-20 tokens across 21 different blockchains. It simplifies the process of token creation, transfer, and information retrieval, making blockchain interactions more accessible for automated systems.

How to Use Token Minter MCP

To use Token Minter MCP, you first need to install Node.js (v18.x or higher) and npm. Then, clone the repository, navigate to the server directory, and install the dependencies using npm install. Configuration involves setting up INFURA_KEY and PRIVATE_KEY in the mcpServers section of your configuration. Once set up, you can interact with the server using various tools and prompts. For local testing, you can use a Hardhat node with chainId: 1337.

Key Features of Token Minter MCP

Token Deployment: Deploy new ERC-20 tokens with customizable parameters such as name, symbol, initial supply, and decimals.
Token Metadata Query: Retrieve essential token information like name, symbol, decimals, and total supply.
Token Transfer: Initiate ERC-20 token transfers, receiving a transaction hash without immediate confirmation.
Transaction Details: Obtain detailed information about transactions using their hash.
Native Token Balance: Check the native token balance of the current account on various chains.
URI-based Metadata Access: Access token metadata conveniently via a URI format (token://{chainId}/{address}).
Interactive Deployment Guide: A prompt (deployTokenGuide) is available to assist users through the token deployment process.
Multi-Chain Support: Supports 21 different blockchains, including Ethereum, Polygon, BSC, Arbitrum, Optimism, and more.

Tools Provided:

deployToken: Deploys a new ERC-20 token.
transferToken: Transfers ERC-20 tokens.
getTransactionInfo: Retrieves transaction details.
getTokenBalance: Queries the balance of a specific ERC-20 token.
getTokenInfo: Queries ERC-20 token metadata.
getBalance: Checks native token balance.

Resources:

tokenMetadata: Exposes token metadata via token://{chainId}/{address}.

Prompts:

deployTokenGuide: Guides token deployment.

Use Cases of Token Minter MCP

Automated Token Creation: AI agents can programmatically create new ERC-20 tokens for various applications, such as loyalty programs, in-game currencies, or digital assets.
Decentralized Finance (DeFi) Automation: Automate token transfers and balance checks for DeFi strategies and operations.
Blockchain Integration for AI: Provide AI systems with direct capabilities to interact with and manage assets on multiple blockchain networks.
Testing and Development: Facilitate the testing and development of blockchain-based applications by providing a robust environment for token management.

FAQ from Token Minter MCP

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

A: To deploy a token on Polygon (chainId: 137), use the "deployToken" tool with the following 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)

Q: What are the prerequisites for running Token Minter MCP?

A: You need Node.js v18.x or higher, npm, a valid Infura API key for EVM network access, and an Ethereum private key for signing transactions.

Q: How can I check the status of a token deployment transaction?

A: You can use the getTransactionInfo tool with the transaction hash and chain ID to check the status of your deployment.

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

Clone the Repository:

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

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

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)

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.

token-minter-mcp Overview