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

Merged opened this

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

Merged

scout/forge:scout/5285-docs-mcp-md-describes-the-system-and-clo → main 3 commits fork

  • Merged. scout/5285-docs-mcp-md-describes-the-system-and-clo was merged into main as 0775513.

Review

Sign in to review this change.
2 files changed +3 −3
docs/MCP.md +3
@@ -45,6 +45,9 @@ for a tunnel and a forge that sleeps.
4545 | `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`) | |
4646 | `stop` | stop one run by its id from `now` | yes |
4747 | `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 |
4851 | `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`) | |
4952 | `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 |
5053 | `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>([
4848 "capacity",
4949 "scorecard",
5050 "flow",
51 "system",
5251 "contribute",
5352 "limits",
5453 "teams",
55 "cloud_accounts",
56 "cloud_account",
5754 "quotas",
5855 "signup",
5956 "boards",

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs