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

支持的方法

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

请求头

请求体与版本协商

• 请求体是单条 JSON-RPC 2.0 消息；批量数组不受支持，返回 400 -32600。
• 2025-11-25：首次 initialize 在 params.protocolVersion 声明版本；后续请求通过 MCP-Protocol-Version 头声明，不使用 2026 扩展字段。
• 2026-07-28：版本放在 body.params._meta['io.modelcontextprotocol/protocolVersion']（顶层 _meta 作为宽松回退也接受）；与版本头不一致时返回 -32020。
• 请求体上限 2MB；超限返回 HTTP 413 + JSON-RPC -32000，不会断连。

2025 标准 initialize 请求体

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-11-25",
    "capabilities": {},
    "clientInfo": { "name": "workbuddy-compatible-client", "version": "1.0.0" }
  }
}

2026 扩展 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 为生成正文的 UTF-8 字节累计值，不是百分比或计费字符数），空闲时每 15 秒发 : ping 注释帧保活，最后发送最终响应并关闭流。
• JSON（Accept 不含 text/event-stream）：返回单条 JSON-RPC 响应。
• 通知（无 id）：HTTP 202 空 body。

tools/call 成功结果字段

调用示例

initialize（2025 标准握手，WorkBuddy 自动完成）

curl -sS -X POST "https://accurlex.com/mcp/stream" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"workbuddy-compatible-client","version":"1.0.0"}}}'

tools/list（2025 标准工具发现）

curl -sS -X POST "https://accurlex.com/mcp/stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

tools/call（2025 JSON 模式）

curl -sS -X POST "https://accurlex.com/mcp/stream" \
  -H "Authorization: Bearer ak_live_YOUR_API_KEY" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"accurlex_account_usage","arguments":{}}}'

server/discover（2026 扩展协议，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（2026 扩展协议，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 天的用量汇总 summary，以及最新 50 条调用记录 recent。

错误码

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "resultType": "complete",
    "content": [
      {
        "type": "text",
        "text": "请勿闲聊或讨论无关话题。"
      }
    ],
    "structuredContent": {
      "error": "upstream_rejected",
      "message": "请勿闲聊或讨论无关话题。",
      "statusCode": 200,
      "refunded": true
    },
    "isError": true
  }
}

协议层 JSON-RPC 错误码

HTTP 状态码

工具级错误码（structuredContent.error）

额度、计费与限流

计费阶梯与 REST v1 一致：输入超过 10,000 字符按 2 倍、超过 20,000 字符按 3 倍计点。问答 deep、法条 deep、法条 expert 限免期间各有每账号每天 100 次独立额度，同账号所有 Key、API 与 MCP 共用对应额度，上海时间 0 点更新。

取消与幂等

• 2026-07-28：SSE/JSON 连接关闭即取消；计费前断连不扣费，计费后断连自动退款，并在用量台账记为 cancelled。
• 2025-11-25：网络断开只停止响应写入，原调用继续执行并结算；需要取消时发送带原请求 ID 的 notifications/cancelled，不得因断线自动重放付费请求。
• 同一 API Key 下，相同 HTTP Idempotency-Key、接口和参数复用原任务，返回 idempotent_replay 和任务标识，不新增执行或扣费，也不回放首次正文。同键不同内容返回 idempotency_payload_conflict。未传幂等键的重发可能再次计费。一次操作的重试复用原键；下一次独立操作换新键。相同问题本身不保证去重，JSON-RPC ID 用于关联响应；2025 版还会拒绝执行中重复使用的请求 ID。

限流

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