xRocket Exchange MCP

设置一个每日价值限额，并让支持 MCP 的 AI 代理在该限额内自主下达或撤销 xRocket 现货订单。转账和提现仍是独立的、需要明确审批的操作。

托管端点仍然是一个公开的市场数据演示与入门引导路径；它永远不会接收账户凭据，也无法进行交易。本包与 xRocket 无关联，也未获其支持。设置交易 或 打开 xRocket。

交易快速入门

1. 登录 xRocket 并打开 菜单 → 设置 → Exchange 设置 → API 令牌。

2. 生成一个测试网优先、带每日限额的 MCP 配置：

   npx -y xrocket-mcp@0.6.0 trading-config --limit 100 --asset USD

3. 将打印出的 JSON 粘贴到本地 MCP 客户端中。仅在客户端的本地密钥或环境设置中替换 SET_YOUR_XROCKET_API_TOKEN_LOCALLY。

4. 为客户端提供一个策略。它可以在任何可用的现货交易对上下达或撤消市场单或限价单，直到达到所配置的每日价值限额或内置的订单数量限制。

只有在测试网验证通过之后，才使用 npx -y xrocket-mcp@0.6.0 trading-config --limit 100 --asset USD --mainnet。转账与提现保持禁用。

上游令牌拥有广泛的账户访问权限，而不是文档中划分好的细粒度范围。切勿将其放入聊天、托管端点、已提交的文件、issue 或日志中。

Related MCP server: tossinvest-openapi-mcp

托管市场演示

使用连接页面或直接复制公共主网端点，不必安装任何内容或提供任何凭据：

https://xrocket-mcp-production.up.railway.app/mcp

它仅暴露 10 个公开工具，无法读取账户令牌，也不能启用财务写入。当被要求交易时，它的接入引导工具会把用户导向上述的本地设置。

本地快速入门

npx -y xrocket-mcp@0.6.0 doctor
npx -y xrocket-mcp@0.6.0 config

需要 Node.js 20 或更高版本。公开市场读取无需配置即可使用：

XROCKET_PROFILE=public
XROCKET_ENVIRONMENT=mainnet

从仓库市场中安装一站式 Codex 插件：

codex plugin marketplace add nakazanie-ton/myrocket --ref main
codex plugin add xrocket-exchange@xrocket-agents

MCP 客户端示例：

{
  "mcpServers": {
    "xrocket": {
      "command": "npx",
      "args": ["-y", "xrocket-mcp@0.6.0"],
      "env": {
        "XROCKET_ENVIRONMENT": "mainnet",
        "XROCKET_ENABLE_TRADING": "false",
        "XROCKET_ENABLE_TRANSFERS": "false",
        "XROCKET_ENABLE_WITHDRAWALS": "false",
        "XROCKET_ALLOW_MAINNET_WRITES": "false"
      }
    }
  }
}

用于源码开发，在这个目录中运行 npm ci、npm test 和 npm run build即可。

配置文件与写入门槛

• public：10 个无需认证的工具，包括组合工具 xrocket_market_snapshot。

• private-read：在 public 工具基础上增加余额、全账户总览、订单、转账、提现和配额；当存在 XROCKET_API_TOKEN 时自动推断。

• full：全部工具，包括自主交易，以及展示钱包转账/提现工作流；只有当每个能力的对应门槛为 true 时才启用。

写入门槛是 XROCKET_ENABLE_TRADING、XROCKET_ENABLE_TRANSFERS 和 XROCKET_ENABLE_WITHDRAWALS；默认均为 false。主网写入同时还要求 XROCKET_ALLOW_MAINNET_WRITES=true。

xrocket_agent_trade 会在提交每个订单之前对其进行估算和计价。本地持久化的账本会保障重启后仍执行所配置每日价值上限，而今日的 xrmcp-…- 的官方历史记录会包含由另一个本地进程产生的使用量。每日订单数和进行中订单守卫仍是内置能力。默认允许所有现货符号；对于要求更高级配置，还可以使用可选的符号白名单。当订单结果不明确时，会保留占用的额度且不重试。

转账和提现仍需保存准确的预期意图，并只接受该意图的短时、一次性的确认回执。常规交易配置会让两个门槛一直保持禁用。

边界

• Exchange API 没有提供定向充值地址的端点；清楚使用环境的分配仅能在 UI 界面中。

• X 交易所内的转账是内部 funding ↔ trading 转账，并且不是用户与用户之间的支付。

• xRocket Pay 是另一个独立的产品，不包含在本包中。

• WebSocket 通道已经过审计，但 0.6.0 使用受限于 REST 的快照重构。

• 保持所有触发的数值以十进制字符串记录，并在当前 API 有要求的地方使用 TONCOIN。

完整文档、覆盖率、安全策略、隐私声明和使用条款都发布在了项目仓库中。