Realmint

Realmint MCP

以 Agent 原生方式访问 Realmint 代币化现实世界资产（RWA）目录：评分、市场数据、路由支持、价格历史，以及无需密钥的 x402 买入入口 — 通过 Model Context Protocol 以原生工具形式提供。

MCP 接口从设计上就保障密钥安全。目录为只读。两种交易路径仅在获得你本人授权后才会转移资金，且绝不会接触原始密钥：

• 无需密钥的 x402 买入 — 自带 EVM 密钥的自主 Agent 在客户端签署 EIP-3009 授权，以充值并买入（realmint_x402_buy_challenge）。
• 登录 + 委托交易 — 用户或连接器通过 OAuth 登录，并一次性委托其 Privy 嵌入式钱包；随后 Realmint 会在服务端按每笔交易的支出上限签署买入／卖出／提现交易。钱包由 Privy 持有；密钥不会接触 Realmint。

端点	https://mcp.realmint.io/mcp
传输方式	Streamable HTTP
身份验证	混合（按需）：目录开放；交易工具首次使用时会触发 OAuth
工具	8 个目录工具（只读）+ 6 个交易工具（需通过 OAuth 授权）
发现卡片	/.well-known/mcp/server-card.json
状态	自 2026 年 5 月起上线

---

你可以向它提问

功能	提示词示例
评估风险与权利	“评估 Tether Gold 的风险，并告诉我它是否适合我们的 DAO 金库”
搜索目录	“查找 Ethereum 上没有冻结功能的代币化国债”
追踪发行方变更	“我的观察列表中，本月是否有任何资产的控制参数发生变化？”
查找可路由交易场所	“我可以在哪里购买 10 万美元的 OUSG？按流动性排序”
获取市场与价格数据	“显示 PAXG 的现货价格、24 小时交易量和 6 个月走势图”
以 Agent 原生方式充值并买入	“通过 x402 为我的钱包充值 25 USDC，并买入 5 个 TSLAx”

---

将其添加到你的客户端

Claude.ai（自定义远程连接器）

1. Settings → Connectors → Add custom connector
2. 服务器 URL： https://mcp.realmint.io/mcp
3. 身份验证： 连接时无需身份验证 — 目录可立即使用。首次调用交易工具时，Claude 会运行 OAuth 登录流程（Realmint → Privy），你只需委托钱包一次。
4. 保存，然后开始询问上面的示例提示词。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "realmint": {
      "transport": {
        "type": "streamable-http",
        "url": "https://mcp.realmint.io/mcp"
      }
    }
  }
}

重启 Claude Desktop。

Cursor / Cline / Continue / 任意 MCP 客户端

配置远程 MCP 服务：

• URL：https://mcp.realmint.io/mcp
• 传输方式：streamable-http
• 身份验证：连接时无需身份验证；首次使用交易工具时会触发 OAuth

以编程方式接入

curl -X POST https://mcp.realmint.io/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

未经身份验证时，你会看到 8 个目录工具（全部为 readOnlyHint=true）。OAuth 登录后，还会显示 6 个交易工具（destructiveHint=true）。

---

目录工具（只读，无需身份验证）

工具	用途
realmint_list_assets	枚举包含架构的完整目录
realmint_list_market	现货价格、24 小时变动、交易量、市值、历史数据
realmint_get_asset	获取单项资产的完整架构（按小写代码查询）
realmint_get_asset_history	版本化元数据变更历史
realmint_get_score	六个维度的风险与权利评分 + 综合评分
realmint_get_route_support	可路由交易场所 + 各交易场所评分
realmint_get_price_history	时间序列价格（5m/1h/1d 自动级联）
realmint_x402_buy_challenge	x402 充值挑战 — 无需密钥、面向 Agent 的 USDC 原生充值入口，可用于购买资产（返回 402；由 Agent 在客户端签名）

交易工具（通过 OAuth 登录）

未登录时调用这些工具之一会返回 401，并触发 OAuth 流程 （Realmint 的 Ory Hydra 联邦接入 Privy 登录）。你只需登录并委托钱包一次（app.realmint.io/mcp/delegate）；之后 Realmint 会根据该委托在服务端为每笔交易签名，并为每笔交易设置支出上限——密钥不会接触 MCP，也无需在每笔交易时通过浏览器操作。

工具	用途
realmint_whoami	确认已登录的身份（Privy DID）
realmint_my_wallet	查看你的钱包、智能账户和余额
realmint_deposit	查看存入 USDC 以增加购买力的地址
realmint_buy	买入 RWA（你的智能账户必须已持有 USDC）
realmint_sell	在 Injective 上将 RWA 卖回 USDC
realmint_withdraw	从你的智能账户提取 USDC 到任意地址

完整的工具目录（含说明、输入项和标题）已发布在发现卡片中。

使用 realmint_x402_buy_challenge 买入

该入金通道面向 Agent 原生构建，无需密钥——Agent 只需一个 EVM 密钥即可买入，使用的签名与用户相同，共两次，且全部在客户端完成：

1. 调用 realmint_x402_buy_challenge，传入你的 owner_eoa、amount_usdc 以及你打算买入的 asset_id。它会返回包含 x402 支付要求的 HTTP 402 响应（accepts[0]）：payTo 是根据 owner_eoa 推导出的你的 Base 智能账户，maxAmountRequired 是 USDC 的最小计价单位金额，asset 是 Base USDC 合约，extra 是 EIP-712 域。
2. 验证 payTo 是根据你自己的 owner_eoa 推导出的，然后在该域上签署 EIP-3009 transferWithAuthorization，将 x402 PaymentPayload 进行 base64 编码，并在 X-PAYMENT 标头中将其重新 POST 到 /v1/route/x402-buy。结算后，USDC 会在无需托管的情况下桥接到你的 Injective 智能账户。
3. 通过 POST /v1/route/intent 使用该余额买入任意 RWA（像往常一样为路由签名）。资产会存放在你自己的智能账户中——你可以随时像普通用户一样将其 send 到其他地方。

完整操作指南请参阅 x402 Agent 买入指南。

风险与权利评分

realmint_get_score 会返回一个 0–100 的综合评分，以及六项维度评分：

• backing — 储备金证明、审计频率、支持机制。
• enforceability — 管辖法律、发行方验证、法律文件。
• control — 发行方权限风险：冻结、铸造、销毁、列入黑名单、升级。
• exit — 赎回、可转让性、KYC/白名单、结算、持有期限。
• liquidity — 市场数据、交易场所数量、证明文件。
• social — 按时效加权的 Twitter 活跃度；未经验证的账号会被扣分。

建议的决策阈值：

• 综合评分 ≥ 75 → 常见情况，可继续。
• 55 ≤ 综合评分 < 75 → 阻碍因素较多（门槛、缺少审计）；采取行动前请检查该资产的标记。
• 综合评分 < 55 → 风险高；中止操作或要求用户明确授权覆盖限制。

根据政策，metadata.lifecycle 非空（已迁移、已停用、已弃用）的代币，其评分上限为 49。

---

故障排除

HTTP 403 — "Invalid Origin header" 根据 Anthropic Connectors Directory 的要求，服务会验证 Origin 标头。claude.ai、chatgpt.com、mcp.realmint.io、app.realmint.io 和 realmint.io 已预先加入允许列表。如果你从其他来源访问，并希望将其加入列表，请发送邮件至下方地址。

工具返回空列表 Realmint 目录经过精心整理，任意时刻收录的资产约为 30 个。询问特定代币代码前，请运行 realmint_list_assets 查看当前资产列表。

资产 ID 格式 资产 ID 是小写的代币代码：xaut，而不是 XAUT；paxg，而不是 PAXG。

metadata.lifecycle 不为 null 该代币已迁移、停用或弃用。禁止交易，评分上限为 49。生命周期字段会说明原因，并指出替代品（如有）。

价格历史返回的时间区间比请求的更粗略 如果该资产没有请求的时间区间数据，服务会逐级改用更粗略的时间区间（5m → 1h → 1d）。请查看响应中的 effective_granularity，了解实际返回的时间区间。

---

安全与隐私

• 密钥安全。 目录为只读。交易资金仅在你本人授权下转移，且绝不会暴露原始密钥：x402 购买由客户端签名（EIP-3009），OAuth 交易工具则通过 Privy delegation 在服务器端签名，并受单笔交易消费上限约束；Privy 持有嵌入式钱包，密钥不会接触 Realmint。
• MCP 服务不收集个人身份信息。 x-api-key 标头用于上游速率限制识别；交易工具使用 OAuth（Hydra）令牌识别身份。
• 通过 Traefik 终止 HTTPS。
• 在 FastMCP 层启用了 Origin / Host 验证（DNS 重绑定防护）。
• 隐私政策： https://realmint.io/privacy
• 服务条款： https://realmint.io/terms

---

版本管理与更新日志

此连接器与 Realmint 平台同步进行版本管理。工具接口或输出格式的重大变更将在此 README 中公布，并同步反映在发现卡片（serverInfo.version）中。

---

联系与支持

• 一般咨询： [email protected]
• Realmint Web 应用： https://realmint.io
• API 文档： https://api.realmint.io/docs
• 发现卡片： https://app.realmint.io/.well-known/mcp/server-card.json

---

MCP 服务的源代码存放在私有代码库中；托管端点 https://mcp.realmint.io/mcp 是受支持的公共接口。