docs(mcp): add precise tool reference to the AI assistants guide

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: Ripwords

docs/guide/mcp.md

@@ -17,6 +17,35 @@ Connected assistants can:
 
 Assistants run **as you** — they can only read or change projects you're a member of, and they're bound by the same role permissions (viewer / manager / developer / owner). They cannot manage settings, members, or integrations.
 
+## Tool reference
+
+The server exposes these tools. Read tools need **viewer** on the project; write tools need **manager** or above. List tools are cursor-paginated (`limit` capped at 50, default 25) and return newest-first with a `nextCursor` (`null` when exhausted).
+
+### Read
+
+| Tool | Parameters | Notes |
+|---|---|---|
+| `repro_list_projects` | — | Projects you're a member of, with your role. |
+| `repro_list_tickets` | `projectId`, `status[]?`, `priority[]?`, `tag[]?`, `query?`, `cursor?`, `limit?` | Filtered, paginated ticket list. |
+| `repro_get_ticket` | `ticketId` | Full ticket: context, system info, console + network logs, replay transcript, attachments. **Cookies are not included.** |
+| `repro_list_ticket_comments` | `ticketId`, `cursor?`, `limit?` | Paginated comment thread. |
+| `repro_get_screenshot` | `ticketId` | Returns the screenshot as an image. Errors if larger than 1 MB. |
+| `repro_get_replay_transcript` | `ticketId`, `verbosity?` (`"summary"` \| `"detailed"`) | Textual replay timeline; truncates with a `truncated` flag if oversized. |
+| `repro_get_replay_raw` | `ticketId`, `acknowledgeSize?` | Raw rrweb event JSON. Errors above 200 KB unless `acknowledgeSize: true`. |
+| `repro_get_ticket_cookies` | `ticketId` | **Opt-in.** Captured cookies — may include session tokens. |
+| `repro_list_project_members` | `projectId` | Dashboard members and their project roles. |
+
+### Write (manager and above)
+
+| Tool | Parameters | Notes |
+|---|---|---|
+| `repro_update_ticket` | `ticketId` + at least one of `status?`, `priority?`, `tags?`, `assignees?` (GitHub logins), `milestone?` | Atomic partial update. Assignees/milestone require a connected GitHub integration. |
+| `repro_add_comment` | `ticketId`, `body` (markdown, 1–65536 chars) | Mirrored to GitHub if the ticket is linked. |
+| `repro_link_github_issue` | `ticketId`, `repoOwner`, `repoName`, `issueNumber` | Async; labels/assignees/status reconcile on the next sync tick. |
+| `repro_unlink_github_issue` | `ticketId` | Idempotent — returns `{ unlinked: false }` if it wasn't linked. |
+
+Errors are returned with typed codes: `NOT_FOUND` (404), `FORBIDDEN` (403, permission denied or disabled user), `INVALID_INPUT` (400), `PAYLOAD_TOO_LARGE` (413, screenshot > 1 MB or raw replay > 200 KB).
+
 ## Connect an assistant
 
 Sign in to your dashboard and visit **Settings → AI assistants (MCP)**. The page shows ready-to-paste configuration for each major client.