一个端点，五种法律工具，复制即用

支持的方法

每个 POST 只接受一条 JSON-RPC 2.0 消息；批量数组返回 400 -32600。

请求头

请求体与版本协商

• 请求体是单条 JSON-RPC 2.0 消息；批量数组不受支持，返回 400 -32600。
• 协议版本放在 body.params._meta['io.modelcontextprotocol/protocolVersion']（顶层 _meta 作为宽松回退也接受）；与 MCP-Protocol-Version 头不一致时返回 -32020。
• 请求体上限 2MB；超限返回 HTTP 413 + JSON-RPC -32000，不会断连。

最小请求体示例（server/discover）

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "server/discover",
  "params": {
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28"
    }
  }
}

响应格式

• SSE（Accept 含 text/event-stream）：连接建立后先发 : connected；每条消息为 event: message + data: <JSON-RPC>；tools/call 带 progressToken 时先发 notifications/progress（≥250ms 节流，progress 为当前已生成字符数），空闲时每 15 秒发 : ping 注释帧保活，最后发送最终响应并关闭流。
• JSON（Accept 不含 text/event-stream）：返回单条 JSON-RPC 响应。
• 通知（无 id）：HTTP 202 空 body。

tools/call 成功结果字段

调用示例

server/discover（JSON 模式）

curl -sS -X POST "https://accurlex.com/mcp/stream" \
  -H "Authorization: Bearer ak_live_YOUR_API_KEY" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28"}}}'

tools/call（SSE 流式）

curl -sS -N -X POST "https://accurlex.com/mcp/stream" \
  -H "Authorization: Bearer ak_live_YOUR_API_KEY" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: accurlex_legal_qa" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"accurlex_legal_qa","arguments":{"question":"合同约定的违约金过高时，可以请求法院调整吗？","mode":"deep"},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","progressToken":123}}}'

SSE 响应（先进度通知，后最终结果）

: connected

event: message
data: {"jsonrpc":"2.0","method":"notifications/progress","params":{"progressToken":123,"progress":42,"message":"生成中…"}}

event: message
data: {"jsonrpc":"2.0","id":1,"result":{"resultType":"complete","content":[{"type":"text","text":"..."}],"structuredContent":{"answer":"...","original_content":"...","citations":[],"warnings":[],"mode":"deep","generation_id":"...","request_id":"..."},"isError":false}}

工具级失败（HTTP 仍为 200，靠 isError 判断）

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resultType": "complete",
    "content": [{ "type": "text", "text": "API Key 无效或未启用对应 scope" }],
    "structuredContent": {
      "error": "scope_denied",
      "message": "API Key 无效或未启用对应 scope",
      "hint": "请在开放平台控制台确认 API Key 已启用 scope: qa_expert"
    },
    "isError": true
  }
}

工具参数

accurlex_legal_qa 法律问答

accurlex_law_search 法条检索

accurlex_contract_review 合同审查

accurlex_document_draft 文书生成

accurlex_account_usage 用量自查

无参数。返回当前 API Key 的用量、剩余点数和近 30 天调用统计。

错误码

错误分两层：协议/传输层错误返回 JSON-RPC error 字段 + 4xx/413；工具级错误HTTP 仍为 200， 通过 result.isError === true 和 structuredContent.error 表达。

协议层 JSON-RPC 错误码

HTTP 状态码

工具级错误码（structuredContent.error）

额度、计费与限流

计费阶梯与 REST v1 一致：输入超过 10,000 字符按 2 倍、超过 20,000 字符按 3 倍计点（以 PHP 计费策略版本为准）。

取消与幂等

• SSE 连接关闭即取消：计费前断连不扣费；计费后断连自动退款，并在用量台账记为 cancelled。JSON 响应模式同样监听断连并取消。
• 服务端无状态、不缓存结果：首笔任务未完成时按 payload 指纹去重（idempotent_replay），不会二次扣费；首笔已完成时重发会作为新调用再次计费（at-least-once）。

限流

IP 层限流返回 HTTP 429 普通 JSON；工具级限流返回 isError: true + too_many_requests。