Priors MCP Server已验证已精选

什么是 Priors MCP Server？

Priors MCP Server（@priors/mcp）是一个本地 MCP 服务器，为 AI 助手提供 Robinhood Chain 上的 USDG 钱包：它可以支付按 x402 定价的 API、查询余额、读取任意智能体的 Priors 信用记录，并从智能体自己的 Priors 信用额度借款和还款。

Priors 是 Robinhood Chain 上的链上信贷池，在 ERC-8004 上注册的 AI 智能体可以借入无抵押 USDG（$5 至 $500）、偿还借款，并积累任何人都能查看的公开信用记录和评分。每笔额度都由为该智能体出资的人作担保，每次还款和违约都是公开事件。项目仓库包含合约、SDK 和 CLI、这个 MCP 服务器、x402 支付辅助工具和一个智能体技能（MIT）。

如何使用 Priors MCP Server？

有两种连接方式。

只读、托管、无需密钥。 https://mcp.priors.trade/mcp（Streamable HTTP）可查询智能体的记录和评分、资金池数据、近期贷款以及 facilitator 的服务。它不持有密钥，无法发送交易。

claude mcp add --transport http priors https://mcp.priors.trade/mcp

在 Claude（网页版、桌面版、手机）中，用该 URL 添加自定义连接器；在 Cursor 或 VS Code 中，添加 "url": "https://mcp.priors.trade/mcp" 的远程服务器。

本地、使用智能体钱包。 @priors/mcp 包通过 npx 以 stdio 运行，需要 Node。它在 Robinhood Chain 主网上使用真实 USDG，因此请使用专用的智能体钱包，只存放智能体可以花费的金额。唯一的机密是钱包私钥，从 PRIORS_KEY 读取，或从 0.8.0 起从 PRIORS_KEY_FILE 指定的仅本人可读文件中读取。它永远不会从命令行读取，也不会被工具返回。没有密钥时，只有只读工具可用。

Claude Desktop

Settings → Developer → Edit Config（claude_desktop_config.json），然后重启 Claude Desktop：

{
  "mcpServers": {
    "priors": {
      "command": "npx",
      "args": ["-y", "@priors/mcp@0.9.3"],
      "env": {
        "PRIORS_KEY": "0xYOUR_AGENT_WALLET_KEY",
        "PRIORS_AGENT_ID": "1234"
      }
    }
  }
}

如需只读使用，去掉 env。

Claude Code

项目级 .mcp.json，从 shell 环境读取密钥，文件本身不含机密：

{
  "mcpServers": {
    "priors": {
      "command": "npx",
      "args": ["-y", "@priors/mcp@0.9.3"],
      "env": {
        "PRIORS_KEY": "${PRIORS_KEY}",
        "PRIORS_AGENT_ID": "${PRIORS_AGENT_ID:-}"
      }
    }
  }
}

不要把密钥本身传给 claude mcp add（例如 -e PRIORS_KEY=…），因为程序参数可以通过 ps 被其他用户看到。Priors 还提供 Claude Code 插件（/plugin marketplace add priors-agents/priors，然后 /plugin install priors@priors-agents），会安装其技能和托管的只读服务器。

Cursor 和 VS Code

在 Cursor 的 mcp.json 中，或在 VS Code MCP 配置的 servers 下，使用相同的 command、args 和 env 配置。

Priors MCP Server 的主要功能

• x402 支付：pay_url 获取 https URL，若价格不超过 max_price_usd（默认 $0.10），则用 USDG 支付其 HTTP 402。
• 信用额度：借入 USDG 到钱包并给出费用报价（dry_run 可先查看），在到期前偿还本金加费用。
• 公开声誉：在信任、付款或借款给某个智能体之前，查询其 Priors 评分（0 至 1000）和还款记录。
• 自动还款：可选择授权 AutoRepay，使每笔贷款在到期前 6 小时内从钱包自动偿还。
• 储蓄与 PT-USDG：把闲置 USDG 存入 Morpho 金库（默认为 Steakhouse USDG），或买入、卖出和赎回 Pendle 的 PT-USDG。
• 支出上限：按次和按运行周期的限制，例如 PRIORS_MAX_PRICE_USD（1.00）、PRIORS_MAX_SPEND_USD（5）和 PRIORS_MAX_BORROW_USD（25）；从 0.8.0 起还有每日限额和精确主机白名单（PRIORS_PAY_HOSTS）。
• 安全机制：涉及资金的工具被标记为破坏性操作，会说明金额，提示助手先确认，一次只运行一个，并且不会为仍在处理中的同一次购买签署第二笔付款。

Priors MCP Server 工具

本页面显示 19 个工具。

• 只读（提供地址或智能体 ID 时无需密钥）：wallet_balance、credit_status、score_of、stock_assets、stock_position、savings、pt_quote、pt_position 和 find_services（在 Priors facilitator 注册并接受 USDG 的服务）。
• 支付与信用（需密钥）：pay_url、borrow、repay、autopay_on 和 autopay_off。
• 储蓄（需密钥）：save 和 unsave。
• PT-USDG（需密钥）：pt_buy、pt_sell 和 pt_redeem；设置 PRIORS_PT=off 可移除 PT 工具。

Priors MCP Server 的使用场景

• 信任前先核查：“What's the Priors score of agent 6228?”
• 查看钱包：“How much USDG does my wallet hold?”
• 寻找付费 API：“Find services that sell token prices.”
• 按次付费：“Pay https://api.example.com/report, up to 5 cents.”
• 短期周转资金：“Borrow $5 for 7 days, show me the fee first.”

Priors MCP Server 常见问题排查

• 资金类工具拒绝运行：未设置密钥，或 PRIORS_KEY_FILE 指向的文件可被他人读取；此时服务器只启动只读工具，并说明需要修复的地方。
• 服务器启动即退出：命令行中出现形似密钥的参数、同时设置了 PRIORS_KEY 和 PRIORS_KEY_FILE、设置了每日限额却没有 PRIORS_AGENT_ID，或 PRIORS_PAY_HOSTS 中含通配符，都会导致退出。
• 找到的智能体不对：自动查找只能找到 v2 部署后铸造给该钱包的身份；对于较早的、购买的或转入的身份，请设置 PRIORS_AGENT_ID。