mpp32-mcp-server

MPP32

AI Agent 的支付层

安装一次，即可通过 Agent 在 Solana 上向任何 x402 端点付款。浏览包含数千个可由机器付费调用的 API 的联邦索引，无需设置任何服务提供方账户。

当前可用功能

支付通道	状态	网络	资产
x402	生产可用	Solana（主网）	USDC
x402	生产可用	Base	USDC
Tempo	生产可用	Tempo（主网，链 ID 4217）	pathUSD
AP2 / AGTP	生产可用（授权和身份层）	与链无关	依协议而定
ACP	信封已接入，生产环境中已禁用	多链	结账会话

MCP 服务开箱即提供 Solana、Base 和 Tempo 的签名器。当付费调用返回 402 时，服务会选择与您配置的密钥匹配的支付通道，并通过一次往返完成结算。MPP32_SOLANA_PRIVATE_KEY 用于在 Solana 上通过 x402 付款；MPP32_PRIVATE_KEY（以 0x 为前缀的 EVM 密钥）用于在 Base 上通过 x402 付款，以及应对 Tempo pathUSD 支付请求。

免费额度：每天 10 次调用，无需钱包

每个 Agent 会话每天可免费调用 10 次 Intelligence Oracle，无需钱包、USDC 或支付设置。只需设置 MPP32_AGENT_KEY（免费、即时获取、无需注册，访问 mpp32.org/agent-console），即可开始调用 get_solana_token_intelligence。免费额度于每天 UTC 午夜重置。

这样一来，您可以在投入任何加密货币之前，端到端测试完整的 MCP 集成。构建可用原型、评估数据质量并部署到生产环境——免费额度足以长期满足常见的开发和轻度使用需求。

免费额度用完后：每次查询收费 $0.008，通过 x402 支付（Solana 上的 USDC）。M32 持有者最高可节省 40%。

快速匿名测试（完全无需密钥）

try_solana_token_intelligence_free 工具无需任何配置即可返回相同的数据，只需安装并调用。按每个 IP 每分钟 10 次限流。适合快速体验；如需实际使用，使用 Agent 密钥的每日 10 次免费额度更合适。

为什么它优于自行构建集成

大多数 Agent 技术栈只做到“模型可以调用函数”。一旦函数需要付费，这种方案就行不通了。当 Agent 需要高级数据、付费模型、交易信号或代币分析调用时，您又得回头创建账户、存储 API 密钥、监控预算，并为每个服务提供方编写自定义 402 处理逻辑。

MPP32 用一个 MCP 服务替代这一切。Agent 按名称请求服务。服务会在包含数千个可由机器付费调用的 API 的联邦目录中找到目标，协商成本最低的协议，使用您自己设备上的密钥签署付款，并返回数据。您无需编写任何计费代码，也无需管理任何服务提供方账户。您的 Agent 会变得更快、成本更低，还能访问其他 Agent 无法触及的服务。

安装完成后，Agent 可以做什么

• 浏览涵盖代币情报、市场数据、网络搜索、图像生成、嵌入、DeFi 分析、钱包评分、链上查询和交易信号等类别的实时目录，目录中有 4,500 多种付费和免费 API。
• 使用最合适的协议向目录中的任意提供商付款，结算可在几秒内完成。
• 运行实时 Solana 代币情报分析，包括 Alpha 评分、Rug 风险、巨鲸资金流向和 24 小时暴涨概率。
• 查询实时 PIVX DAO 治理数据：活跃提案、主节点投票统计、预算分配和网络通缩指标——全部免费，无需付款密钥。
• 在 mpp32.org 的仪表板中追踪每次调用、每笔结算金额和每种使用的协议。
• 钱包验证通过后，持有 M32 即可自动享受原生服务 20% 或 40% 的折扣。
• 使用由 M32 持仓门槛控制的专属 API：Whale Tracker（1M M32）、Token Comparison（2.5M M32）和 Portfolio Scanner（5M M32）——持有者免费使用，非持有者无法使用。

安装

npx -y mpp32-mcp-server@latest

Claude Desktop、Claude Code、Cursor、Windsurf

将以下内容添加到客户端配置中的 MCP 服务部分。

{
  "mcpServers": {
    "mpp32": {
      "command": "npx",
      "args": ["-y", "mpp32-mcp-server@latest"],
      "env": {
        "MPP32_AGENT_KEY": "mpp32_agent_…",
        "MPP32_SOLANA_PRIVATE_KEY": "<your base58 Solana secret key>"
      }
    }
  }
}

配置文件位置：

• Claude Desktop（macOS）： ~/Library/Application Support/Claude/claude_desktop_config.json
• Claude Desktop（Windows）： %APPDATA%\Claude\claude_desktop_config.json
• Cursor： ~/.cursor/mcp.json
• Windsurf： ~/.codeium/windsurf/mcp_config.json

编辑后，请完全退出并重新打开客户端。启动时，MCP 子进程会继承此文件中的环境变量。

前往 mpp32.org/agent-console 获取 MPP32_AGENT_KEY。无需注册，也无需提供电子邮件，只需点击 Create Agent Session，表单就会返回一个密钥，以及这段可直接复制的完整配置片段。使用 Agent 密钥后，每次调用都会归属到你的仪表板，因此你可以查看支出、成功率和协议明细。没有密钥时，服务仍可运行，但你只能看到原生服务，调用也会保持匿名。

MPP32_SOLANA_PRIVATE_KEY 仅用于付费服务。目录中的免费服务无需任何付款密钥即可使用。

MPP32_SOLANA_PRIVATE_KEY 应采用什么格式？

它是经过 base58 编码的 64 字节 Solana 私钥。与 Phantom 在 export private key 下显示的字符串相同（不是助记词）。如果你有 keypair.json（Solana CLI 使用的 64 字节数组），可使用以下命令转换一次：

node -e "console.log(require('bs58').encode(Buffer.from(JSON.parse(require('fs').readFileSync('keypair.json')))))"

然后将生成的字符串粘贴到 env 块中。请像对待密码一样妥善保管。它可以动用钱包中的所有 USDC 和 SOL。

为钱包同时充值 USDC 和 SOL

x402 使用 USDC 结算付款，但 Solana 网络本身会对每笔交易收取少量原生 SOL 手续费。即使 USDC 余额充足，仅有 USDC 的钱包也会因 insufficient funds for rent 而失败。约 0.001 SOL 可支付多次调用的费用。

提示：在 Claude 中调用 get_mpp32_diagnostics 工具。它会探测 API，报告哪些环境变量实际传入了 MCP 进程，并在所有配置就绪后显示 Ready to pay: YES。

配置

变量	使用场景	功能
MPP32_AGENT_KEY	建议配置	来自 mpp32.org/agent-console 的会话密钥。解锁完整的联合目录并启用仪表板跟踪。也可使用 MPP32_API_KEY。
MPP32_SOLANA_PRIVATE_KEY	在 Solana 上进行付费 x402 调用	Base58 编码的 Solana 密钥。用于在本地签署 USDC 付款。绝不会离开你的设备。
MPP32_PRIVATE_KEY	在 Base 上进行付费 x402 调用	以 0x 为前缀的 EVM 私钥。当服务提供方只接受 EVM 时，用于在 Base 上签署 USDC 付款。
MPP32_PREFERRED_NETWORK	可选覆盖项	配置了两个密钥且挑战信息公布了多个网络时，强制使用其中一个。可接受 solana、base、evm 或完整的 CAIP-2 字符串。
MPP32_SOLANA_RPC_URL	可选	覆盖构建 x402 交易时用于获取近期区块哈希的 Solana RPC 端点。默认值为 https://api.mainnet-beta.solana.com。如果遇到公共速率限制，请设置此项。
MPP32_TIMEOUT_MS	可选	所有出站 API 调用的请求超时时间，单位为毫秒。范围为 1000 到 300000。默认值为 30000（30 秒）。
MPP32_API_URL	自定义部署	覆盖 API 基础 URL。默认值为 https://mpp32.org。

私钥保留在你的设备上。它们在本地签署付款，不会传输到 MPP32 服务。付费调用可提供其中一个或两个密钥。如果两个密钥都已提供且挑战信息公布了两个网络，则优先使用 EVM，除非设置了 MPP32_PREFERRED_NETWORK；如果只配置了一个密钥，则会自动使用对应网络。

Agent 将看到的工具

list_mpp32_services

浏览联合目录。返回原生服务、精选免费服务、x402 集市服务和 MCP 注册表条目，并提供定价、支持的协议，以及清晰的标记，说明 Agent 能否通过此 MCP 实际调用该服务，或该条目是否仅供发现。

{ "category": "token-scanner", "q": "solana", "source": "native" }

call_mpp32_endpoint

调用目录中任何可通过 HTTP 调用的服务。免费服务会立即返回结果。付费服务会返回 402 挑战；配置了付款密钥时，此工具会自动签署并重试。

{
  "slug": "mpp32-intelligence",
  "method": "POST",
  "body": { "token": "SOL" }
}

底层流程：

1. 将请求发送到 /api/agent/execute。
2. 如果服务免费，则将响应返回。
3. 如果服务付费，则读取 402 挑战。
4. 选择你的钱包能够满足要求的协议。
5. 在本地签署交易。
6. 附上收据并重试。
7. 返回数据，以及已结算金额、使用的协议和链上结算签名。

你的代码无需处理付款逻辑，也无需管理各服务提供方的密钥。

get_mpp32_diagnostics

报告 MCP 服务版本、实际传递给子进程的环境变量、将要访问的 API URL，以及实时 API 可访问性探测结果。只有检测到 Agent 密钥和至少一个签名密钥，且 API 可访问时，才会显示 Ready to pay: YES。如果出现任何异常，请先调用此工具。也可通过 debug_mpp32 使用。

get_solana_token_intelligence

实时分析任意 Solana 代币。从 DexScreener、Jupiter 和 CoinGecko 获取实时数据，并将其合并为一份报告。返回 0 到 100 的 alpha 评分、rug 风险、巨鲸活动、聪明钱信号、24 小时拉升概率、预估 ROI 区间及完整市场数据。每次调用费用为 $0.008；设置了 Solana 密钥时，将通过 x402 自动付款。

{ "token": "BONK" }

SIWS 钱包签名验证上线后，M32 持有者可享受分级折扣（持有 250k 可享 20% 折扣，持有 1M 可享 40% 折扣）。在此之前，生产环境中会关闭折扣功能，以防通过伪造钱包标头冒领折扣。M32 持有者还可独家使用三个由代币持有量门控的 API：Whale Tracker（1M M32）、Token Comparison（2.5M M32）和 Portfolio Scanner（5M M32）。这些 API 现已上线，使用时需通过 X-Wallet-Address 标头传入你的钱包地址。

get_m32_whale_tracker

针对任意 Solana 代币的 M32 门控巨鲸分析。返回持仓量排名前 20 的持有者、集中度风险、持有者分布以及买卖压力。调用者必须持有 1,000,000+ 枚 M32 代币（在链上验证余额）。符合条件的持有者可免费使用。

{ "token": "<mint-address>", "walletAddress": "<your-solana-wallet>" }

compare_tokens_m32

针对两个 Solana 代币的 M32 门控正面对比分析。并列返回 alpha 评分、跑路风险、巨鲸活动、交易量、流动性以及胜出判定。需要持有 2,500,000+ 枚 M32 代币。

{ "tokenA": "<mint-A>", "tokenB": "<mint-B>", "walletAddress": "<your-solana-wallet>" }

scan_portfolio_m32

M32 门控的完整钱包投资组合扫描。发现钱包中的所有 SPL 代币，对持仓量排名靠前的代币进行情报分析，并返回逐代币分析及汇总风险指标。需要持有 5,000,000+ 枚 M32 代币。

{ "wallet": "<wallet-to-scan>", "walletAddress": "<your-solana-wallet>" }

get_pivx_dao_intelligence

PIVX DAO 实时治理情报。返回活跃预算提案及主节点投票统计、预算分配状态、网络通缩指标和主节点网络健康状况。PIVX 是一种完全由社区治理的加密货币，主节点所有者每隔约 30 天就会对预算提案进行投票。数据直接来自 pivx.org/proposals 和 PIVX 区块链。免费使用，无需付款密钥。

{ "filter": "all" }

{ "filter": "passing", "includeStats": true }

有两个参数：

• filter（可选）— all（默认值）、passing 或 failing。按投票状态筛选提案。
• includeStats（可选，默认值为 true）— 除提案外，还包括网络概览和通缩指标。

响应包括网络概览（主节点数量、通过门槛、以 PIV 和 USD 计价的月度预算、预算分配百分比、区块高度、供应量统计）、通缩指标（未分配且永不铸造的金库 PIV、有效通胀降幅、提案费用销毁量），以及所有活跃提案的投票数、付款金额、分期信息和链接。

在 mpp32.org/governance 查看治理仪表板。

manage_agent_budget

查看、设置或重置 Agent 会话的经济熔断器。通过基础设施级预算执行，防止支出失控。

{ "action": "get" }

{ "action": "set", "budgetLimitUsd": 10.0, "velocityLimitUsd": 1.0, "alertThresholdPercent": 80 }

{ "action": "reset" }

有三种操作：

• get 返回当前预算状态：剩余余额、每小时支出速度、熔断器状态以及各服务的支出明细。
• set 配置 budgetLimitUsd（会话总支出上限）、velocityLimitUsd（每小时支出上限）和 alertThresholdPercent（预算使用达到此百分比时发出警告）。这三个参数均为可选，可以单独设置。
• reset 清除已触发的熔断器，使会话能够恢复支出。超出限制时熔断器会自动触发，并保持触发状态，直到手动重置。

也可以在创建会话时通过 mpp32.org/agent-console 上的 Agent 控制台设置预算限制，或将 budgetLimitUsd、velocityLimitUsd 和 alertThresholdPercent 传递给 POST /api/agent/sessions。

发现机制

MPP32 维护着一个机器可支付服务的联邦索引，让你的 Agent 无需自行爬取每个提供方，就能找到可用服务。索引数据来自四个来源。

来源	说明	可通过此 MCP 调用
MPP32 原生服务	通过 mpp32.org/build 注册的 API。端到端经过验证且可付款。	是
精选免费服务	人工维护的列表，包含 DexScreener、Jupiter、CoinGecko、OpenAI 等公开 API。	设置 MPP32_AGENT_KEY 后可以
x402 Bazaar	通过 Coinbase x402 facilitator 发现的资源。	仅列出。通过 x402 直接向提供方付款。
MCP Registry	来自官方 Model Context Protocol 注册表的服务。	否。通过 npx 安装，并作为独立的 stdio 服务运行。

list_mpp32_services 中的每一行都带有可调用标记，因此哪些 slug 可以传递给 call_mpp32_endpoint 一目了然。

面向自主 Agent 的会话

对于运行时间较长的工作流，MPP32 会签发有效期为 30 天的服务端会话密钥，并完整记录每次调用的账目。会话让 Agent 可以在预算内运行，而不必为每次调用都协商付款。

1. 在 mpp32.org/agent-console 创建会话，或向 /api/agent/sessions 发送请求。
2. 获取格式为 mpp32_agent_* 的密钥。
3. 将其填入 MCP 配置中的 MPP32_AGENT_KEY，或在直接 API 调用中将其作为 X-Agent-Key 发送。
4. 在仪表板中实时查看支出、延迟和协议组合。

会话具有作用域、可撤销，并且可以平稳轮换。密钥在服务器上以哈希形式静态存储，因此数据库泄露不会导致有效凭据泄露。

付款验证的实际工作方式

x402 付款通过 Solana facilitator（适用于 SVM）或 Base facilitator（适用于 EVM）在链上验证。MPP32 不托管资金。每次付费调用都会直接从调用者的钱包结算至提供商的钱包。

Tempo 付款通过代理的 mppx 集成在链上验证：客户端针对实时挑战，对 TIP-20 pathUSD 转账进行签名；服务器会在释放响应之前确认 Tempo 主网上的转账。AP2 和 AGTP 在每条付费路由上都作为实时授权与身份层运行。ACP 信封已针对合成挑战完成实现和测试，但在其结账会话客户端流程通过端到端验证之前，仍会在生产环境中保持禁用。

面向 API 提供商

只需登记一次端点，即可通过 x402 收款。MPP32 负责付款协商、链上验证、通过 OpenAPI、A2A 和 MCP 标准发布发现列表、定期健康检查以及分析仪表板。结算款会以 USDC 形式通过 Solana 或 Base 直接进入你的钱包。

在 mpp32.org/build 注册。

链接

资源	URL
网站	mpp32.org
文档	mpp32.org/docs
Playground	mpp32.org/playground
生态系统	mpp32.org/ecosystem
Agent 控制台	mpp32.org/agent-console
GitHub	github.com/MPP32/MPP32

许可证

MIT