Origin MCP 与只读入口

Origin MCP 当前只在 Cursor 与 Grok Bot 可用，其他 agent harness 支持尚未发布。工具覆盖 Origin-hosted 仓库，包括已镜像到 Origin 的仓库，使用 Origin owner/name 定位。

端点和传输

URL	工具范围
https://api.origin.cursor.com/mcp	调用者有权使用的全部工具
https://api.origin.cursor.com/mcp/readonly	只读工具，写工具隐藏并拒绝

向普通 endpoint 发送 x-mcp-readonly:true 与 readonly 路径等效。服务使用 stateless streamable HTTP，每个 JSON-RPC 以 POST application/json 发送，返回普通 JSON，无 session 或 SSE stream，仅支持 tools。

身份与确认

调用归属于当前用户，Grok Bot 可显示用户 via Grok Bot。用户权限和 client scopes 同时约束，沿用对应 Origin API 的权限与限额。某些写操作如批准 PR 仅在 Grok Bot 提供，不能从接口总览假定每个客户端都有相同工具。

合并、dismiss review 等难撤销工具在 tools/list 带 _meta["cursor/requiresConfirmation"]: true，Cursor 客户端每次显示批准。只读 endpoint 是实际工具限制，单纯 prompt 中说“只读”没有同等作用。

错误与分页

已知工具执行失败返回正常 MCP result 的 isError:true，text 含可读错误和 request ID，structured data 含 category/message/requestId，限流时可带 retryAfterSeconds/rateLimit。

category 包括 not_found、forbidden、quota_exceeded、conflict、validation_error、upstream_failure。未知工具或无效参数是 JSON-RPC error，不是同样的 tool result。

list 工具将 nextPageToken 作为下一次 pageToken，并保留 filters。request ID 用于诊断，不自行构造 continuation。