内容
X MCP
ARCOX MCP 是一个本地的 MCP 服务器和终端代理，用于 ARCOX DEX 零售流程。
它提供了以下工具：
- 跨 EOA、Circle 代理钱包和 Solana Devnet 的钱包余额
- 默认从本地 EOA 代理钱包进行交换报价和执行，可选 Circle 代理钱包源
- 桥接报价和执行，包括原生 ETH 到 Arc 的验证以太坊/Base Sepolia 路由器
- 发送报价和执行
-X Pay 发票/付款请求工具
- 调用 ARCOX API x402 端点的 ARCOX Intel 工具；MCP 永远不会存储 `ARKHAM_API_KEY`，也永远不会直接调用 Arkham
- 桥接重试和交易历史
- ARCOX Agentic Economy 作业操作
- 代理的 ARCOX DEX UI映射
- 动态样式的 ARCOX 文档搜索/读取工具
## Circle 代理对齐
ARCOX MCP 遵循 Circle for Agents 方向：USDC 原生代理工作流、付费 API 准备和报价前执行安全：
- 使用用户的本地 `AGENT_PRIVATE_KEY` 的 EOA 代理钱包交换/发送/桥接/支付。
- 仅当工具显式调用 `source="circle"` 时，才支持 Circle 代理钱包。
- 用于 Arc Test公共 USDC 支付链接的 ARCOX Pay 发票/付款请求工具。
- 用于 ARCOX Intel 的 x402 真实测试网 Arc USDC 备忘录支付。
ARCOX 不声称具有实时的无 Gas 小额支付或私人支付。这些仍然是未来的集成工作。
## 安装
```bash
npm install -g arcox-mcp
```
或在不进行全局安装的情况下运行：
```npx arcox-mcp
```
## 环境
在用户的计算机上创建工作文件夹：
```bash
mkdir -p ~/.arcox
nano ~/.arcox/.env
chmod 600 ~/.arcox/.env
```
最低 EVM 设置：bash
AGENT_PRIVATE_KEY=0x...
ARC_RPC=https://rpc.testnet.arc.network/
ARCOX_API_URL=https://arc-dex-bice.vercel.app
```
可选的 Solana Devnet 设置：bash
SOLANA_PRIVATE_KEY=[1,2,3,...]
_DEVNET_RPC=https://api.devnet.solana.com
```
可选的安全限制：
```bash
ARCOX_MAX_TX_USDC=10
ARCOX_DAILY_LIMIT_USDC=50
ARCOX_MAX_TX_NATIVE=1
```
原生桥接示例：
```bash
bridge 0.001 ETH from Base Sepolia to Arc
bridge 0.001 ETH from Ethereum Sepolia to Arc
```
原生桥接仅使用本地 EOA 代理钱包。Circle 钱包源支持 USDC 桥接路由，不支持原生 ETH。
当全局安装时，从 `~/.arcox` 运行命令，以便加载本地 `.env` 文件：
```bash
cd ~/.arcox
arcox-agent status
```
## MCP 配置
### Codex
添加一个运行的 MCP 服务器条目：
```bash
arcox-mcp
```
示例配置形状：
```json
{
"mcpServers": {
"arcox": {
"command": "arcox-mcp",
"args": [],
"env": {
"ARCOX_MCP_DEBUG": "arcox-mcp.log"
}
}
}
}
```
### Hermes
```bash
h mcp add arcox -- arcox-mcp
```
如果配置文件，请确保 `args` 是数组，而不是字符串：
```yaml
mcp_servers:
arcox:
command: arcox-mcp
args: []
```
## 安全执行流程
所有移动价值的工具都需要先报价/预览：
1. 调用报价工具。
2. 向用户显示预览。
3. 用户使用确切的 `yes` 或 `ya` 进行确认。
4. 调用执行工具，带有 `confirmed=true`、确切的 `previewId` 和 `confirmationText`。
代理不得跳过预览步骤。
## 工具
- `arcox_wallet_balances`
- `arcox_transaction_history`
- `arcox_quote_swap`
- `arcox_execute_swap `arcox_quote_bridge`
- `arcox_execute_bridge`
- `arcox_quote_send`
- `arcox_execute_send`
- `arcox_create_payment_request`
- `arcox_get_payment_request`
- `arcox_quote_payment_request`
- `arcox_pay_payment_request`
- `arcox_check_payment_status`
- `arcox_simulate_circle_web- `arcox_quote_eco_route_payment`
- `arcox_retry_bridge`
- `arcox_route_status`
- `arcox_ui_map`
- `arcox_action_plan`
- `arcox_search_docs`
- `arcox_read_doc`
- `arcox_agent_status`
- `arcox_agent_job`
ARCOX Intel x402 服务覆盖范围：
- `arcox_intel_get_address` 支持 `service`: `basic`, `all`, `enriched`, `balances`, `counterparties`, `flows`, `history`, `volume`, `portfolio`.
- `arcox_intel_get_tx` 支持 `service`: `basic`, `transfers`.
- `arcox_intel_get_entity` 支持 `service`: `basic`, `summary`, `balances`, `flows`.
- `arcox_intel_get_token` 支持 `service`: `basic`, `market`, `holders`, `top-flow`, `trending`, `top`, `contract`, `contract-holders`.
ARCOX Intel x402 支付使用 Arc 交易备忘录。代理通过 Arc Memo 合约支付 USDC，在链上附加发票/支付参考以进行对账。
## Circle 网关小额支付准备就绪
ARCOX MCP 理解 Arc x402 支付为：
1. API 返回 `402 Payment Required`。
2. 代理预览确切的 Arc Testnet USDC 金额、收款人、发票和备忘录 ID。
3. 用户确认 `。
4. 代理通过 Arc Memo 合约支付并轮询发票状态。
5. 已付发票通过 ARCOX API 解锁 Arkham 结果。
请勿告知用户无 Gas 小额支付已上线。统一余额/网关是支付渠道；当前 MCP 执行使用公共 Arc Testnet USDC。
## CLI 示例
```bash
arcox-agent status
arcox-agent "show all wallet balances"
arcox-agent "quote swap 1 eurc to usdc from eoa"
arcox-agent "quote bridge 1 usdc from arc to base"
arcox-agent "send 1 eurc from eoa to 0x..."
arcox-agent "create payment request 10 usdc to 0xMerchant for AI agent setup"
arcox-agent "quote payment invoice inv_..."
arcox-agent "retry bridge 0xBURN_TX from arbitrum sepolia to arc"
```
对于执行，首先检查预览，然后确认。
ARCOX Pay 发票支付使用报价前执行。执行调用必须传递报价的 `previewId` 以及与 `previewArgs` 相同的发票金额、代币和商家地址。
交换OA。要使用 Circle 代理钱包，工具调用必须在报价和执行中显式包含 `source="circle"`。
## 安全
- 私钥存储计算机上的 `.env` 文件中。
- ARCOX DEX 网页 UI 不接收私钥。
- MCP 执行是本地到用户的代理进程。
- `arcox-agent status` 在 `.env` 文件可被组/其他用户读取时报告 `envSecurityWarnings`。
- 将 `.env` 保留在同步文件夹之外，永远不要将私钥粘贴到聊天中。
