Mint Club V2 — AI Tools

Trade, create, and manage bonding curve tokens on Base — from the terminal, AI assistants, or autonomous agents.

What is Mint Club V2?

Mint Club V2 is a permissionless bonding curve protocol on Base. Launch tokens backed by any reserve asset (HUNT, ETH, USDC) with automated pricing — no liquidity pool required. The protocol handles minting, burning, and price discovery through smart contracts.

This monorepo provides AI-ready tooling for the protocol:

| Package | Description | Install | |---------|-------------|---------| | cli/ | mc command-line interface | npm i -g mint.club-cli | | mcp/ | MCP server for Claude, Cursor, etc. | npx mintclub-mcp | | agent-skills/ | Agent skill for OpenClaw | clawhub install mintclub | | eliza-plugin/ | ElizaOS plugin | PR #6498 |

Quick Start

CLI

npm install -g mint.club-cli

mc wallet --generate              # Create a wallet
mc price SIGNET                   # Check token price
mc swap -i ETH -o HUNT -a 0.01   # Swap via Uniswap V3/V4
mc zap-buy SIGNET -i ETH -a 0.01 # Buy with any token
mc create -n "MyToken" -s MYT -r HUNT -x 1000000 --curve exponential

→ Full CLI docs

MCP Server

Add to Claude Desktop / Cursor config:

{
  "mcpServers": {
    "mintclub": {
      "command": "npx",
      "args": ["-y", "mintclub-mcp"],
      "env": { "PRIVATE_KEY": "0x..." }
    }
  }
}

10 tools: token_info · token_price · wallet_balance · buy_token · sell_token · swap · zap_buy · zap_sell · send_token · create_token

→ Full MCP docs

Agent Skill

clawhub install mintclub

→ Full agent skill docs

How It Works

User / AI Agent
      │
      ├── CLI ──────────── mc swap -i ETH -o HUNT -a 0.01
      ├── MCP Server ───── tool call → mc CLI → transaction
      ├── Agent Skill ──── reads SKILL.md → runs mc CLI
      └── ElizaOS Plugin ─ action handler → Bun.spawn(mc)
      │
      ▼
   mc CLI (mint.club-cli)
      │
      ├── Bonding Curve ── MCV2_Bond contract (buy/sell/create)
      ├── Zap ──────────── MCV2_ZapV2 (swap + bond in one tx)
      ├── Uniswap ──────── UniversalRouter V2 (V3 + V4 pools)
      └── Pricing ──────── 1inch Spot Price Aggregator (USD)
      │
      ▼
   Base L2 (Chain 8453)

Smart swap routing: mc swap auto-detects the optimal path — bonding curve buy/sell for Mint Club tokens, Uniswap V3/V4 for everything else, or zap (swap + bond) for cross-token purchases.

Directory Listings

| Registry | Link | |----------|------| | npm (CLI) | mint.club-cli | | npm (MCP) | mintclub-mcp | | MCP Registry | io.github.h1-hunt/mintclub | | mcp.so | mint-club | | ClawHub | mintclub | | ElizaOS | Plugin PR #6498 |

Links

| | | |---|---| | 🌐 App | mint.club | | 📖 Docs |

... View full README on GitHub