API Documentation

Standard MCP Endpoint (Recommended)

• Endpoint: POST https://www.hsciq.com/mcp/rpc, following the standard Model Context Protocol (Streamable HTTP, Stateless, JSON-RPC 2.0).
• Authentication is the same as the REST endpoint: the X-API-Key request header, or Authorization: Bearer <key>.
• Provides 15 tools in total: 9 tools (search_instance / search_code / search_unified / get_code_detail / create_guilei_form / get_guilei_form / list_my_guilei_forms / add_guilei_dialog_message / list_guilei_categories) are identical to the REST endpoint in parameters and response structures; 3 additional customs announcement tools (search_gonggao / get_gonggao_detail / get_gonggao_by_code) and 3 ocean carrier notice tools (list_ocean_carriers / search_ocean_carrier_notice / get_ocean_carrier_notice_detail) are available only on the standard MCP endpoint.
• Error semantics differ: the REST endpoint returns HTTP 429/400 when a quota is exceeded or a call fails; the standard MCP endpoint returns HTTP 200 per the protocol, with isError=true in the result and error text prefixed with an error code (e.g. daily_quota_exceeded: 每日调用次数已达上限（150次）).
• The REST endpoints below remain available; new integrations are recommended to use the standard MCP endpoint.

{
  "mcpServers": {
    "hsciq": {
      "type": "http",
      "url": "https://www.hsciq.com/mcp/rpc",
      "headers": { "X-API-Key": "your_api_key" }
    }
  }
}

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}"

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"search_code\",\"arguments\":{\"keywords\":\"自行车\",\"country\":\"CN\"}}}"

Integration Guide

• This site offers two integration methods: the standard MCP endpoint POST /mcp/rpc (recommended), and the legacy REST endpoint (deprecated, kept only for compatibility with existing callers; see the bottom of this page).
• The base address is built from the site domain; all requests use HTTPS.
• Address example: https://www.hsciq.com/mcp/rpc (correct); do not write it as https://www.hsciq.com/MCP/mcp/rpc.
• The standard MCP endpoint provides 15 tools in total; 9 are identical to the REST endpoint (see "Tools" below), and the 3 customs announcement tools plus 3 ocean carrier notice tools are available only on the standard MCP endpoint.
• Paged tools uniformly return pageIndex/pageSize/totalPageCount/totalItemCount/isPreviousPage/isNextPage/items.

Authentication

X-API-Key: your_api_key

ClawHub Skill Installation

• Skill page: https://clawhub.ai/toucao/skills/hsciq-mcp

openclaw skills install @toucao/hsciq-mcp

Local CLI (stdio) Installation

• Use case: when an AI client only supports stdio local-process integration, use this CLI as a local bridge (internally it still calls the /mcp/rpc endpoint above, with identical authentication and quotas). If the client supports direct HTTP connections, using the standard endpoint directly is recommended.
• Download links, configuration examples, and installation instructions have been moved to a dedicated page: CLI Download.

search_instance Parameters and Return Values

search_code Response Fields

search_unified Response Fields

get_code_detail Request & Response Fields

create_guilei_form Parameters and Return Values

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""jsonrpc"": ""2.0"",
    ""id"": 1,
    ""method"": ""tools/call"",
    ""params"": {
      ""name"": ""create_guilei_form"",
      ""arguments"": {
        ""productNameCn"": ""智能手机壳"",
        ""productNameEn"": ""Smartphone Case"",
        ""uses"": ""手机保护套"",
        ""ingredients"": ""硅胶"",
        ""brand"": ""某品牌"",
        ""model"": ""X1"",
        ""images"": [
          {
            ""fileName"": ""front.jpg"",
            ""data"": ""base64_encoded_image_data""
          }
        ]
      }
    }
  }"

{
  "formId": "a1b2c3d4-...",
  "url": "https://www.hsciq.com/GuiLei/a1b2c3d4-...",
  "status": "已创建",
  "imageCount": 1,
  "imageUrls": [ "https://www.hsciq.com/uploads/guilei/..." ]
}

get_guilei_form Parameters and Return Values

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""jsonrpc"": ""2.0"",
    ""id"": 1,
    ""method"": ""tools/call"",
    ""params"": {
      ""name"": ""get_guilei_form"",
      ""arguments"": {
        ""formId"": ""a1b2c3d4-...""
      }
    }
  }"

list_my_guilei_forms Parameters and Return Values

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""jsonrpc"": ""2.0"",
    ""id"": 1,
    ""method"": ""tools/call"",
    ""params"": {
      ""name"": ""list_my_guilei_forms"",
      ""arguments"": {
        ""pageIndex"": 1,
        ""pageSize"": 10
      }
    }
  }"

{
  "items": [
    {
      "id": "a1b2c3d4-...",
      "productNameCn": "智能手机壳",
      "status": 1,
      "isFinalized": false,
      "createTime": "2026-05-08T10:30:00"
    }
  ],
  "pageIndex": 1,
  "pageSize": 10,
  "totalItemCount": 3,
  "totalPageCount": 1
}

add_guilei_dialog_message Parameters and Return Values

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""jsonrpc"": ""2.0"",
    ""id"": 1,
    ""method"": ""tools/call"",
    ""params"": {
      ""name"": ""add_guilei_dialog_message"",
      ""arguments"": {
        ""formId"": ""a1b2c3d4-..."",
        ""fieldKey"": ""Ingredients"",
        ""content"": ""主要成分是聚乙烯，不含阻燃剂""
      }
    }
  }"

"arguments": {
  "formId": "a1b2c3d4-...",
  "fieldKey": "Ingredients",
  "content": "已确认，确实不含阻燃剂",
  "dialogId": "d5e6f7a8-..."
}

{
  "dialogId": "d5e6f7a8-...",
  "messageId": "b9c0d1e2-...",
  "action": "reply"
}

list_guilei_categories Parameters and Return Values

curl -X POST "https://www.hsciq.com/mcp/rpc" ^
  -H "Content-Type: application/json" ^
  -H "Accept: application/json, text/event-stream" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""jsonrpc"": ""2.0"",
    ""id"": 1,
    ""method"": ""tools/call"",
    ""params"": {
      ""name"": ""list_guilei_categories"",
      ""arguments"": {}
    }
  }"

[
  { "id": 1, "name": "活动物；动物产品" },
  { "id": 2, "name": "植物产品" },
  { "id": 3, "name": "动、植物油脂" }
]

search_gonggao Parameters and Return Values Standard MCP Endpoint Only

get_gonggao_detail Parameters and Return Values Standard MCP Endpoint Only

get_gonggao_by_code Parameters and Return Values Standard MCP Endpoint Only

list_ocean_carriers Parameters & Return Values Standard MCP endpoint only

search_ocean_carrier_notice Parameters & Return Values Standard MCP endpoint only

get_ocean_carrier_notice_detail Parameters & Return Values Standard MCP endpoint only

GET /mcp Deprecated

{
  "name": "HSCIQ2 MCP",
  "version": "1.0",
  "standardMCPEndpoint": "/mcp/rpc",
  "toolsEndpoint": "/mcp/tools/list",
  "callEndpoint": "/mcp/tools/call"
}

POST /mcp/tools/list Deprecated

curl -X POST "https://www.hsciq.com/mcp/tools/list" ^
  -H "Content-Type: application/json" ^
  -H "X-API-Key: your_api_key"

{
  "version": "1.0",
  "tools": [
    { "name": "search_instance" },
    { "name": "search_code" },
    { "name": "search_unified" },
    { "name": "get_code_detail" },
    { "name": "create_guilei_form" },
    { "name": "get_guilei_form" },
    { "name": "list_my_guilei_forms" },
    { "name": "add_guilei_dialog_message" },
    { "name": "list_guilei_categories" }
  ]
}

POST /mcp/tools/call (search_instance / search_code / search_unified) Deprecated

curl -X POST "https://www.hsciq.com/mcp/tools/call" ^
  -H "Content-Type: application/json" ^
  -H "X-API-Key: your_api_key" ^
  -d "{
    ""toolName"": ""search_code"",
    ""arguments"": {
      ""keywords"": ""塑料软管"",
      ""country"": ""CN"",
      ""pageIndex"": 1,
      ""pageSize"": 10,
      ""filterFailureCode"": true
    }
  }"

• Pagination outer fields: pageIndex, pageSize, totalPageCount, totalItemCount, isPreviousPage, isNextPage, items.
• items types: search_instance → MCPInstanceItem[], search_code → MCPCodeSearchItem[], search_unified → MCPCiqItem[]/MCPHazardousItem[]/MCPPortItem[].

{
  "toolName": "get_code_detail",
  "arguments": {
    "country": "CN",
    "code": "3926909090"
  }
}