magpie-mcp

magpie-mcp

Solana 借贷协议——无需出售你的持仓，即可获得流动性。

以你的 memecoin、代币化股票和 RWA 为抵押借入 SOL，还可针对同一抵押品设置止盈和止损。即刻获得流动性，同时保留上涨空间：抵押品仍可自行卖出。

MCP 服务将 Magpie Capital x402 API 封装为原生工具，适用于 Claude Desktop、Cursor、Windsurf、ChatGPT desktop 及任何其他兼容 MCP 的 Agent 宿主。

止盈、止损、阶梯单、追踪止损——这些订单会在链上触发并进入你贷款的金库；贷款保持开放，只有在你还款后，收益才会转入你的钱包。在支持的抵押品（memecoin 和代币化股票／RWA）上，自动卖出退出单是 V4 金库内订单；这些订单通过滑点机制在链上触发，但不保证成交。

只需在宿主中添加一个配置块，你的 Agent 就能查询 Magpie 协议状态、模拟借款、获取信用评分、构建存入／取出交易、提交条件借款意向，并在自己的贷款中设置由自己持有的金库内止盈／止损退出单——所有操作都以一等工具调用的形式完成。无需专门编写客户端代码，也无需 API 密钥。

Magpie 协议费用的一部分会计入 $MAGPIE 持有者奖励池，并按比例以 SOL 发放（无需质押，也无锁定期）。70% 是经治理批准（MGP-001）的目标分配比例；分发按治理周期进行。x402 调用费用也会纳入同一持有者奖励机制——Agent 的采用越广泛，为持有者带来奖励的费用就越多。

提供的功能

26 个工具，封装 x402 端点：

免费读取（开箱即用）：

• 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（传入 has_exit_arming: true，即可使用 V4 金库内退出通道）
• magpie_build_repay — 0.002 SOL
• magpie_build_deposit — 0.002 SOL
• magpie_build_withdraw — 0.002 SOL
• magpie_build_liquidate — 0.003 SOL（清算逾期贷款并获得 keeper 奖励）
• magpie_create_intent — 0.01 SOL（条件借款）
• magpie_get_intent — 0.0005 SOL（轮询）
• magpie_arm_exit — 0.001 SOL（为自己持有的贷款设置金库内止盈／止损／追踪止损退出单）

付费工具触发时，服务会在本地使用你配置的密钥对签署 x402 付款交易，并将签名转发给 magpie-x402。密钥对不会离开你的设备。

自有金库内退出（V4）

Magpie 的 V4 通道允许 Agent 为自己的有效贷款设置止盈、止损和追踪退出——卖出操作会在金库内完成：触发条件满足时，抵押品会自动卖出，所得款项（默认是 SOL，也可以是 USDC）会累积在该笔贷款专属的收益金库中，同时贷款仍保持有效状态。所得款项只有在你使用自己的借款人签名还款时才会进入你的钱包。该机制不会触发后立即结清，协议也无法将你的资金转出。

• magpie_arm_exit（0.001 SOL）——为你拥有的 V4 贷款设置止盈、止损或追踪退出。设置 direction（above = 止盈，默认值；below = 止损），并且只能设置一个触发条件：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）；如需创建普通 Memecoin（V1）借款，则将其设为 false。

RWA / xStock 抵押品使用单独的 V3 通道，该通道受上线门槛限制——V3 上线后，同一套退出工具将扩展至 RWA 贷款。

安装

有两种方式，最终效果相同。

方式 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 桌面版 / 任何其他支持 MCP 的主机

使用相同的格式——将主机指向 node /ABS/PATH/.../mcp/dist/index.js，并通过主机的 MCP 配置界面传递环境变量。

仅免费模式（无需密钥对）

省略 MAGPIE_MCP_PAYER_KEYPAIR 后，只读免费工具仍可使用。付费工具以及信封签名的退出工具（magpie_arm_exit、magpie_modify_exit、magpie_cancel_exit；即使修改和取消不收费，也需要密钥对来签署信封）会返回清晰的错误信息，说明未配置付款方。适用于只读研究 Agent，或作为无门槛的首次安装方式。

环境变量

变量	默认值	用途
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	(unset)	标准 solana-keygen 格式的 Solana 密钥对 JSON 文件路径。启用付费工具。

费用上限

你配置的密钥对是 SOL 唯一可能转出的地方。每次调用的费用都是确定的（服务端支付的金额绝不会超过 402 挑战要求的金额）；不过，如果你担心 Agent 实验期间工具调用失控，可以给付款钱包存入少量 SOL，比如 0.05 SOL，让余额自然耗尽，而不要在无人看管时充值。

安全模型

• MCP 服务只读取密钥对文件，绝不会修改它。密钥对在启动时只加载到内存一次；每次付费调用的签名都在本地完成；只有生成的交易签名会离开你的计算机（通过 X-Payment 标头发送到 magpie-x402）。
• Magpie x402 服务无法代你签署任何内容。即使 x402.magpie.capital 遭到彻底入侵，最坏的情况也只是你为未获得有用结果的工具调用付费。你的密钥对不会暴露。
• 对于高风险写入操作（build-borrow、build-deposit 等），服务会返回一笔未签名交易。你的 Agent 会以纯文本形式接收它；是否签名并提交由你决定。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 字段指定了要包含的内容——最终压缩包中只有 dist/、README.md 和 LICENSE（约 9 KB）。

发布前验证内容：

npm pack --dry-run

许可证

MIT。