io.github.h1-hunt/mintclub

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:

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

Links

License

MIT — built with 🏗️ by Hunt Town