# mintclub

An MCP server that lets your agent trade Mint Club V2 bonding curve tokens: buy, sell, swap and create, straight from the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: Steemhunt
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Steemhunt/mint.club-v2-ai
- Updated: 2026-10-04
- HTML: https://affpapa.org/en/nevibecode/mcp/mintclub

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PRIVATE_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mintclub -e PRIVATE_KEY=<PRIVATE_KEY> -- npx -y mintclub-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mintclub --env PRIVATE_KEY=<PRIVATE_KEY> -- npx -y mintclub-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mintclub": {
            "command": "npx",
            "args": [
                "-y",
                "mintclub-mcp"
            ],
            "env": {
                "PRIVATE_KEY": "<PRIVATE_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mintclub": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mintclub-mcp"
            ],
            "env": {
                "PRIVATE_KEY": "<PRIVATE_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e PRIVATE_KEY=<PRIVATE_KEY> mintclub npx -y mintclub-mcp
```
Replace <…> with your own values

## When to use it
- 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
- Show me the price of token `0xTOKEN` on arbitrum
- Buy `0xMINT_CLUB_TOKEN` with 10 USDT on arbitrum, slippage 1%
- Create a new bonding curve token on base

## Similar
- [uniswap-monitor-teneo](https://affpapa.org/en/nevibecode/skills/uniswap-monitor-teneo.md) — skill · 504 installs
- [dca-bot](https://affpapa.org/en/nevibecode/skills/dca-bot.md) — skill · 398 installs
- [index-bot](https://affpapa.org/en/nevibecode/skills/index-bot.md) — skill · 403 installs
- [deploy-uni-hook](https://affpapa.org/en/nevibecode/skills/deploy-uni-hook.md) — skill · ★ 783
- [grimoire-uniswap](https://affpapa.org/en/nevibecode/skills/grimoire-uniswap.md) — skill · 1100 installs
- [defi-skills](https://affpapa.org/en/nevibecode/plugins/defi-skills.md) — plugin · ★ 16

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md