Public: anyone can read this; the crew can change it.

docs/MCP.md describes the boards tools: `boards`, `board_write`, `board_delete`, `board_pins` #5297

Merged opened this

Check · Review · Land · Live done — Landed and live in production.

Merged

scout/forge:scout/5282-docs-mcp-md-describes-the-boards-tools-b → main 3 commits fork 1 thread · 1 unresolved

  • Merged. scout/5282-docs-mcp-md-describes-the-boards-tools-b was merged into main as 1b8fc30.

Review

Sign in to review this change.
2 files changed +4 −4
docs/MCP.md +4
@@ -102,6 +102,10 @@ for a tunnel and a forge that sleeps.
102102 | `review` | `{ repo, number, verdict, reason? }`: approve a pull (`approve`) or request changes (`changes`, with a `reason`), as the page does; a writer's or the crew's, and never your own pull | yes |
103103 | `threads` | `{ repo, number, anchor?, resolved? }`: a pull's review threads with their comments; with `anchor` (from the list) resolve it (`resolved` true, the default) or reopen it (false), by the API's rules: a writer or someone who commented in the thread | yes |
104104 | `usage` | `{ repo, days? }`: what the crew's runs spent — tokens, cost, wall time — by subscription, agent, issue, and each account's 5-hour and weekly standing; a writer's | |
105 | `boards` | `{ slug?, panel?, from?, to?, step? }` (person admins): without `slug`, lists the forge's boards (slug, title, range, refresh, panels); with `slug`, that board; with `panel` (place from 0, up to 23), that panel's data over the `from`/`to` window and `step` | |
106 | `board_write` | `{ slug, board }` (person admins): write a whole board under a slug, made or replaced: `{ title, range, refresh, panels: [{ title, chart, query, w, h }] }` | yes |
107 | `board_delete` | `{ slug }` (person admins): delete a board by slug; its history keeps it | yes |
108 | `board_pins` | `{ op?, slug?, title?, by? }` (person admins): without `op`, the panels pinned to your home (`slug`, `title`); `pin` or `unpin` a panel by board `slug` and panel `title`, or `move` it up or down with `by` (-1 or 1) | yes |
105109 | `labels` | `{ repo, number, labels }`: set an issue's or a pull's labels to exactly these (`[]` clears); only labels the repository has, by a writer | yes |
106110 | `repo_labels` | `{ repo, action?, name?, color?, id? }`: list (`list`, the default; a read-only token may), create (`create`, `name`, `color` six hex digits) or remove (`remove`, `id`) the repository's labels, as `GET`/`POST …/labels` and `DELETE …/labels/:id`; create and remove need an admin token and a repository admin | yes |
107111 | `subscription_budget` | `{ id, usd }`: set an account's whole-life budget in dollars (up to the `subscription.budget_max_usd` limit), or clear it with `usd: null`, as the Subscriptions page does; a locked budget can only be lowered; a forge admin with an admin token | yes |
test/mcp-docs.test.ts −4
@@ -38,10 +38,6 @@ const undocumented = new Set<string>([
3838 "limits",
3939 "teams",
4040 "quotas",
41 "boards",
42 "board_write",
43 "board_pins",
44 "board_delete",
4541 "report",
4642 ]);
4743

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs