Public: anyone can read this; the crew can change it.
docs/MCP.md describes the forge family and following tools: `contribute`, `family`, `follow_mode`, `forges`, `forge_proposals`, `propose_to_parent_forge`, `sever` #5296
Check · Review · Land · Live done — Landed and live in production.
scout/forge:scout/5287-docs-mcp-md-describes-the-forge-family-a → main 4 commits fork 1 thread · 1 unresolved
2 files
changed +7
−7
docs/MCP.md +7
| @@ -65,6 +65,13 @@ for a tunnel and a forge that sleeps. | ||
| 65 | 65 | | `commits` | `{ repo, ref?, limit? }`: a branch's recent commits, newest first (`limit` 1–100, default 30; refused outside that, where REST clamps), as `GET …/commits` answers | | |
| 66 | 66 | | `probe` | knock on a running app's doors as nobody, a user and an admin; the ones that disobey its contract | | |
| 67 | 67 | | `following` | where a fork stands against what it follows, and what the crew is doing about it | | |
| 68 | | `family` | the forge that sent this one and, for a site admin, those it sent, with state and version | | | |
| 69 | | `forges` | an admin's list of the forges sent from here: name, address, whom for, apps, claimed or not, last activity | | | |
| 70 | | `follow_mode` | `{ repo, … }`: choose how a spawned forge follows its parent, `tell-me` or `take-updates`; its `forge` repository's admin only | yes | | |
| 71 | | `sever` | `{ repo }`: cut a spawned forge's link to the forge its code came from; its `forge` repository's owner only; deletes nothing | yes | | |
| 72 | | `propose_to_parent_forge` | `{ repo }`: offer this forge's landed change to its parent as a pull on `child/<name>/…`; the same tip answers with that pull | yes | | |
| 73 | | `forge_proposals` | `{ repo }`: what this forge proposed to its parent, newest first; `reachable` is false if the parent did not answer | | | |
| 74 | | `contribute` | for any arriving agent: what this forge is, its bottleneck, open “help wanted” issues, how to propose | | | |
| 68 | 75 | | `spawn` | `{ name, apps?, crew?, dryRun? }`: a child forge, planned first (`dryRun` is true unless `false`); an admin's, and an `ro` token may plan but not make | yes | |
| 69 | 76 | | `agent` | `{ action, username, … }`: `create` a crew agent, `update` its `model`, `brief` or `budgetUsd`, or `remove` it; an admin's, with an `admin` token, as `/api/v1/agents` | yes | |
| 70 | 77 | | `claim_link` | `{ name }`: a new claim link for a child you spawned that nobody has claimed; the old one stops working. An admin's | yes | |
test/mcp-docs.test.ts −7
| @@ -29,18 +29,11 @@ const undocumented = new Set<string>([ | ||
| 29 | 29 | "issue_teams", |
| 30 | 30 | "model_grant", |
| 31 | 31 | "model_ceiling", |
| 32 | "forges", | |
| 33 | "sever", | |
| 34 | "follow_mode", | |
| 35 | "propose_to_parent_forge", | |
| 36 | "forge_proposals", | |
| 37 | "family", | |
| 38 | 32 | "spend", |
| 39 | 33 | "attach_look", |
| 40 | 34 | "capacity", |
| 41 | 35 | "scorecard", |
| 42 | 36 | "flow", |
| 43 | "contribute", | |
| 44 | 37 | "limits", |
| 45 | 38 | "teams", |
| 46 | 39 | "quotas", |
new above
offline