mintclub — Claude Code MCP server for bonding curve tokens
An MCP server that lets your agent trade Mint Club V2 bonding curve tokens: buy, sell, swap and create, straight from the chat.
claude mcp add mintclub -e PRIVATE_KEY=<PRIVATE_KEY> -- npx -y mintclub-mcpWhat mintclub does
Nine tools land in your agent: token_info, token_price, wallet_balance, buy_token, sell_token, zap_buy, zap_sell, send_token, create_token. Price checks and balance reads are the quiet half. The other half signs transactions — buying and selling against the reserve ERC-20, swapping native or ERC-20 assets through MCV2_ZapV2, sending tokens, minting a new bonding curve token. Everything runs on top of the @mint.club/v2-cli package, which reads chain-registry.json for chain keys and capability flags.
You need Node.js 18 or later and a PRIVATE_KEY in the environment. Use a dedicated wallet holding only what you are willing to lose, because the server signs with that key. Writes are fail-closed: a write tool wants the chain and assets spelled out plus confirm: true, and it should stay behind your host's approval for destructive tools. Skip either and the call goes nowhere.
Swaps route through chain RPC only. The server walks direct paths and paths with one wrapped-native or stablecoin hop, quotes Uniswap V2, V3 and V4 candidates, then takes the best exact-input result. No split routes, no mixed protocols, no hooked or dynamic-fee V4 pools. Blast is left out on purpose — it sits outside the official Uniswap deployment set this integration targets.
What it helps with
- check a bonding curve token price on a given chain
- buy a token with USDT through ZapV2 at a set slippage
- sell tokens and receive USDC in the wallet
- create a new ERC-20 bonding curve token
- read wallet balance before a trade
Example prompts for the agent
- Show me the price of token
0xTOKENon arbitrum - Buy
0xMINT_CLUB_TOKENwith 10 USDT on arbitrum, slippage 1% - Create a new bonding curve token on base
How to install mintclub
Platform CLI
claude mcp add mintclub -e PRIVATE_KEY=<PRIVATE_KEY> -- npx -y mintclub-mcpReplace <…> with your own values
Platform CLI
codex mcp add mintclub --env PRIVATE_KEY=<PRIVATE_KEY> -- npx -y mintclub-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mintclub": {
"command": "npx",
"args": [
"-y",
"mintclub-mcp"
],
"env": {
"PRIVATE_KEY": "<PRIVATE_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mintclub": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mintclub-mcp"
],
"env": {
"PRIVATE_KEY": "<PRIVATE_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e PRIVATE_KEY=<PRIVATE_KEY> mintclub npx -y mintclub-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mintclub
How do I install mintclub in Claude Code?
Run claude mcp add mintclub -e PRIVATE_KEY=<PRIVATE_KEY> -- npx -y mintclub-mcp. Put your own key in place of the placeholder, ideally from a wallet with limited funds.
What does mintclub do?
It exposes Mint Club V2 tools to your agent: reading prices and balances, buying and selling bonding curve tokens, swapping through ZapV2, sending tokens and creating new ones.
What does mintclub need to run?
Node.js 18 or later plus a PRIVATE_KEY environment variable. Write operations also require an explicit chain, assets and confirm: true.
