A2MCP 接入指南#

什么是 A2MCP#

A2MCP（Agent-to-MCP）是 OKX.AI 上 ASP 提供标准化、可由 Agent 调用服务的类型。服务可以免费，也可以按次通过 x402 收费。

A2MCP 服务按 endpoint 类型分为以下两类：

endpoint 类型	适用情况	调用定义来源
MCP 类型 endpoint	支持 MCP 协议，可发现并调用一个或多个 Tool	`tools/list` 返回的 Tool 定义
HTTP 类型 endpoint	普通 HTTP API	Endpoint 及 ASP 提供的请求方法、入参格式信息

确认你的服务适合接入#

适合 A2MCP 的服务通常能清楚地抽象为「输入参数 → 明确结果」，并能由程序完成调用和交付。

特征	说明	示例
有结构化数据或能力	能通过接口返回明确结果，而非纯人工处理	天气、汇率、地图、行情、企业信息
可工具化	每项能力可拆成带参数的功能	查询订单、生成发票、翻译
结果可校验、风险较低	返回值相对确定	查询类、只读类服务
有持续价值	用户可能重复调用	数据 API、行业知识库、垂直搜索

接入前准备#

根据你的服务实现方式，阅读对应的 4 个步骤。

请先完成服务开发、部署和自检。注册时，平台读取 Endpoint 中已有的信息，并按提示收集必要的调用入参；真实调用验证通过后才允许注册。平台不会替你开发或修复服务。

通用要求#

提供已部署的公网 HTTPS Endpoint，地址长度不超过 512 个字符；不使用本机、私网、mock 或占位地址，也不跳转至本机或私网。
使用有效入参调用时，在 180 秒内返回与服务描述一致的完整业务结果。
不要求用户提供 API Key、访问令牌、私钥或助记词等敏感凭据；第三方依赖由服务端配置。

MCP

HTTP API

1
构建 MCP Server
使用 MCP 官方 SDK 创建 Server，并将业务能力注册为 Tool。已有数据库、HTTP API 或 SaaS 时，可以在 Tool 的处理函数中调用这些能力
如何构建MCP Server，可参考：Build an MCP server
注意协议版本和传输方式
官方教程与 SDK 持续更新，示例可能使用本地 stdio 或不同协议版本。本文的 OKX.AI 接入流程包含 initialize 握手，请选择能与平台协商兼容协议版本的实现。
2
定义工具并配置收费
定义MCP Tool
工具字段用途
name 程序调用工具的标识
title 平台展示的服务名称
description 说明服务用途、能力与返回结果
inputSchema 定义参数结构、类型、必填项及约束
OKX.AI 要求 title 和 description 非空；每个选中的 Tool 对应一个 Service，多个 Service 可以共用同一个 MCP Endpoint。
配置收费
在服务端配置各 Tool 的 x402 收费要求，平台通过调用验证解析价格。仅在 tools/call 环节收费，initialize 和 tools/list 不收费。
情况一：免费服务
调用 Tool 时直接返回业务结果，无需实现 x402。
情况二：按次收费（x402）
收费应在 tools/call 阶段触发。建议使用 OKX Payment SDK：OKX提供服务端 SDK（@okxweb3/x402-* 支持 Node.js、Go、Rust、Java 和 Python）。为 endpoint 挂上支付中间件并配置收款地址、网络和价格后，SDK 会处理 402 响应与链上验证。完整步骤见通过 SDK 接入。

⚠️ x402 v2 支付挑战需 base64 编码后放入 PAYMENT-REQUIRED 响应头。市场校验的是响应头，不是响应体；建议使用 SDK，避免挑战格式或位置错误。
json
{ "x402Version": 2, "resource": { "url": "https://<your-public-endpoint>/...", "description": "<service-description>", "mimeType": "application/json" }, "accepts": [ { "scheme": "exact", "network": "eip155:196", "asset": "0x779ded0c9e1022225f8e0630b35a9b54be713736", "amount": "10000", "payTo": "0x<your-x-layer-wallet>", "maxTimeoutSeconds": 300, "extra": { "name": "USD₮0", "version": "1" } } ] }
收费 endpoint 应先校验必填参数，再返回支付要求，避免用户为无效请求付款。支付挑战中的网络、支付方式、资产、代币名称与版本、金额和收款地址必须完整；实际金额必须与平台解析出的价格一致。

工具字段	用途
name	程序调用工具的标识
title	平台展示的服务名称
description	说明服务用途、能力与返回结果
inputSchema	定义参数结构、类型、必填项及约束

部署并验证 MCP 服务

完成部署后，使用官方 MCP Inspector 或兼容 MCP Client 连接公网 HTTPS MCP 地址，例如 https://你的域名/mcp，验证以下流程：

text

客户端 initialize
→ 服务端返回初始化结果
→ 客户端 notifications/initialized
→ tools/list 获取工具定义
→ tools/call 携带有效 arguments 调用指定工具

4
注册到 OKX.AI
按 ASP 注册流程提交 Endpoint。

1
构建 HTTP API
提供能够通过 GET 或 POST 调用的业务接口。已有 API 可以跳过此步；从零开发可参考 FastAPI 官方教程，或使用你熟悉的 Web 框架。
数据库、内部系统或 SaaS 都可以作为服务端的数据与能力来源，但不能直接将内部地址当作对外 Endpoint。

准备调用信息并配置收费

信息	准备要求
服务名称	用户可理解的名称
服务描述	说明服务用途、能力及返回结果
请求方法	GET 或 POST，与实际接口一致
入参格式	每个参数的名称、类型、含义和是否必填；无参数时说明“无参数”

参数类型包括 string、number、boolean、array、object；对象和数组需说明其内容。例如：city（string，必填）：需要查询的城市名称。

注册不额外要求完整 cURL、每个参数的默认值、示例值、location 或手写 Schema JSON；验证所需的有效业务入参按 Agent 提示提供。

配置收费

完成调用定义后，选择免费或按次收费：

情况一：免费服务

接口被调用时直接返回业务结果（HTTP 200），无需实现 x402。

情况二：按次收费（x402）

价格来自 endpoint 的 x402 设置。建议使用 OKX Payment SDK：OKX提供服务端 SDK（@okxweb3/x402-* 支持 Node.js、Go、Rust、Java 和 Python）。为 endpoint 挂上支付中间件并配置收款地址、网络和价格后，SDK 会处理 402 响应与链上验证。完整步骤见通过 SDK 接入。

⚠️ x402 v2 支付挑战需 base64 编码后放入 PAYMENT-REQUIRED 响应头。市场校验的是响应头，不是响应体；建议使用 SDK，避免挑战格式或位置错误。

json

{
  "x402Version": 2,
  "resource": {
    "url": "https://<your-public-endpoint>/...",
    "description": "<service-description>",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:196",
      "asset": "0x779ded0c9e1022225f8e0630b35a9b54be713736",
      "amount": "10000",
      "payTo": "0x<your-x-layer-wallet>",
      "maxTimeoutSeconds": 300,
      "extra": { "name": "USD₮0", "version": "1" }
    }
  ]
}

收费 endpoint 应先校验必填参数，再返回支付要求，避免用户为无效请求付款。支付挑战中的网络、支付方式、资产、代币名称与版本、金额和收款地址必须完整；实际金额必须与平台解析出的价格一致。

3
部署并验证 HTTP API
部署 HTTP API 并为域名配置 HTTPS，确保第三方依赖、网络访问和服务端凭据已配置好。
使用 curl 或等效客户端，按真实请求方法和有效参数调用公网 HTTPS 业务路由，检查响应与业务结果。下面仅展示 POST JSON 请求的结构，请替换为自己的接口与输入：
bash
curl -i -X POST 'https://你的域名/业务路由' \ -H 'Content-Type: application/json' \ -d '{"city":"Shanghai"}'
付费服务还需检查未支付时的 x402 支付要求，以及携带有效支付凭证重放请求后的完整交付。
4
注册到 OKX.AI
按 ASP 注册流程提交 Endpoint。