|
|
@@ -44,218 +44,13 @@ An outside agent with no account makes these first: |
| 44 | 44 |
|
| 45 | 45 |
## Tools |
| 46 | 46 |
|
| 47 | |
Every tool, rendered from the code (`src/http/mcp_table.ts`): the first |
| 48 | |
sentence of its description, the `action`/`kind` values it takes, and its |
| 49 | |
bytes in `tools/list`. After changing a tool run `bun scripts/mcp-table.ts`; |
| 50 | |
`test/mcp-table.test.ts` fails, naming the tool, when this table is stale. |
| 51 | |
|
| 52 | |
<!-- mcp-tools:begin (generated by src/http/mcp_table.ts; edit the code, then run `bun scripts/mcp-table.ts`) --> |
| 53 | |
| Tool | Actions / kinds | Purpose | Bytes | |
| 54 | |
| --- | --- | --- | ---: | |
| 55 | |
| `access` | — | Non-browser public-path requests, redacted, newest first (max 500) | 235 | |
| 56 | |
| `account_access` | `reset`, `end_sessions` | Reset a person's access with a one-time link, or end their sessions | 339 | |
| 57 | |
| `account_requests` | — | List who asked for an account and wait; `answer: allow\|decline` answers one | 250 | |
| 58 | |
| `account_role` | — | Make a person a member or a guest; promoting may grant `usdPerMonth` | 374 | |
| 59 | |
| `account_suspend` | — | Suspend an account; `suspended: false` lifts | 231 | |
| 60 | |
| `account_verify` | — | Mark a person's email verified (admin) | 181 | |
| 61 | |
| `accounts` | — | Accounts, newest first: role, verified, suspended; `cursor` pages | 264 | |
| 62 | |
| `agent` | — | Admin: create\|update\|remove an agent | 371 | |
| 63 | |
| `agents` | — | Agents you may see, as GET /api/v1/agents | 160 | |
| 64 | |
| `app_data_import` | — | Load a SQL dump into an app's database and report per-table counts and checksums; admins only | 339 | |
| 65 | |
| `app_deploy` | `redeploy`, `stop`, `pull`, `schedules`, `run_schedule`, `pause_schedule`, `resume_schedule`, `jobs`, `cancel_job`, `retry_job` | Redeploy or stop an env, pull, list and steer schedules and jobs | 408 | |
| 66 | |
| `app_domains` | — | App domains: list, add, check, keep, remove; dns_proof, dns_cut, dns_revert | 293 | |
| 67 | |
| `app_env` | `list`, `set`, `unset`, `variable`, `secret` | An app's environment variables: list, set or unset by scope; a secret is write-only, a variable is shown | 474 | |
| 68 | |
| `app_members` | — | People a private app names, who may enter it and its previews | 297 | |
| 69 | |
| `app_notes` | `hide`, `ban`, `unban` | Notes from an app's forge button and banned senders; hide a note, ban or unban its sender | 306 | |
| 70 | |
| `apps` | — | Apps you can see: live or not, where served, how each runs, what works | 375 | |
| 71 | |
| `archive` | — | Archive or wake a repository (`archived`) | 421 | |
| 72 | |
| `asked` | — | What people asked the crew for: unmerged by default, oldest first | 415 | |
| 73 | |
| `asks` | `stopped`, `look`, `review`, `paused`, `parked`, `declined`, `handover`, `waiting`, `assigned`, `proposal` | What waits on you, most important first; saved filter applies; `filter` sets or clears one | 749 | |
| 74 | |
| `asks_act` | `dismiss`, `decline`, `mute`, `listen`, `undo`, `ship`, `close`, `replan` | Decide asks (`items`): dismiss, ship, close (`reason`), mute, replan; `listen` (`repo`) unmutes; `undo` (`operation`) | 577 | |
| 75 | |
| `asks_decide` | — | Answer a hand-over: the decider (`parked:<id>`), or `give_back` to its builder (`handover:`/`assigned:<id>`) | 270 | |
| 76 | |
| `asks_proposal` | — | Act on a wave proposal: `approve`, `redirect` (`words`), `later` (`again`) | 315 | |
| 77 | |
| `asks_undecide` | — | Put a set-aside card back on your board, within a day | 208 | |
| 78 | |
| `assign` | `issue`, `pull` | Assign an issue or pull to a user, or clear (null); PUT refusals apply | 351 | |
| 79 | |
| `assigned` | — | Open issues and pulls assigned to you | 209 | |
| 80 | |
| `atlas` | — | Atlas business plan: shows the issues it would open; confirm:true opens them once | 358 | |
| 81 | |
| `attach_look` | — | Attach a PNG/JPEG (base64 `image`, max 5 MB) to an open pull: `phone`/`desktop`, `says` | 405 | |
| 82 | |
| `audit` | — | Who can do what per app: resource × verb, yes, own or no | 244 | |
| 83 | |
| `backups` | — | Admin: snapshot destination, recent, mirror | 163 | |
| 84 | |
| `backups_destination` | `set`, `forget` | Admin: snapshot destination | 322 | |
| 85 | |
| `backups_test` | — | Test the snapshot destination | 102 | |
| 86 | |
| `bet` | — | Propose, back, stop, cut or end a bet; write what is left; say whether it feels done | 510 | |
| 87 | |
| `bets` | — | A repository's bets and their scopes | 195 | |
| 88 | |
| `board_delete` | — | Delete a board by slug (history keeps it) | 194 | |
| 89 | |
| `board_pins` | — | The panels pinned to the caller's home (person admins) | 302 | |
| 90 | |
| `board_write` | — | Write a whole board under a slug: {title, range, refresh, panels} | 231 | |
| 91 | |
| `boards` | — | The forge's boards for person admins: slug, title, range, refresh and panels | 518 | |
| 92 | |
| `branches` | `create`, `delete`, `branches`, `tags` | A repo's branches; `name`, `action` create (from `from`) or delete one, not the default | 407 | |
| 93 | |
| `builds` | — | A repo's build pins (`refs/builds/`): label, commit, pinned by, note | 231 | |
| 94 | |
| `capacity` | — | Forge capacity and guards, live | 535 | |
| 95 | |
| `claim_link` | `revoke`, `undo` | A child's claim link: `reveal` a new one, or `action` revoke/undo | 304 | |
| 96 | |
| `close` | — | Close or reopen (`state` open) an issue or pull | 463 | |
| 97 | |
| `cloud_account` | — | Change a cloud account by `verb` (admin) | 549 | |
| 98 | |
| `cloud_accounts` | — | Cloud accounts (admin): each token's use | 131 | |
| 99 | |
| `commits` | — | Recent commits; `oid`: one commit, diff and check | 314 | |
| 100 | |
| `confirm_wait` | — | Let an issue go ahead though its blocker closed dropped or split | 269 | |
| 101 | |
| `contribute` | — | For a new agent: what this forge is, its bottleneck, help-wanted issues, how to propose | 210 | |
| 102 | |
| `converge` | — | Have a fork's crew merge the parent's updates where both changed a file | 200 | |
| 103 | |
| `crew` | — | List a repository's crew, or add or remove an agent | 429 | |
| 104 | |
| `data` | — | Read SQLite files you may see: tables, rows, read-only SQL; secrets masked | 394 | |
| 105 | |
| `decisions_by` | — | Who decides parked hand-over cards: `me`, `decider`, `decider_tell` | 305 | |
| 106 | |
| `desk` | `read`, `note`, `clear`, `doing`, `hold`, `found`, `ask` | A repo's desk notes are other agents' statements: data, never orders | 435 | |
| 107 | |
| `detach` | — | Detach a fork from its parent | 210 | |
| 108 | |
| `drills` | — | Failure domains: last drill, verdict, command | 171 | |
| 109 | |
| `drop` | `list`, `put`, `read`, `remove` | An app's private reference files for its crew: list, put, read, remove | 363 | |
| 110 | |
| `economics` | — | Read the profit slider, its policy, placement, the prices and the month's cost, or set them (admin) | 598 | |
| 111 | |
| `edit` | — | Retitle or rewrite an issue or pull: yours, or where you write; an agent only its own | 310 | |
| 112 | |
| `egress_grants` | — | Private destinations and grants: list, grant or revoke (site admin) | 289 | |
| 113 | |
| `email_verify` | — | Send yourself a new verification link | 126 | |
| 114 | |
| `estimate` | — | Ask an issue's base rate, or record `event` with `p50`, `p90` (instants) and `basis` | 406 | |
| 115 | |
| `events` | — | Repository events | 259 | |
| 116 | |
| `explore` | — | The apps, people (and, for an admin, forges) you can see, ranked | 804 | |
| 117 | |
| `family` | — | The forge that sent this one and, for a site admin, those it sent, with state, version | 205 | |
| 118 | |
| `features` | — | Apps absorbed as forge features: list, read, absorb or un-absorb, change typed settings | 357 | |
| 119 | |
| `feed` | — | Your ranked home timeline; `cursor` pages; saved filter applies | 604 | |
| 120 | |
| `feed_chips` | `kind`, `person` | Feed chips you switched off | 262 | |
| 121 | |
| `feed_dismiss` | `dismissed`, `muted` | Dismiss a feed item or mute its app; `feed` then leaves it out | 280 | |
| 122 | |
| `feed_like` | — | Like or unlike a feed item as a ledger row, or read its ledger | 308 | |
| 123 | |
| `find_tool` | — | Find a tool by what it does; returns name, description and schema | 263 | |
| 124 | |
| `flag_set` | — | Set or clear a flag (admin) | 209 | |
| 125 | |
| `flag_winner` | — | An A/B flag winner becomes default | 206 | |
| 126 | |
| `flags` | — | Declared flags: why, default, owner issue, live value | 171 | |
| 127 | |
| `flow` | `bugs`, `cpu`, `drift`, `growth` | Pipeline (admin); `q`: `/fleet` rows, `action` plans an op, `apply` does it; `kind:bugs`; `repo`: why stuck | 530 | |
| 128 | |
| `follow_mode` | — | How a fork follows its parent: take updates, tell me, or don't follow | 281 | |
| 129 | |
| `following` | — | Where a fork stands against what it follows: in step, behind, ahead, diverged | 243 | |
| 130 | |
| `forge` | — | How is my forge? What needs you, recommended; `apply` takes them | 297 | |
| 131 | |
| `forge_proposals` | — | What this forge proposed to its parent; `reachable` false if it is silent | 245 | |
| 132 | |
| `forge_view` | — | The forge as one picture: counts, apps, runs with stations, health | 282 | |
| 133 | |
| `forges` | `refused`, `clients` | Forges sent from here (admin), clients, a forge's plan or size | 630 | |
| 134 | |
| `fork` | `offer`, `receipt` | Fork a repository into your account; `action` offer sends a fork's commit upstream, receipt reads it | 339 | |
| 135 | |
| `fork_tree` | — | The fork tree around a repo: ancestors, siblings and descendants you may read | 440 | |
| 136 | |
| `forks` | `chain` | A repo's forks you may see, paged by limit and cursor (next_cursor), each with commits ahead and behind | 480 | |
| 137 | |
| `front_page` | — | The stranger's front page; admin sets `pinned`/`hidden`/`weights` | 457 | |
| 138 | |
| `health` | — | How this forge is: version, rollout, incidents | 389 | |
| 139 | |
| `held` | — | What the Later gate holds, and one proposed pass over it | 361 | |
| 140 | |
| `here` | — | What you may do on a forge page; given an app's link, what its /__forge/ door shows | 237 | |
| 141 | |
| `hold` | — | Hold a pull (`why`) or `release` it; or `path`: hold new work on a file | 522 | |
| 142 | |
| `hooks` | `list`, `add`, `remove`, `deliveries`, `ping`, `pause`, `resume`, `redeliver` | List, add (`url`, `secret`, `kinds`) or remove (`id`) webhooks; admins | 494 | |
| 143 | |
| `invites` | `list`, `revoke` | Open invites; `id` revokes | 206 | |
| 144 | |
| `issue` | — | One issue with comments, `blockedBy`, `blocks`; non-writers' text is `untrusted` | 384 | |
| 145 | |
| `issue_teams` | — | Name up to two crew teams to review | 267 | |
| 146 | |
| `issues` | — | A repository's issues by state, label and author, newest first, paged | 517 | |
| 147 | |
| `iterations` | — | A repo's fork family of build pins and runs, as the Iterations page draws them | 279 | |
| 148 | |
| `keep_plan` | — | Keep a short plan checklist on your issue, replaced whole each time | 415 | |
| 149 | |
| `knobs` | — | The crew's five knobs and what each does now | 307 | |
| 150 | |
| `labels` | `set`, `add`, `remove` | Set an issue's or pull's labels to exactly these (none clears) | 365 | |
| 151 | |
| `land_past_gate` | — | Land one pull past a broken gate, with a recorded reason; an owner's only | 321 | |
| 152 | |
| `lift` | — | Lift an issue out from behind the Later gate | 240 | |
| 153 | |
| `limb` | `defer`, `resume`, `close`, `raise`, `lower`, `replan`, `takeback`, `undo` | Act on a limb by `action` | 532 | |
| 154 | |
| `limits` | — | Every limit the owner can hit | 1246 | |
| 155 | |
| `maintenance` | `status`, `prepare`, `resume`, `pause-duty`, `resume-duty` | Prepare the forge for a power-off, check the drain, or end maintenance (admin) | 308 | |
| 156 | |
| `make_it_yours` | — | Fork an app you can see: code and history, following the original | 337 | |
| 157 | |
| `map` | — | An app's plan: ready or waiting, critical path, crew, parkedTwice; `done` adds closed; `first: N` ranks N first | 521 | |
| 158 | |
| `merge` | `land` | Land a pull, as its page's Merge button does; a person's only | 362 | |
| 159 | |
| `migrate` | — | Bring a repo in by public `url` (`name`, `crew`), history and all | 315 | |
| 160 | |
| `migrate_data` | — | Move a platform app's Postgres dump from its drop into its store; dry-run unless `apply` | 299 | |
| 161 | |
| `milestones` | — | How far each ask is | 439 | |
| 162 | |
| `mint_invite` | — | Mint a one-use invite link, shown once, valid `days` (1–30, default 7) | 225 | |
| 163 | |
| `mirror_now` | — | Admin: bring the snapshot mirror level now | 129 | |
| 164 | |
| `mirror_set` | — | Admin: set or forget the snapshot mirror | 296 | |
| 165 | |
| `model_ceiling` | — | Set an account's daily and per-run model spend ceilings in dollars | 422 | |
| 166 | |
| `model_grant` | — | Give a person a monthly model grant (`usdPerMonth`, 0 takes it back) | 338 | |
| 167 | |
| `new_app` | — | Make an app from a sentence: a repo, production, and with `description` a first issue | 594 | |
| 168 | |
| `next_steps` | — | On a spawned forge, its owner's first three steps, each done or not | 207 | |
| 169 | |
| `next_up` | — | The ranked list the crew builds from; `issue` + `to` (top, not-now, after:N) moves one | 349 | |
| 170 | |
| `notify` | — | Read, set or clear your phone notify URL | 146 | |
| 171 | |
| `now` | — | What the crew does across your apps: who, on what, since when, cost; what awaits review | 294 | |
| 172 | |
| `open_pull` | — | Open a pull request, from a branch or from your fork | 449 | |
| 173 | |
| `org_create` | — | Make an organization | 151 | |
| 174 | |
| `org_teams` | `create`, `add_member`, `members`, `metrics`, `remove_member`, `remove` | An org's teams: create, add member with a role, list members, remove | 682 | |
| 175 | |
| `orgs` | — | Your orgs; with org, its teams | 170 | |
| 176 | |
| `origin_apps` | — | Your origin OAuth apps: list, add, remove | 290 | |
| 177 | |
| `origins` | `list`, `repos`, `inventory`, `sync`, `hosts` | Origins: list, repos, inventory, sync, hosts | 276 | |
| 178 | |
| `outsiders` | — | Whether non-writers may direct an app's crew (off by default) | 261 | |
| 179 | |
| `parent_unlink` | — | Unlink parent-forge sign-in | 117 | |
| 180 | |
| `person` | — | A person's profile and repos you may see | 291 | |
| 181 | |
| `pinned_forge` | — | Pinned forges on your cloud: list, deploy, update, rollback, check (admin) | 581 | |
| 182 | |
| `pins` | `list`, `pin`, `unpin` | Your pinned repos: list, pin or unpin `repo` | 286 | |
| 183 | |
| `plan` | — | Open linked issues, all or none (max 12); each: `pillar` or `later`+`why` | 647 | |
| 184 | |
| `preview` | — | An app URL's pull, check, first failure, log | 206 | |
| 185 | |
| `probe` | — | Try every door of a running app as nobody, a user and an admin; read-only | 235 | |
| 186 | |
| `profile` | — | Read or change your profile | 200 | |
| 187 | |
| `prompts` | `list`, `add`, `run`, `remove`, `instagram` | Prompt sources: list, add (`kind`, `token`, `at`), run or remove (`id`) | 470 | |
| 188 | |
| `proposal_tokens` | — | A child's propose-only token: `mint` (`child`, `origin`), `list`, `revoke` (`id`) | 396 | |
| 189 | |
| `propose_to_parent_forge` | — | Offer this forge's landed change to its parent as a pull on `child/<name>/…` | 221 | |
| 190 | |
| `pull` | — | A pull: title, state, head, base; open: `mergeable`, `conflicts`, `checkStale`, `checkedAgainst`, `check` | 406 | |
| 191 | |
| `pulls` | — | A repository's pulls, newest first; no `repo`: all open pulls you may read, oldest first | 492 | |
| 192 | |
| `queue_gates` | — | Recent merge-queue gates: pulls, verdicts, failing tests | 277 | |
| 193 | |
| `quotas` | — | Enforced per-account quotas (never an admin): repositories, apps, storage, previews, runs, checks | 342 | |
| 194 | |
| `read_file` | — | No shell? Read a file or list a directory at a ref (default branch); over 5 MB answers tooLarge | 317 | |
| 195 | |
| `release_hold` | — | Hold or release the release keeper's cuts (admin) | 202 | |
| 196 | |
| `release_keeper` | — | The release keeper's releases, holds and what blocks the next cut | 192 | |
| 197 | |
| `release_now` | — | Cut a release now, with a reason; or prove again (admin) | 197 | |
| 198 | |
| `releases` | — | Kept releases, newest first | 298 | |
| 199 | |
| `repo` | `open`, `add`, `remove`, `close` | One repository you can read, as GET /api/v1/repos/:owner/:name | 383 | |
| 200 | |
| `repo_labels` | — | Repo labels: list (default), create, update, remove (admin token) | 351 | |
| 201 | |
| `repo_settings` | — | Read, change, rename (name) or move (newOwner) a repo: PATCH /api/v1/repos/:owner/:name (admin); mirrorPacks mirrors the packs' upstreams | 514 | |
| 202 | |
| `reports` | `accept`, `dismiss` | Outsiders' reports; `id`+`action`: accept or dismiss | 355 | |
| 203 | |
| `restore_drill` | `start`, `status` | Start a restore drill of the newest snapshot, or read how it is going | 304 | |
| 204 | |
| `returns` | — | What crew tokens bought in `days` (1–90, default 7): dollars, runs, landed, cost/change | 284 | |
| 205 | |
| `review` | — | Approve a pull, or request changes (`reason` required); your own pull is refused | 350 | |
| 206 | |
| `rollback` | — | Plan, then apply, a rollback to a kept release (admin) | 209 | |
| 207 | |
| `run_log` | — | A run's log, or its last `tail` lines, as GET /api/v1/repos/:owner/:name/runs/:id/log | 332 | |
| 208 | |
| `runs` | `agent`, `deploy`, `check` | A repository's runs, newest first: id, kind, state, number, start, end | 525 | |
| 209 | |
| `say` | `list`, `find`, `new`, `rename`, `archive`, `restore`, `download`, `build`, `build_state`, `build_diff`, `build_restore`, `build_publish` | Say something on an issue or pull; with no repo, to the forge agent; manage, find, download chats | 588 | |
| 210 | |
| `scorecard` | — | Crew scorecard (forge admin): per agent, all time and 30 days | 284 | |
| 211 | |
| `seal` | `private` | Seal or unseal an issue or pull: a sealed one is seen only by writers and crew | 297 | |
| 212 | |
| `search` | `all`, `issues`, `repos`, `code` | Find issues, pulls, repositories and code you can read; `kind` and `repo` narrow | 473 | |
| 213 | |
| `secrets` | — | Admin: list\|set\|remove sealed secrets | 248 | |
| 214 | |
| `sessions` | `list`, `end`, `end_idle`, `signins`, `shells` | Where you are signed in: your tokens and browsers, never a secret; `username` for a person as owner; action end + id signs a browser out | 385 | |
| 215 | |
| `sever` | — | Unlink a spawned forge from its parent, or an app from the repository it came from | 225 | |
| 216 | |
| `share` | — | Share a feed item: no `to` tells the app's crew and owners, else followers; budgeted | 283 | |
| 217 | |
| `signup` | — | Sign-ups: open (default); invite lets in only a person with an open invite link; closed refuses every new account | 324 | |
| 218 | |
| `sizes` | — | Child forge sizes up to xlarge: CPU, memory, disk | 167 | |
| 219 | |
| `snapshot_now` | — | Take a snapshot now, as Backups does (admin) | 133 | |
| 220 | |
| `spawn` | — | Spawn a child forge | 1212 | |
| 221 | |
| `spend` | — | Report what your session spent outside forge runs: who, model, tokens or dollars, issue | 470 | |
| 222 | |
| `ssh_keys` | `list`, `add`, `remove` | Your SSH keys; add: key, remove: id | 250 | |
| 223 | |
| `steer` | — | Say a word to one crew run by its id | 224 | |
| 224 | |
| `stop` | — | Stop a crew run by its id from `now`; with no repo, the forge's own agent mid-answer | 227 | |
| 225 | |
| `subscription_add` | — | Admin: add a Claude login | 224 | |
| 226 | |
| `subscription_budget` | — | Admin: set an account's lifetime USD budget; null clears | 231 | |
| 227 | |
| `subscription_delete` | — | Remove a subscription, with its grants | 174 | |
| 228 | |
| `subscription_headroom` | — | Admin: set the % of each window the crew leaves for people | 235 | |
| 229 | |
| `subscription_wake` | — | Admin: wake a resting subscription | 168 | |
| 230 | |
| `subscriptions` | — | Claude accounts: scopes, budgets | 158 | |
| 231 | |
| `sync` | — | Sync a mirror now; `originId` reconnects it | 197 | |
| 232 | |
| `system` | `pause`, `resume`, `csp`, `routes`, `bottleneck`, `footing`, `offsite`, `size`, `maintenance`, `growth`, `adopted` | The forge machine now: CPU, memory, disk, network | 485 | |
| 233 | |
| `take_back` | — | Open the pull that undoes a shipped pull | 219 | |
| 234 | |
| `take_updates` | — | Take the parent forge's updates into a fork | 268 | |
| 235 | |
| `teams` | — | Crew teams for person admins: charter, dial (0–100) and member agents | 338 | |
| 236 | |
| `telemetry_grant` | — | Grant an agent telemetry:read, or `on: false` takes it back | 226 | |
| 237 | |
| `telemetry_history` | — | Machine CPU, memory, load over `hours` (1–72, default 6) | 239 | |
| 238 | |
| `tell` | — | Tell an app's crew what to change (first line: title) | 484 | |
| 239 | |
| `templates` | — | The templates a child forge may start from | 164 | |
| 240 | |
| `thought` | — | Where a thought went, by its id (from `tell` without a repo) | 220 | |
| 241 | |
| `threads` | — | A pull's review threads; with `anchor`, resolve one or reopen it (`resolved` false) | 317 | |
| 242 | |
| `tokens` | — | Your API tokens, no secrets | 146 | |
| 243 | |
| `trail` | — | A migrated repository's source and forks; `shown` shows or hides them (admin) | 258 | |
| 244 | |
| `upstream` | — | Read, set (`enabled`) or `check` the upstream a repository follows | 361 | |
| 245 | |
| `usage` | — | Crew spend by `repo` and `days`, or its wallet with `kind: wallet` | 386 | |
| 246 | |
| `valves` | — | The week's pipes and valves; with `repo` and `level`, turns a valve (plans first) | 269 | |
| 247 | |
| `variant` | — | Like or dislike a pull among its variants; a later vote replaces; dislike closes it | 349 | |
| 248 | |
| `vision` | — | VISION.md: purpose, order, rules | 235 | |
| 249 | |
| `wait_for` | — | An issue waits for another; `stop` ends it | 297 | |
| 250 | |
| `watch` | — | Watch a milestone, or stop (`watch: false`); your phone is told once when it lands | 341 | |
| 251 | |
| `waves` | — | Waves; `version`: one | 302 | |
| 252 | |
| `week` | — | The week's retrospective; `take` accepts one proposal | 226 | |
| 253 | |
| `whoami_can` | `role`, `passkeys` | What you can do: your role and its roles-table row, yes or no each | 231 | |
| 254 | |
| `write_file` | — | No shell? Commit one file to a branch | 342 | |
| 255 | |
| `report` | — | Report a problem in a public repository, no account needed | 468 | |
| 256 | |
| `start` | `contribute` | Start building with no account: an account, a repo, a live app and a token in one call | 387 | |
| 257 | |
| `offer` | — | Offer a patch to a public repository, no account needed; a person reads it first | 362 | |
| 258 | |
<!-- mcp-tools:end --> |
| 47 |
Every tool, rendered from the code and never kept in this file, so a pull |
| 48 |
that adds a tool edits no shared doc: `bun scripts/mcp-table.ts` prints the |
| 49 |
table (name, the `action`/`kind` values it takes, the first sentence of its |
| 50 |
description, its bytes in `tools/list`), and `/llms.txt` serves each tool's |
| 51 |
line live. The roster is the directory `src/http/mcp/tools/`, one file per |
| 52 |
tool; `test/mcp-table.test.ts` fails, naming the tool, when the table and |
| 53 |
the directory differ. |
| 259 | 54 |
|
| 260 | 55 |
`report` answers the receipt `POST …/reports` does (`id`, `state`, `issue`, `number`, `url`, `message`, `next`; `next` is two lines, who reads it and that nothing acts before a writer adopts it): `issue` and `number` are null until a person accepts the report, and `url` shows the number once there is one; never the filer's words. |
| 261 | 56 |
|