magpie-mcp

magpie-mcp

Solana レンディングプロトコル — 保有資産を売却せずに流動性を確保。

ミームコイン、トークン化された株式、RWAを担保にSOLを借り入れ、同じ担保に利確注文やストップ注文を設定できます。すぐに流動性を確保しながら、上昇余地も維持できます。担保は引き続き自動売却できます。

Magpie Capital x402 APIを、Claude Desktop、Cursor、Windsurf、ChatGPT desktop、その他あらゆるMCP対応エージェントホスト向けのネイティブツールとして公開するMCP サーバーです。

利確、損切り、分割注文、トレーリングストップは、ローンのボルト内でオンチェーン実行されます。ローンはオープンのままで、返済した場合にのみ売却代金がウォレットに届きます。自動売却による決済は、対応する担保（ミームコイン、トークン化された株式／RWA）に対するV4ボルト内注文です。これらはスリッページ処理を経てオンチェーンで実行される自動売却注文であり、約定が保証されるものではありません。

ホストに設定ブロックを1つ追加するだけで、エージェントはMagpieのプロトコル状態の照会、借り入れのシミュレーション、クレジットスコアの取得、入金／出金トランザクションの作成、条件付き借り入れインテントの送信、自身のローンに対する自己所有のボルト内利確／損切り注文の設定を、すべて第一級のツール呼び出しとして実行できます。専用のクライアントコードもAPIキーも不要です。

Magpieプロトコル手数料の一部は**$MAGPIE**保有者向け報酬プールに積み立てられ、保有量に応じてSOLで支払われます（ステーキング不要、ロックアップなし）。70%はガバナンスで承認された（MGP-001）目標配分です。分配はガバナンスのスケジュールに従って行われます。x402の呼び出し手数料も同じ保有者報酬の仕組みに充てられます。エージェントの利用が広がるほど、保有者に還元される手数料も増加します。

提供する機能

x402エンドポイントをラップする26個のツール：

無料の読み取り（すぐに利用できます）：

• magpie_pool_state — LendingPoolアカウントの最新状態
• magpie_protocol_pulse — 24時間の集計値（アクティブなローン、取引高、清算）
• magpie_recent_activity — 匿名化された借り入れ／返済／清算のストリーム
• magpie_loan — IDで指定した単一のローン
• magpie_wallet_loans — ウォレットのすべてのローン
• magpie_tiers — プロトコルのティア定数
• magpie_simulate_borrow — 送信せずにローンを見積もり
• magpie_collateral_eligible — 担保の全カタログ
• magpie_liquidatable — 現在清算可能なローン
• magpie_credit_leaderboard — クレジットスコア上位のウォレット
• magpie_lp_state — 預入者のポジションとプールのコンテキスト
• magpie_loan_by_pda — オンチェーンのローンPDAで指定した単一のローン
• magpie_pools — Magpieレンディングプール（プログラムバージョン別のレーンとコンテキスト）
• magpie_list_exits — ウォレットに設定済みのボルト内決済注文
• magpie_modify_exit — 設定済み決済注文のトリガー／パラメーターを変更
• magpie_cancel_exit — 設定済み決済注文をキャンセル（ローンはActiveのまま）

有料（Solanaキーペアの設定が必要）：

• magpie_credit_score — 0.001 SOL
• magpie_token_risk — 0.001 SOL（トークンごとのリスクプロファイル）
• magpie_build_borrow — 0.005 SOL（V4ボルト内決済レーンを利用するには、has_exit_arming: trueを指定します）
• magpie_build_repay — 0.002 SOL
• magpie_build_deposit — 0.002 SOL
• magpie_build_withdraw — 0.002 SOL
• magpie_build_liquidate — 0.003 SOL（期限超過ローンを清算し、キーパー報奨金を受け取ります）
• magpie_create_intent — 0.01 SOL（条件付き借り入れ）
• magpie_get_intent — 0.0005 SOL（ポーリング）
• magpie_arm_exit — 0.001 SOL（自己所有のボルト内TP／SL／トレーリング決済を設定）

有料ツールを実行すると、サーバーは設定済みキーペアを使ってx402決済トランザクションにローカルで署名し、その署名をmagpie-x402に転送します。キーペアがマシンから外部に送られることはありません。

自己所有のボールト内決済（V4）

Magpie の V4 レーンでは、エージェントが自身の有効なローンに対して、自身のテイクプロフィット、ストップロス、トレーリング決済を設定できます。売却はボールト内で行われます。トリガーが発動すると、担保が自動売却され、売却代金（デフォルトでは SOL、または USDC）がローンごとの売却代金ボールト内に蓄積され、ローンは有効な状態を維持します。売却代金がウォレットに届くのは、借り手自身が署名して返済した場合のみです。発動と同時にローンを閉じることはなく、プロトコルが資金を外部へ移動する手段もありません。

• magpie_arm_exit (0.001 SOL) — 自身が所有する V4 ローンに TP / SL / トレーリング決済を設定します。direction（above = テイクプロフィット、デフォルト；below = ストップロス）と、次のトリガーのうちちょうど 1 つを設定します：target（例："2x" / "0.7x"）、price_usd、mc_usd（例："5M"、"1.2B"）、または trailing_bps（ストップロスのみ）。slippage_bps、dest（sol | usdc）、および分割決済用の slice は任意です。
• magpie_modify_exit (無料) — 設定済みの注文のトリガーやパラメーターをそのまま変更します。
• magpie_cancel_exit (無料) — 設定済みの注文を削除します。ローンには影響しません。
• magpie_list_exits (無料) — ウォレットに設定された注文を監査します。各注文にはトリガーまでの距離が表示されます。

すべての決済呼び出しは、設定済みのキーペアからローカルで生成する、依存関係不要の Ed25519 署名済みエンベロープで認証されます。magpie_arm_exit では、エンベロープに署名するキーペアと 0.001 SOL の x402 チャレンジの支払いに使うキーペアが同一であるため、ボットの payer == signer 不変条件が保たれ、ローンの所有者だけがそのローンに決済を設定できます。ボットはすべてのエンベロープに対し、5 分間の有効期間と nonce の一意性を検証します。

これらの決済に対応する借り入れを開始するには、magpie_build_borrow を has_exit_arming: true に設定して呼び出します（V4 にルーティングされます）。通常のミームコイン（V1）の借り入れには、false のままにしてください。

RWA / xStock 担保は、ローンチゲートが設定された別の V3 レーンで処理されます。V3 のローンチ時には、同じ決済ツールが RWA ローンにも対応します。

インストール

2 つの方法があります。どちらも同じ結果になります。

方法 A — npm（公開後はこちらがおすすめ）

クローンやビルドは不要で、ホスト設定に絶対パスを指定する必要もありません。

# Verify it runs once before wiring into your host:
npx -y @magpieloans/magpie-mcp --help

次に、ホスト設定に以下を追加します。

{
  "mcpServers": {
    "magpie": {
      "command": "npx",
      "args": ["-y", "@magpieloans/magpie-mcp"],
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
        "MAGPIE_MCP_PAYER_KEYPAIR": "/path/to/payer-id.json"
      }
    }
  }
}

方法 B — ソースから

npm パッケージがまだ公開されていない場合や、サーバーを開発したい場合はこちらを使います。

git clone [email protected]:magpiecapital/magpie-x402.git
cd magpie-x402/mcp
npm install
npm run build

ビルド済み実行ファイルは mcp/dist/index.js に生成されます。以下のホスト設定では絶対パスを使用してください。

ホストを設定する

使用するホストの設定例を選んでください。command + args の形式は npm インストールとソースからのビルドで異なりますが、env ブロックは同じです。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "magpie": {
      "command": "node",
      "args": ["/ABS/PATH/TO/magpie-x402/mcp/dist/index.js"],
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
        "MAGPIE_MCP_PAYER_KEYPAIR": "/ABS/PATH/TO/payer-id.json"
      }
    }
  }
}

Claude Desktop を再起動します。ツールピッカーに Magpie のツールが表示されます。

Cursor

~/.cursor/mcp.json を編集します。形式は上記の Claude Desktop と同じです。

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。形式は同じです。

ChatGPT desktop / その他の MCP 対応ホスト

同じ形式を使用します。ホストから node /ABS/PATH/.../mcp/dist/index.js を指定し、ホストの MCP 設定インターフェイスを通じて環境変数を渡してください。

無料ツールのみを使うモード（キーペアなし）

MAGPIE_MCP_PAYER_KEYPAIR を省略すると、読み取り専用の無料ツールは引き続き動作します。有料ツールと、エンベロープ署名が必要な決済ツール（magpie_arm_exit、magpie_modify_exit、magpie_cancel_exit。modify / cancel は無料ですが、エンベロープへの署名にキーペアが必要です）は、支払い元が設定されていないことを説明する明確なエラーを返します。読み取り専用の調査エージェントや、手間をかけずにまず試してみたい場合に便利です。

環境変数

変数	デフォルト	用途
MAGPIE_X402_BASE_URL	https://x402.magpie.capital	セルフホストまたはテストネットへのデプロイ用の上書き値
SOLANA_RPC_URL	https://api.mainnet-beta.solana.com	x402 の支払いトランザクションの送信に使用する RPC です。パブリック RPC は頻繁にレート制限されるため、実際に大量に使用する場合は Helius／Triton／QuickNode を使用してください。
MAGPIE_MCP_PAYER_KEYPAIR	(未設定)	標準の solana-keygen 形式の Solana キーペア JSON へのパスです。有料ツールを有効にします。

費用の上限

設定したキーペアだけが SOL の送金に使用されます。1 回あたりの費用は正確に決まり（サーバーが 402 チャレンジで要求された額を超えて支払うことはありません）、エージェントの試行中にツールが際限なく呼び出されるのが心配な場合は、支払い用ウォレットに 0.05 SOL ほどの少額を入金し、無人で補充せずに残高がなくなるまで使うようにしてください。

セキュリティモデル

• MCP サーバーはキーペアファイルを読み取りますが、変更することはありません。キーペアは起動時に一度だけメモリに読み込まれ、有料呼び出しごとの署名はローカルで行われます。マシンの外部に送信されるのは、結果として得られたトランザクション署名だけです（X-Payment ヘッダーで magpie-x402 に送信されます）。
• Magpie x402 サービスは、ユーザーに代わって署名する手段を持ちません。x402.magpie.capital が完全に侵害されたとしても、最悪の場合、役立つ結果が得られなかったツール呼び出しの費用を支払うことになります。キーペアが漏洩することはありません。
• 重大な影響を伴う書き込み処理（build-borrow、build-deposit など）では、サーバーは 未署名の トランザクションを返します。エージェントはこれをプレーンテキストで受け取り、署名して送信するかどうかはユーザーが判断します。MCP サーバー自体が署名するのは、x402 の支払い送金だけです。

トラブルシューティング

ホストの UI にツールが表示されない — 設定を編集した後、ホストを再起動してください。ほとんどのホストは起動時にのみ MCP 設定を再読み込みします。

有料ツールで 402 エラーが発生する — MAGPIE_MCP_PAYER_KEYPAIR が未設定か、ファイルが存在しません。solana-keygen new -o ~/.config/solana/magpie-mcp.json を実行してキーペアを作成し、環境変数にそのパスを設定してから、solana transfer … で少額の SOL を入金してください。

x402.magpie.capital で fetch failed が発生する — マシンから URL にアクセスできるか確認してください。社内プロキシを経由している場合は、同じ env ブロックで HTTPS_PROXY を設定してください。

有料呼び出し中に RPC のレート制限が発生する — SOLANA_RPC_URL を有料の Helius／Triton／QuickNode URL に切り替えてください。デフォルトの api.mainnet-beta.solana.com は継続的に使用すると制限されます。

メンテナー向け — npm への公開

このパッケージは追加設定なしで npm publish できるよう設定されています。mcp/ から実行します。

# One-time per machine:
npm login --scope=@magpieloans

# Each release:
# 1. Bump version in package.json (semver)
# 2. Publish — prepublishOnly rebuilds dist/ and chmod +x's the binary
npm publish

このパッケージはスコープ付き（@magpieloans/magpie-mcp）で、publishConfig.access: "public" が設定されているため、公開時に追加のフラグは不要です。files フィールドで公開対象を指定しており、tarball に含まれるのは dist/、README.md、LICENSE のみです（約 9 KB）。

公開前に内容を確認します。

npm pack --dry-run

ライセンス

MIT。