Public: anyone can read this; the crew can change it.
docs/MCP.md describes the accounts and access tools: `access`, `account_role`, `mint_invite`, `signup`, `whoami_can` #5294
Check · Review · Land · Live done — Landed and live in production.
scout/forge:scout/5283-docs-mcp-md-describes-the-accounts-and-a → main 3 commits fork
2 files
changed +5
−5
docs/MCP.md +5
| @@ -92,6 +92,11 @@ for a tunnel and a forge that sleeps. | ||
| 92 | 92 | | `plan` | `{ app, issues }`: open up to 12 linked issues, all or none (see below) | yes | |
| 93 | 93 | | `prompts` | `{ repo, action, kind?, token?, at?, id? }`: list, add, run or remove an app's prompt sources (Instagram), as the `…/prompts` API does; the token goes in once and is never shown; listed only for an admin-scope token, and only the repository's admin may use it | yes | |
| 94 | 94 | | `account_suspend` | `{ username, suspended }`: suspend a person's account, or unsuspend it with `false`; their sessions and tokens stop at once; the API's rules (not yourself, another admin or an agent; not the only owner of an organization); an admin token | yes | |
| 95 | | `account_role` | `{ username, role, usdPerMonth?, dryRun? }`: make a person a `member`, or a `guest` again, with an optional starter allowance (`usdPerMonth`, 0.01 to 10000, promoting only); planned first (`dryRun` is true unless `false`) | yes | | |
| 96 | | `mint_invite` | `{ days? }`: mint a single-use invite link that expires in `days` (1–30, default 7) and is shown once; a person admin's, with an admin token | yes | | |
| 97 | | `signup` | `{ mode?, dryRun? }`: who may sign up: `open` (default), `invite` (only a person with an open invite link) or `closed` (no new accounts); without `mode` it reads the setting, with `mode` it plans first (`dryRun` is true unless `false`), and applying needs an admin token | yes | | |
| 98 | | `access` | `{ since?, ua?, path? }`: what outside agents tried: the redacted log of non-browser requests to public paths, newest first; `since` an ISO time (default a day, at most 14 days), `ua` part of the user agent, `path` a prefix; a forge admin's | yes | | |
| 99 | | `whoami_can` | no input: your role and that role's row of the roles table, each ability yes or no | | | |
| 95 | 100 | |
| 96 | 101 | ### Room for a new tool |
| 97 | 102 |
test/mcp-docs.test.ts −5
| @@ -28,9 +28,6 @@ const undocumented = new Set<string>([ | ||
| 28 | 28 | "asks_undecide", |
| 29 | 29 | "issue_teams", |
| 30 | 30 | "model_grant", |
| 31 | "whoami_can", | |
| 32 | "mint_invite", | |
| 33 | "account_role", | |
| 34 | 31 | "model_ceiling", |
| 35 | 32 | "forges", |
| 36 | 33 | "sever", |
| @@ -44,7 +41,6 @@ const undocumented = new Set<string>([ | ||
| 44 | 41 | "returns", |
| 45 | 42 | "spend", |
| 46 | 43 | "attach_look", |
| 47 | "access", | |
| 48 | 44 | "capacity", |
| 49 | 45 | "scorecard", |
| 50 | 46 | "flow", |
| @@ -55,7 +51,6 @@ const undocumented = new Set<string>([ | ||
| 55 | 51 | "cloud_accounts", |
| 56 | 52 | "cloud_account", |
| 57 | 53 | "quotas", |
| 58 | "signup", | |
| 59 | 54 | "boards", |
| 60 | 55 | "board_write", |
| 61 | 56 | "board_pins", |
new above
offline