@anyforge/mcp-server 3.18.0 → 3.19.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +33 -7
- package/dist/index.js +23 -10
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -174,12 +174,14 @@ complete capability and local/remote workspace boundary.
|
|
|
174
174
|
| `anyforge_write_studio_workspace_file` | studio:execute | Create an empty file or save a file's complete content in the live remote workspace, without a model run. Name the repository, branch and revision you read, so a changed workspace is refused. Each write saves a checkpoint first. Does not commit or push. |
|
|
175
175
|
| `anyforge_rename_studio_symbol` | studio:execute | Apply a language-service rename of the symbol at a 1-based line and column across the live remote workspace. Preview it first with inspect_studio_code operation=rename. Name the repository, branch and revision you read; a changed workspace is refused. Does not commit. |
|
|
176
176
|
| `anyforge_list_pending_approvals` | read | List HIL approvals awaiting a decision |
|
|
177
|
-
| `anyforge_get_approval_detail` | read | Read one approval's plan / ADR / security context |
|
|
178
|
-
| `anyforge_submit_approval` | approve | Approve or reject a HIL (resumes the crew) |
|
|
177
|
+
| `anyforge_get_approval_detail` | read | Read one approval's plan / ADR / security context. A pending ship gate also lists `blockers`: a merge conflict, failing or running checks by name, a build nothing has run, a refinement that did not land |
|
|
178
|
+
| `anyforge_submit_approval` | approve | Approve or reject a HIL (resumes the crew). A ship gate held by the pull request's checks is refused with `ci_not_green`, naming them; optional `autoMerge` on a ship gate |
|
|
179
179
|
| `anyforge_list_programs` | read | List programs |
|
|
180
180
|
| `anyforge_get_program` | read | Get a program |
|
|
181
181
|
| `anyforge_get_program_brief_context` | read | Read a program's structured Brief, version history, legacy mirror, and ICE readiness |
|
|
182
182
|
| `anyforge_save_program_brief_version` | write | Save a complete structured Brief version; archives the prior active version and replaces the retired free-form writer |
|
|
183
|
+
| `anyforge_get_program_architecture` | read | Read a program's Architecture tab model (`currentVersion`, `body`, `versions`, mapped initiatives, coverage/consistency/readiness, `canEdit`, and `approval` state; `version` reads an earlier version) |
|
|
184
|
+
| `anyforge_save_program_architecture` | write | Propose (preview with `dryRun: true` or omitted `confirmed`) or save (`confirmed: true`, `ifVersion`) a new version of a program's Architecture tab model (`source: "mcp"`); program lead, program owner, or company Owner only |
|
|
183
185
|
| `anyforge_get_program_intake_definition` | read | Read a program's intake definition (the typed form its intake agent interviews against), the checklist that applies, and its version history; `version` reads one version in full |
|
|
184
186
|
| `anyforge_set_program_intake_definition` | write | Edit a program's intake definition; every change is a new version, and a change that strands answers open requests hold needs `acknowledgeImpact` (use `dryRun` to preview) |
|
|
185
187
|
| `anyforge_restore_program_intake_version` | write | Republish an earlier intake definition version as a new version |
|
|
@@ -190,7 +192,7 @@ complete capability and local/remote workspace boundary.
|
|
|
190
192
|
| `anyforge_set_program_status_line` | write | Write or clear a program's status line, shown on a report's program status board |
|
|
191
193
|
| `anyforge_set_program_request_intake` | write | Turn a program's incoming requests on (creates its Incoming Requests initiative) or off |
|
|
192
194
|
| `anyforge_get_program_access` | read | Who may read a program (`GET /programs/{id}/access`): visibility, reader people and teams, the access `revision`, `capacityVisibility`, `canManage` |
|
|
193
|
-
| `anyforge_set_program_access` | write | Replace a program's visibility and reader lists (`PUT /programs/{id}/access`) under `ifRevision` = the access revision; opening a private program is refused (`declassification_unconfirmed`) until a person confirms and you send `confirmDeclassify: true` |
|
|
195
|
+
| `anyforge_set_program_access` | write | Replace a program's visibility (`open`, `private` or `closed`) and reader lists (`PUT /programs/{id}/access`) under `ifRevision` = the access revision; opening a private or closed program is refused (`declassification_unconfirmed`) until a person confirms and you send `confirmDeclassify: true` |
|
|
194
196
|
| `anyforge_set_program_capacity_visibility` | write | Set how a program's time shows outside it (`PATCH /programs/{id}/access`, `restricted` or `unavailable`) |
|
|
195
197
|
| `anyforge_delete_program` | write | Delete a program; `deleteChildren: true` also deletes child initiatives + work items (else they're detached) |
|
|
196
198
|
| `anyforge_set_program_milestones` | write | Set a program's milestones/waves and the initiatives assigned to each (whole-array replace; an initiative sits in at most one wave) |
|
|
@@ -207,7 +209,7 @@ complete capability and local/remote workspace boundary.
|
|
|
207
209
|
| `anyforge_get_initiative_spec` | read | Read the active ICE spec, its readiness, what backlog approval will decide (`approvalGate`), and any submission awaiting human review |
|
|
208
210
|
| `anyforge_propose_initiative_spec` | write | Submit an ICE spec for human review; it becomes active only when a person publishes it, in the Console or with `anyforge_publish_initiative_spec`. The receipt carries `reviewUrl`, the absolute Console link to the review page, beside `reviewPath` |
|
|
209
211
|
| `anyforge_publish_initiative_spec` | approve | Publish a pending submission (`submissionId`) as the active spec, exactly as submitted, once the person has read it and asked for it. Only over the hosted MCP (OAuth): a Control API key is refused with `spec_publish_requires_person` |
|
|
210
|
-
| `anyforge_update_initiative` | write | Update a (non-system) initiative — only the fields you pass change, including its owning team (`teamId`); an argument the tool does not declare is refused and nothing is changed |
|
|
212
|
+
| `anyforge_update_initiative` | write | Update a (non-system) initiative — only the fields you pass change, including its owning team (`teamId`) and the initiatives it depends on (`dependsOnInitiativeIds`); an argument the tool does not declare is refused and nothing is changed. The result carries `planningWarning` when the edit puts the spec out of date |
|
|
211
213
|
| `anyforge_delete_initiative` | write | Delete a DRAFT initiative (archive via update once it's past DRAFT) |
|
|
212
214
|
| `anyforge_get_initiative_status` | read | Read an initiative's Status description — the one current line program reports show beside it |
|
|
213
215
|
| `anyforge_set_initiative_status` | write | Set or clear an initiative's Status description, the same write as Save status in the console (client-visible on shared reports; audited as the key owner) |
|
|
@@ -216,7 +218,9 @@ complete capability and local/remote workspace boundary.
|
|
|
216
218
|
| `anyforge_resolve_initiative_comment` | write | Resolve or reopen an initiative Discussion thread, as the console's Resolve and Reopen |
|
|
217
219
|
| `anyforge_list_opportunities` | read | List opportunities in the Discovery (product-planning) layer |
|
|
218
220
|
| `anyforge_create_opportunity` | write | Create an opportunity (bridges raw signals to themed roadmap work). Send `rice` (`reach`, `impact`, `confidence`, `operatorLoad`, `rationale`) in the same call; optional `evidence` is stored on the record |
|
|
219
|
-
| `anyforge_update_opportunity` | write | Edit an opportunity's RICE inputs, `evidence`, stage, theme assignment,
|
|
221
|
+
| `anyforge_update_opportunity` | write | Edit an opportunity's RICE inputs, `evidence`, stage, theme assignment, program link (`programId`; `null` unlinks) or the initiatives that deliver it (`initiativeIds`, for a program built without promoting) |
|
|
222
|
+
| `anyforge_list_opportunity_comments` | read | List the comments on an opportunity, oldest first, one page per call |
|
|
223
|
+
| `anyforge_post_opportunity_comment` | write | Post a comment on an opportunity as the key owner, for example to record an approval |
|
|
220
224
|
| `anyforge_delete_opportunity` | write | Hard-delete an opportunity (prefer archiving via `anyforge_update_opportunity`) |
|
|
221
225
|
| `anyforge_promote_opportunity` | write | Promote a prioritized opportunity into a Program + Initiative |
|
|
222
226
|
| `anyforge_list_signals` | read | List signals in the Discovery (product-planning) layer |
|
|
@@ -253,6 +257,10 @@ complete capability and local/remote workspace boundary.
|
|
|
253
257
|
| `anyforge_list_cycles` | read | List a team's delivery cycles on its own cadence (`team`, a slug; left out, the workspace cadence): number, dates, `state` (ended / active / future), `isCurrent`, `locked` and `lockReason` (`started` or `signed_off`), `openReason` (`not_signed_off` for a started cycle of a team that locks only at sign-off), committed counts (initiatives, work items, demand days) and capacity per cycle, plus `currentCycleNumber`. `past` (0–12, default 2) and `ahead` (0–6, default 3) set the range. Use it to pick a cycle for `anyforge_update_work_item` `set-cycle` |
|
|
254
258
|
| `anyforge_get_timesheet_week` | read | Your own timesheet week (`date`, any day in it; `today`, your local date), as the Timesheets grid shows it: `days`, bookable `rows` and `categories` with each day's `bookable` and refusal `reason`, `addable`, `blocked`, and `entries` (`initiativeId` or category key, `date`, `minutes`, `note`, `source` `manual`/`auto`). Always the key holder's own time |
|
|
255
259
|
| `anyforge_book_time` | write | Book, change or clear up to 100 cells of your own timesheet (`entries`: `initiativeId` or a category key such as `@meetings`, `date`, `minutes`, optional `note` and `mode` `set`/`add`; `today`), ALL OR NOTHING: a refused cell (`not_bookable` with its `reason`, `day_over_limit`, `initiative_not_found`, `duplicate_entry`) is named by `index` and nothing is written. Cells not sent are left as they are; an empty list returns `written: 0` |
|
|
260
|
+
| `anyforge_list_my_availability` | read | Your own away spans (PTO, holiday, sick, other), earliest first, calendar-booked days included: `id`, `kind`, `startDate`, `endDate` (inclusive), `note`. Optional `from`/`to` keep only spans overlapping that range. Needs Operator or higher, like Settings → Capacity → Availability |
|
|
261
|
+
| `anyforge_add_my_availability` | write | Mark yourself away (`kind` `pto`/`holiday`/`sick`/`other`, `startDate`, `endDate`, optional `note`), past or future. Refused with `availability_overlap` (naming `conflictingEntry`) when it shares a day with another of your away spans, a calendar day included; `end_before_start`, `span_too_long` (over 366 days), `invalid_kind`, `invalid_date`. Days it covers leave the "Log your time" reminder; booked time on them stays |
|
|
262
|
+
| `anyforge_update_my_availability` | write | Change one of your away spans (`entryId`, then only the fields that change; `note: null` clears it), checked like a new span. `availability_entry_not_found` for an unknown id, `not_own_availability_entry` for someone else's; nothing is written on a refusal |
|
|
263
|
+
| `anyforge_delete_my_availability` | write | Remove one of your away spans (`entryId`), with the same refusals as the update |
|
|
256
264
|
| `anyforge_get_work_item` | read | Get one work item by its returned id, with `assigneeName`, `blockerOwnerName` and `createdByName` beside the uids (null when nobody visible is named; list items carry them too), and `nextActions`: the status moves this key can make now, each with the exact arguments to send |
|
|
257
265
|
| `anyforge_create_work_item` | write | Create a work item with routing, migration, incident, intake, estimate, and evidence fields |
|
|
258
266
|
| `anyforge_update_work_item` | write | Edit, assign, begin, expedite, dispatch, confirm, drop (with optional `droppedReason`), archive, close, or reopen a work item. Each action takes only its own fields: one it does not read is refused (`unsupported_fields`) and nothing is changed. `status` with no action is the plain move to BACKLOG, REFINED or READY (how an item moves back) |
|
|
@@ -272,14 +280,20 @@ complete capability and local/remote workspace boundary.
|
|
|
272
280
|
| `anyforge_list_program_files` | read | A program's Files tab (`GET /programs/{id}/files`) |
|
|
273
281
|
| `anyforge_split_work_item` | write | Replace one unstarted work item with multiple children |
|
|
274
282
|
| `anyforge_merge_work_items` | write | Replace multiple unstarted work items with one merged item |
|
|
275
|
-
| `anyforge_list_crews` | read | Discover crews by status and active state, newest first. Returns 25
|
|
283
|
+
| `anyforge_list_crews` | read | Discover crews by status and active state, newest first, as summary rows (no chat or snapshots; a halt or error reason up to 200 characters). Returns a page of 25 unless you pass `limit` (up to 200), with `hasMore` and `nextCursor`: send `nextCursor` back as `cursor` with the same filters for the next page |
|
|
276
284
|
| `anyforge_get_crew` | read | Crew state + recent outputs + comments. Leads with status, halt reason, work item, PR and timestamps; `shape: "summary"` (default) excerpts long text and leaves out large snapshots, naming each; `messages: 0` is the status read; `shape: "full"` for every field |
|
|
277
285
|
| `anyforge_post_crew_comment` | write | Comment on / @-mention people on a crew (the crew does not read comments; use `anyforge_message_crew` to steer a running crew, `anyforge_amend_crew` for one at a gate) |
|
|
278
286
|
| `anyforge_message_crew` | approve | Message a running crew's Engineer ("skip X", "check Z first"). It reads the message before its next step and confirms in the crew chat; a crew not yet started or stopped inside the Engineer reads it on its first step or on resume. A crew working outside its Engineer (an amend on its way in, review) queues it for the next round (`delivery: next_round`). Refused with `crew_not_reading_messages` at a gate, when stopped outside the Engineer or when finished; the refusal's `nextStep` says what to do. Optional `idempotencyKey` makes a retry safe |
|
|
279
287
|
| `anyforge_resume_crew` | approve | Resume a PAUSED/HALTED crew where it stopped: the same action as the Console's Resume button, so a crew whose Engineer declared itself blocked runs the Engineer again with the messages queued for it. `anyforge_resume_crew_with_pr` is the one that sends an open pull request to review with no Engineer round. Optional `guidance` (up to 4000 characters) resumes with guidance: the Engineer's first resumed round runs with it and the queued messages, in the same call. On a crew halted at its ship gate, guidance is that gate's amend and is refused as amend refuses it. A crew the guidance cannot reach is refused with `not_resumable` and the guidance is not stored: one that is not PAUSED/HALTED, or one paused at a gate; use `anyforge_amend_crew` there. Requires `approve` scope. |
|
|
280
288
|
| `anyforge_halt_crew` | approve | Halt a crew |
|
|
281
|
-
| `
|
|
289
|
+
| `anyforge_pickup_work` | approve | Take a crew over to work on its branch locally. `ref` is a work item id, crew id, pull request URL or branch. The crew halts and nothing resumes it until it is handed back or a steward releases it. Answers the branch, recent run history and the git commands for a worktree. Refused with `crew_taken_over`, `crew_at_gate`, `crew_finished` or `crew_has_no_branch` |
|
|
290
|
+
| `anyforge_message_work` | approve | Message the crew a `ref` names without moving it, as `anyforge_message_crew` does |
|
|
291
|
+
| `anyforge_handback_work` | approve | Hand a taken-over crew back: pass the pushed commit as `headSha` and an optional `note`; the crew resumes from its branch (`branch_not_pushed` when GitHub has it elsewhere). `release: true` releases it and leaves it halted |
|
|
292
|
+
| `anyforge_amend_crew` | approve | Continue & finish — send a crew at its HIL gate back to the engineer with guidance. A crew halted at its ship gate is resumed with the notes; refused with `pr_merged` or `pr_closed` when its pull request merged or closed after the halt. A crew already running gets the amend queued (`queued: true`, `appliesAt`: `next_step`, or `ship_card` for a pending Resume on its next ship card). Optional `postToPullRequest` also posts the notes on the pull request; left out, the organization setting decides (off by default). `mergeBase: true` asks the engineer to merge the base this round and keeps base merges allowed on the crew (audited) |
|
|
282
293
|
| `anyforge_fix_crew_ci` | approve | Fix CI: send a crew whose pull request has failing checks back to the Engineer to fix them on the same PR. Works from PR review (HIL_SHIP) or a HALTED/PAUSED crew that has a PR; refused when GitHub does not report CI as failing. Requires `approve` scope and spends crew tokens. Only call when the operator asks. |
|
|
294
|
+
| `anyforge_accept_crew_ci_check` | approve | Accept ONE named failing check on a crew's pull request as known and out of scope, with a required reason (audited). The crew goes to review past it instead of halting, automatic CI fixing skips it, and Autopilot never ships the PR; the check stays red on GitHub. Covers that check on that PR at its current head and later heads descended from it. Refused when the check is not failing now. Only call when the operator asks |
|
|
295
|
+
| `anyforge_revoke_crew_ci_check` | approve | Revoke an accepted check, so it counts as failing again (audited) |
|
|
296
|
+
| `anyforge_set_crew_base_merge` | approve | Allow base merges on one crew (`allow`) past a "do not merge the base" in its task or earlier notes, or follow them again (`default`). From the crew's next round; merges nothing by itself (audited) |
|
|
283
297
|
| `anyforge_resume_crew_with_pr` | approve | Review & approve: take a HALTED or PAUSED crew's already-open pull request through the specialist reviews to the approve & merge gate, without re-running the Engineer. Omit prUrl to use the PR stored on the crew. A merged PR is refused. Requires `approve` scope. |
|
|
284
298
|
| `anyforge_decide_crew_permission` | approve | Approve or deny the permission a crew in PERMISSION_PENDING is waiting on (see pendingPermissionRequest on anyforge_get_crew). A tool permission applies for the rest of the run; an MCP write approval decides that one call. Pass approvalId to refuse a decision on a newer request. Requires `approve` scope. Only call when the operator decides. |
|
|
285
299
|
| `anyforge_create_program` | write | Create a program (cross-initiative grouping), optionally with a lead and as long-lived |
|
|
@@ -313,8 +327,19 @@ complete capability and local/remote workspace boundary.
|
|
|
313
327
|
| `anyforge_list_observability_signals` | read | List production-error triage signals (filter by `status`) |
|
|
314
328
|
| `anyforge_accept_observability_signal` | write | Accept a signal into a governed incident under the KTLO program |
|
|
315
329
|
| `anyforge_dismiss_observability_signal` | write | Dismiss a production-error signal as noise |
|
|
330
|
+
| `anyforge_get_status_page` | read | Read the customer status page: on or off, public URL, heading, its components (the ids a publication or maintenance window names) and `canManage` |
|
|
331
|
+
| `anyforge_get_status_page_publication` | read | Read an incident's status page publication (null when never published), its `revision`, `mayPublish` and why it can never be published (`blocked`) |
|
|
332
|
+
| `anyforge_publish_status_page_incident` | write | Publish an incident with a public title, impact, components, audience and a first update. Its commander, owning team, an Owner or an Admin only; text passes the disclosure check. A person's key only |
|
|
333
|
+
| `anyforge_update_status_page_publication` | write | Change a live publication's title, impact, components or audience (`ifRevision`) |
|
|
334
|
+
| `anyforge_post_status_page_update` | write | Post a public update; `resolved` resolves it on the page (`ifRevision`) |
|
|
335
|
+
| `anyforge_withdraw_status_page_publication` | write | Take an incident off every status page at once; the record is kept (`ifRevision`) |
|
|
336
|
+
| `anyforge_list_status_page_maintenance` | read | List maintenance windows with their phase now (`upcoming`, `in_progress`, `completed`, `cancelled`) and `revision` |
|
|
337
|
+
| `anyforge_schedule_status_page_maintenance` | write | Schedule a maintenance window on some components (at most 7 days, up to a year ahead). Owners and Admins only; text passes the disclosure check |
|
|
338
|
+
| `anyforge_update_status_page_maintenance` | write | Change a window that has not finished, or end one in progress now with `endNow` (`ifRevision`) |
|
|
339
|
+
| `anyforge_cancel_status_page_maintenance` | write | Cancel a window that has not finished; the record is kept (`ifRevision`) |
|
|
316
340
|
| `anyforge_list_audit_events` | audit:read | Read one page of the hash-chained audit trail, oldest first, with each entry's `sequence`, `hash` and `prevHash` (filter by `eventType`, `actor`, `from`, `to`; page with `cursor`). Needs a key minted with the explicit `audit:read` scope by an owner |
|
|
317
341
|
| `anyforge_whoami` | read | Who this connection acts as: the key owner's uid, name and current role, the credential's scopes and the workspace |
|
|
342
|
+
| `anyforge_list_my_tool_calls` | read | What your own API key or connected client called in the last 7 days: per tool, surface and day, with counts per outcome and first and last call time. Only your own credentials |
|
|
318
343
|
| `anyforge_list_members` | read | List the workspace's approved members with uid, name, email, role and whether they can be assigned work. Assignment takes the uid, not an email; `q` finds a person by name or email |
|
|
319
344
|
| `anyforge_invite_person` | people:invite | Invite one person, or refresh their pending invitation: `role` is operator, editor, viewer or filer (never owner), `email` on a verified company domain, optional `teamIds` and `notify`. Needs an owner's key with the `people:invite` scope |
|
|
320
345
|
| `anyforge_list_people_invitations` | people:invite | List the invitations a `people:invite` key could have written, pending and accepted |
|
|
@@ -334,6 +359,7 @@ complete capability and local/remote workspace boundary.
|
|
|
334
359
|
| `anyforge_move_page` | write | Move a page under another page, to the top level, or to a position among its siblings |
|
|
335
360
|
| `anyforge_archive_page` | write | Archive a page (kept with its history, hidden from the tree and search), or restore it |
|
|
336
361
|
| `anyforge_propose_page_edit` | write | Propose find/replace edits as suggestions an editor accepts or rejects in the page; nothing changes until they do (live pages only) |
|
|
362
|
+
| `anyforge_upload_library_documents` | write | Add one or several documents to the Context Library from `text`, base64 `data` or (stdio only) a local `path`; returns one `{ doc, created, indexedChunks }` or `{ error }` per file, in request order, up to 20 files per call; the key must belong to an owner or operator |
|
|
337
363
|
| `anyforge_list_reports` | read | List the Insights reports, most recently edited first: id, title, description, widget count, updatedAt and Console `url`; one page at a time (follow `meta.nextCursor`) |
|
|
338
364
|
| `anyforge_get_report` | read | Read one report: settings (`datesShown`, `trendDays`, `textSize`), whether a share link is live, and every widget definition with its query |
|
|
339
365
|
| `anyforge_create_report` | write | Create an empty report (`title`, optional `description` and `datesShown`), owned by you; needs a role that edits reports |
|