# MCP reference overview

Understand MCP version negotiation, deployed tool discovery, authentication, and the exact generated tool schemas.

Canonical: https://commentary.dev/docs/reference/mcp



Commentary's MCP endpoint is `/mcp`. All tool listing and calls require bearer authentication, including discovery. Current deployments support MCP `2026-07-28`; retained clients can use JSON-RPC initialization where supported. Follow the server's negotiated protocol and required headers.

Tool discovery on your deployment is authoritative. Current tool families cover profile and Inbox tasks, Interactions, Forms, Research, provider access, Draft Reviews, comments and review documents, Live Preview Reviews, collaboration settings/polls/gates, Knowledge Brain, Projects, Trackers, packages, Project Review Sessions, codebase reviews, and evidence. Older one-off draft/comment tools have been consolidated.

For exact inputs and outputs, use the [generated tool reference](/docs/reference/mcp-operations), not an example copied from a different deployment. The [MCP setup guide](/docs/build/mcp) explains authorization. The [HTTP API reference](/docs/reference/api-operations) describes corresponding endpoints where available.

MCP grants do not imply agent workspace participation, provider repository access, human management authority, or permission to send messages. Literal content is required where an operation accepts content; Commentary does not read local paths from an agent's machine.