io.github.h1-hunt/mintclub

Official

by Steemhunt · TypeScript

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

Trades bonding curve tokens on Base blockchain via Mint Club protocol.

<p align="center"> <img src="https://mint.club/logo.png" alt="Mint Club" width="80" /> </p> <h1 align="center">Mint Club V2 — AI Tools</h1> <p align="center"> Trade, create, and manage <a href="https://mint.club">bonding curve tokens</a> on Base — from the terminal, AI assistants, or autonomous agents. </p> <p align="center"> <a href="https://www.npmjs.com/package/mint.club-cli"><img src="https://img.shields.io/npm/v/mint.club-cli.svg?style=flat-square&label=CLI" alt="CLI npm" /></a> <a href="https://www.npmjs.com/package/mintclub-mcp"><img src="https://img.shields.io/npm/v/mintclub-mcp.svg?style=flat-square&label=MCP" alt="MCP npm" /></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="MIT" /></a> </p>

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

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

code

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	docs.mint.club
📦 SDK	mint.club-v2-sdk
🔗 Contracts	Steemhunt/mint.club-v2-contract
💬 Community	OnChat
🐦 Twitter	@MintClubPro
🏗️ Hunt Town	hunt.town

License

MIT — built with 🏗️ by Hunt Town

Install

Configuration

Environment variables

PRIVATE_KEYrequiredsecret

Private key for the wallet used to sign transactions

claude_desktop_config.json

{
  "mcpServers": {
    "mintclub": {
      "command": "npx",
      "args": [
        "-y",
        "mintclub-mcp@0.1.1"
      ],
      "env": {
        "PRIVATE_KEY": "<YOUR_PRIVATE_KEY>"
      }
    }
  }
}