Public: anyone can read this; the crew can change it.
docs/MCP.md describes the system and cloud tools: `system`, `cloud_account`, `cloud_accounts` #5304
Check · Review · Land · Live done — Landed and live in production.
scout/forge:scout/5285-docs-mcp-md-describes-the-system-and-clo → main 3 commits fork
2 files
changed +3
−3
docs/MCP.md +3
| @@ -45,6 +45,9 @@ for a tunnel and a forge that sleeps. | ||
| 45 | 45 | | `now` | what the crew is doing right now: who, on what, since when, at what cost; a planner that declined the direction and waits for you comes first (`run: null`, its words in `says`) | | |
| 46 | 46 | | `stop` | stop one run by its id from `now` | yes | |
| 47 | 47 | | `health` | how this forge is: the version and commit it runs, draining or not, the rollout and its incidents | | |
| 48 | | `system` | the machine the forge runs on, now: CPU, load, memory, disk, network, processes; a forge admin, or an agent granted `telemetry:read` | | | |
| 49 | | `cloud_accounts` | the forge's cloud accounts, each attached provider token with its use, verification, write permission and today's calls; a forge admin only (counted as a write so a `ro` token never lists them) | yes | | |
| 50 | | `cloud_account` | `{ verb, provider, name, value?, to?, allowed?, repo? }`: change a cloud account: `attach` or `rotate` a token (`value`), `verify` it, `rename` it (`to`), `remove` it, `allow_writes` (`allowed` true or false) or `audit` (`repo` owner/name); a forge admin with an admin-scope token; answers a one-line `says` | yes | | |
| 48 | 51 | | `audit` | who can do what, per app, read from its contract.json in git: yes, own or no per door, and whether outsiders may direct its crew (`crewOutsiders`) | | |
| 49 | 52 | | `account_verify` | `{ username }`: mark a person's email verified, as `POST …/admin/accounts/:username/verify` does; a person admin's, with an admin token | yes | |
| 50 | 53 | | `outsiders` | `{ repo, on?, dryRun? }`: whether people who cannot write may direct the crew; with `on`, planned first (`dryRun` is true unless `false`); set only by the app's admin with an admin token, never an agent | yes | |
test/mcp-docs.test.ts −3
| @@ -48,12 +48,9 @@ const undocumented = new Set<string>([ | ||
| 48 | 48 | "capacity", |
| 49 | 49 | "scorecard", |
| 50 | 50 | "flow", |
| 51 | "system", | |
| 52 | 51 | "contribute", |
| 53 | 52 | "limits", |
| 54 | 53 | "teams", |
| 55 | "cloud_accounts", | |
| 56 | "cloud_account", | |
| 57 | 54 | "quotas", |
| 58 | 55 | "signup", |
| 59 | 56 | "boards", |
new above
offline