Mint Club V2

Mint Club V2 MCP Server

10 のメインネットと 2 つのテストネットに対応し、Mint Club V2 Bond の操作と、範囲を限定したローカル Uniswap ZapV2 ルーティングを提供する MCP サーバーです。

npm パッケージ · リポジトリ · CLI リファレンス · ElizaOS プラグイン

このサーバーは処理を @mint.club/v2-cli に委譲するため、コントラクト、トークン解決、ルート検出、価格設定、トランザクションの信頼できる唯一の情報源は引き続き CLI です。チェーンキーは MCP パッケージに複製せず、CLI が公開している chain-registry.json から読み込みます。

設定

Node.js 18 以降が必要です。ほとんどの MCP クライアントでは、npx からパッケージを直接起動できます。

{
  "mcpServers": {
    "mintclub": {
      "command": "npx",
      "args": ["-y", "@mint.club/v2-mcp@2"]
    }
  }
}

グローバルインストールする場合は、npm install -g @mint.club/v2-mcp を実行し、代わりに "command": "mintclub-mcp" を使用してください。MCP パッケージは、互換性のある @mint.club/v2-cli 2.x のランタイム依存関係を自動的にインストールします。

読み取り専用ツールはウォレットなしで動作します。書き込みツールと wallet_balance には、サーバープロセス内の PRIVATE_KEY、または ~/.mintclub/.env 内のキーが必要です。MCP クライアントのシークレット／環境変数機能を通じて指定してください。専用のローカルウォレットを生成するには、CLI をインストールし、信頼できるターミナルで mc wallet --generate を実行してください。

キーをコミット対象の MCP 設定に保存したり、モデルとの会話に貼り付けたりしないでください。資金を限定した専用ウォレットを使用してください。

すべての書き込みツールでは、明示的な chain と、リテラルの構造化引数 "confirm": true が必要です。このフィールドは誤って指定が抜けるのを防ぐものであり、ユーザーの承認を証明するものではありません。破壊的操作としてマークされたツールについては、MCP ホストで対話型の承認を必須に設定してください。クライアントはこの値を設定する前に、チェーン、資産、金額、上限をすべて表示する必要があります。サーバーが確認を推測することはありません。

ツール

サーバーは、プロトコル固有のツールを 9 つ公開します。

ツール	説明
token_info	トークンの供給量、リザーブ、カーブ、価格、USD 換算値
token_price	リザーブトークン建ての価格と USD 建ての価格
wallet_balance	設定済みウォレットのチェーンごとの残高
buy_token	リザーブ ERC-20 を使用する MCV2_Bond.mint
sell_token	リザーブ ERC-20 と交換する MCV2_Bond.burn
zap_buy	正確に指定したルート入力資産 → MCV2_ZapV2.zapMint
zap_sell	MCV2_ZapV2.zapBurn → ルート出力資産
send_token	ネイティブ通貨または ERC-20 トークンの送信
create_token	ERC-20 ボンディングカーブトークンの作成

create_token では、名前、シンボル、リザーブ、最大供給量に加えて、curve、initialPrice、finalPrice が必要です。ミントとバーンのロイヤルティには、CLI のデフォルトである 100 ベーシスポイント（1%）を使用します。異なるロイヤルティが必要な場合は、CLI を直接使用してください。

このツールは CLI を通じてオンチェーンでトークンを作成します。ロゴやウェブサイトのリンクは、作成者ウォレットを使用して Mint Club で作成後に設定してください。CLI のメタデータに関するガイダンスを参照してください。匿名のメタデータ API 呼び出しは必要ありません。

読み取りツールでは、正規の chain プロパティを任意で指定できます。デフォルトは Base です。すべての書き込みツールでは、chain の明示的な指定が必要です。対応する値は次のとおりです。

ethereum · optimism · arbitrum · avalanche · base · polygon · bsc · zora · unichain · robinhood · sepolia · base-sepolia

この連携では Blast はサポートされていません。

send_token では、資産を示す token も明示的に指定する必要があります。選択したチェーンのネイティブ通貨にはリテラルの "NATIVE" を使用してください。それ以外の場合は、ERC-20 のシンボルまたはアドレスを指定します。

ZapV2 の入力

zap_buy には次の入力が必要です。

{
  "chain": "arbitrum",
  "token": "0xMINT_CLUB_TOKEN",
  "inputToken": "USDT",
  "inputAmount": "10",
  "slippage": "1",
  "confirm": true
}

任意の minTokens は Mint Club トークン単位で指定します。inputAmount は厳密な値です。

zap_sell には次の入力が必要です。

{
  "chain": "unichain",
  "token": "0xMINT_CLUB_TOKEN",
  "amount": "100",
  "outputToken": "USDC",
  "slippage": "1",
  "confirm": true
}

任意の minOutput は出力アセット単位で指定します。amount は Mint Club トークンの正確なバーン量です。

zap_buy または zap_sell に渡す Mint Club トークンは ERC-20 または ERC-1155 です。ERC-1155 の数量は整数である必要があります。ルーティングされる入力アセットと出力アセットは、ネイティブ通貨または ERC-20 トークンである必要があります。

CLI は、設定されている場合、直接ルートと中継地点が 1 つの同種 V2／V3／V4 候補を列挙し、それらの候補の中から厳密な入力に対する出力が最大のものを選択して、Universal Router SDK でエンコードします。外部のルーティング API は呼び出さず、全体として最適なルートであるとは主張しません。

ZapV2 は、上記のサポート対象チェーンすべてにデプロイされています。デプロイ先のアドレスは @mint.club/v2-cli で管理されています。CLI のコントラクト一覧を参照してください。

リクエスト例

• 「Base の SIGNET のトークン情報を取得して。」→ token_info
• Robinhood で 100 TOKEN を購入する buy_token の呼び出し。"confirm": true を指定します。
• Arbitrum でちょうど 10 USDT を使用する zap_buy の呼び出し。"confirm": true を指定します。
• Unichain で 50 TOKEN を USDC に交換する zap_sell の呼び出し。"confirm": true を指定します。
• Robinhood で USDG を裏付けとする My Token（MYT）を作成する create_token の呼び出し。最大供給量は 1,000,000、価格曲線は 0.01 USDG から 1 USDG までの線形で、"confirm": true を指定します。

CLI の安全な実行

ツールの引数は execFileSync の argv 配列で mc に渡されます。ユーザーの値がシェルコマンドに埋め込まれることはありません。サーバーは、書き込みツールで confirm === true を検証した後にのみ、CLI に --yes を追加します。

CLI 実行ファイルのパスを上書きするには、MINTCLUB_CLI を設定します。

開発

リポジトリのルートから実行します。

npm ci
npm --prefix mcp run check
npm --prefix mcp test
npm --prefix mcp run build

ライセンス

MIT です。公開される tarball には、プロジェクトの LICENSE と、MCP サーバーにバンドルされるすべてのパッケージを対象とする生成済みの THIRD_PARTY_NOTICES.md が含まれます。