Back to Directory/Developer Tools

io.github.h1-hunt/mintclub

Trade bonding curve tokens on Base via Mint Club V2 — buy, sell, swap, create

Developer ToolsTypeScriptv0.1.1

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:

PackageDescriptionInstall
cli/mc command-line interfacenpm i -g mint.club-cli
mcp/MCP server for Claude, Cursor, etc.npx mintclub-mcp
agent-skills/Agent skill for OpenClawclawhub install mintclub
eliza-plugin/ElizaOS pluginPR #6498

Quick Start

CLI

bash
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:

json
{
  "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

bash
clawhub install mintclub

Full agent skill docs


How It Works

text
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

RegistryLink
npm (CLI)mint.club-cli
npm (MCP)mintclub-mcp
MCP Registryio.github.h1-hunt/mintclub
mcp.somint-club
ClawHubmintclub
ElizaOSPlugin PR #6498

Links

🌐 Appmint.club
📖 Docsdocs.mint.club
📦 SDKmint.club-v2-sdk
🔗 ContractsSteemhunt/mint.club-v2-contract
💬 CommunityOnChat
🐦 Twitter@MintClubPro
🏗️ Hunt Townhunt.town

License

MIT — built with 🏗️ by Hunt Town

Learn More