MCP server#

MCP Server 通过 Model Context Protocol 将全部交易能力暴露为可直接调用的工具（dex-quote、dex-swap、dex-solana-swap-instruction 等），Claude Desktop、Cursor 等任何支持 MCP 的客户端均可自动发现并原生调用，无需任何额外接入代码。

Agent 只需一句"把 0.1 ETH 换成 USDC"，MCP Server 即可自动完成报价、Approve 检查、交易组装、链上的完整链路。

MCP Server 的工具集#

链与流动性工具： dex-aggregator-supported-chains 列出所有支持 swap 的链；dex-liquidity 列出指定链上活跃的 DEX 流动性来源。
Approve 工具： dex-approve-transaction 生成首次兑换代币所需的 ERC-20 Approve calldata。
报价工具： dex-quote 跨所有流动性来源获取最优聚合报价，含预期到账量、价格冲击和路由明细。
Swap 工具： dex-swap 构造完整 swap 交易（calldata + value + gas 估算），可直接签名。
Solana 工具： dex-solana-swap-instruction 生成用于兑换 SPL 代币的 Solana 版本化交易指令集，可直接由钱包签名。

快速开始#

适用于 Claude Desktop、Cursor 及其他兼容 MCP 的客户端：

# for cursor
{
  "mcpServers": {
    "okx/onchainos-mcp": {
      "url": "https://web3.okx.com/api/v1/onchainos-mcp",
      "headers": {
        "OK-ACCESS-KEY": "your apiKey applyed on https://web3.okx.com/zh-hans/onchain-os/dev-portal/project"
      }
    }
  }
}
# for Claude code
{
  "mcpServers": {
    "okx/onchainos-mcp": {
      "url": "https://web3.okx.com/api/v1/onchainos-mcp"",
      "headers": {
        "OK-ACCESS-KEY": "your apiKey applyed on https://web3.okx.com/zh-hans/onchain-os/dev-portal/project"
      }
      "type": "http"
    }
  }
}

一个 MCP Server 同时覆盖 Trade 和 Market 能力。更新配置后重启客户端即可生效。

示例交互#

MCP Server 激活后，Agent 可响应以下自然语言指令：

支持哪些链进行 DEX 兑换？
# 调用 dex-aggregator-supported-chains

X-layer 上支持哪些 DEX？
# 调用 dex-liquidity

在 X-layer 上，1 ETH 可以兑换多少 USDC？
# 调用 dex-quote

在 X-layer 兑换前我需要先授权 USDT，请生成对应的 calldata
# 调用 dex-approve-transaction

在 X-layer 构建一笔兑换交易：100 USDT → ETH，钱包地址 0xd8dA...，滑点 0.5%
# 调用 dex-swap

在 Solana 上将 2 SOL 兑换为 USDC，钱包地址 DYw8...
# 调用 dex-solana-swap-instruction