工具文档
12 个 MCP 工具的完整入参与语义。所有工具经 POST /market/openapi/v1/mcp 的 JSON-RPC tools/call 调用；业务错误通过调用结果的 isError 与文本返回，HTTP 恒为 200。
attest_work个人
作品存证。默认沙箱（mock_attestation，不连真实链不耗配额）；confirm_mainnet=true 且提供实名双字段时走真实中数链（不可撤销）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | string | 是 | 作品名称 |
| content | string | 是 | 作品文本内容（以其 SHA256/字节数作为存证指纹） |
| confirm_mainnet | boolean | 否 | true=上真实中数链 |
| real_name | string | 否 | 真链必填：著作权人实名姓名 |
| id_card | string | 否 | 真链必填：证件号 |
list_my_attestations个人
本人存证台账（含状态与证书链接）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 默认 20，最大 100 |
| offset | integer | 否 | 默认 0 |
list_my_orders个人
本人订单列表。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 默认 50，最大 200 |
| offset | integer | 否 | 默认 0 |
query_products个人
平台公开在售商品行情。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| category | string | 否 | 品类：copyright_license / ip_license / cultural_creative |
| limit | integer | 否 | 默认 50，最大 500 |
| offset | integer | 否 | 默认 0 |
register_merchant合作方merchant:register
商户引入：按手机号幂等注册成交平台商户。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| phone | string | 是 | 商户手机号（幂等键） |
| name | string | 是 | 商户名称 |
| institution_id | integer | 否 | 挂靠合作机构 ID |
| company_name | string | 否 | 公司名称 |
| license_no | string | 否 | 营业执照号 |
query_merchant合作方merchant:register
按手机号查询本合作方引入的商户状态。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| phone | string | 是 | 商户手机号 |
list_merchant_products合作方product:import
商户名下商品列表（仅限本合作方引入的商户）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| phone | string | 是 | 商户手机号 |
import_product合作方product:import
商品导入（external_id 幂等；图片用公网 URL，最多 9 张）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| merchant_phone | string | 是 | 归属商户手机号 |
| institution_external_id | string | 是 | 机构同步 external_id |
| external_id | string | 是 | 导入幂等键 |
| name | string | 是 | 商品名 |
| category | string | 是 | 产品品类（见 query_dictionaries） |
| transaction_mode | string | 是 | 交易模式（见 query_dictionaries） |
| description | string | 否 | 描述（可含简单 HTML） |
| sub_category | string | 否 | 内容二级分类 |
| tags | string[] | 否 | 标签 |
| license_mode | string | 否 | 授权模式 |
| price_cents | integer | 否 | 价格（分） |
| total_quantity | integer | 否 | 总量 |
| image_urls | string[] | 否 | 商品图公网 URL |
query_import_status合作方product:import
按 external_id 查询导入单状态。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| external_id | string | 是 | 导入幂等键 |
sync_institution合作方institution:sync
机构同步（external_id 幂等创建/更新；is_certified 由平台审核认定，不接受设置）。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| external_id | string | 是 | 机构外部 ID（幂等键） |
| name | string | 是 | 机构名称 |
| contact | string | 否 | 联系方式 |
| introduction | string | 否 | 机构简介 |
| image_url | string | 否 | 头图 URL |
| logo_url | string | 否 | Logo URL |
| category | string | 否 | 机构分类 |
| tags | string[] | 否 | 标签 |
list_institutions合作方institution:sync
已同步机构列表。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 默认 50 |
| offset | integer | 否 | 默认 0 |
query_dictionaries合作方
开放字典：品类/内容分类/交易模式/标签的合法取值。
| 参数 | 类型 | 必填 | 说明 |
|---|
错误码
| HTTP | error | 说明 |
|---|---|---|
| 400 | invalid_request | 参数缺失或格式非法 |
| 401 | invalid_token | 凭据缺失/无效/已吊销 |
| 403 | scope_denied | 未开通对应能力、参数越界或应用未挂靠合作方主体 |
| 404 | not_found | 资源不存在（防枚举语义） |
| 409 | account_deactivated | 账号已注销（不自动复活） |
| 429 | rate_limited | 触发限流，响应附带 Retry-After |
| 502 | upstream_unavailable | 平台内部依赖异常，可稍后重试 |
429 响应附带 Retry-After 头；按 token 主体限流（个人换票 30 次/分 · 500 次/日；合作方按主体共享配额）。
环境
| 环境 | 网关 | 说明 |
|---|---|---|
| 正式 | https://cjapp.cdcee.net | 真实数据；MCP 存证走真实中数链（不可撤销、消耗配额） |
| 测试 | https://cjapp-t.cdcee.net | 沙箱演练；MCP 存证默认沙箱（mock，不连真实链、不耗配额） |
正式环境未开放沙箱字段：attest_work 沙箱模式在正式网关会返回字段未启用错误，属预期行为。