Forge Engine is an MCP server published by app.forgeengine, hosted at mmvdabzadclebfxyzudg.supabase.co. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 54 tools, including get_help, get_workflow, import_from_code, design_ui_from_systems, post_log.
Design spec + milestones AI coding agents read before building; drift flagged, changes reviewed.
135 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Forge how-to on demand (no project needed): propose→adopt, what a System is, Balance Lab formats, sign-in. Call when unsure.
No parameters.
{
"name": "get_help",
"description": "Forge how-to on demand (no project needed): propose→adopt, what a System is, Balance Lab formats, sign-in. Call when unsure.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Run FIRST in a new repo (no project): first-connect routine + the working-agreement block to ADD to AGENTS.md/CLAUDE.md now (tell the user in one line; remove if they object).
No parameters.
{
"name": "get_workflow",
"description": "Run FIRST in a new repo (no project): first-connect routine + the working-agreement block to ADD to AGENTS.md/CLAUDE.md now (tell the user in one line; remove if they object).",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}One-command codebase import: recipe + batch id — propose one Context overview + one System per real module; the owner adopts all at once.
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "import_from_code",
"description": "One-command codebase import: recipe + batch id — propose one Context overview + one System per real module; the owner adopts all at once.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Recipe to design the UI from Systems (user request only): steps + batch id — confirm canvas aspect, then screens + PLACED elements + edges in one batch.
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "design_ui_from_systems",
"description": "Recipe to design the UI from Systems (user request only): steps + batch id — confirm canvas aspect, then screens + PLACED elements + edges in one batch.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Append a build-log entry to Activity — what you built/decided (commit-note style).
| Parameter | Type | Description |
|---|---|---|
| text * | string | What you did / decided (1–2 sentences) |
| entity | string | System/screen/milestone it's about |
| version | string | e.g. "0.379.0" |
| project_id | string |
{
"name": "post_log",
"description": "Append a build-log entry to Activity — what you built/decided (commit-note style).",
"inputSchema": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"description": "What you did / decided (1–2 sentences)"
},
"entity": {
"type": "string",
"description": "System/screen/milestone it's about"
},
"version": {
"type": "string",
"description": "e.g. \"0.379.0\""
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}FULL design dump — LARGE, last resort; prefer get_project_meta + list_*/get_*/search.
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "get_project_context",
"description": "FULL design dump — LARGE, last resort; prefer get_project_meta + list_*/get_*/search.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Projects your key reaches (id, name, role); pass an id as project_id to switch.
No parameters.
{
"name": "list_projects",
"description": "Projects your key reaches (id, name, role); pass an id as project_id to switch.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}START HERE. Tiny overview: counts, members, task claims + working_now (avoid collisions), forge_workflow_version.
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "get_project_meta",
"description": "START HERE. Tiny overview: counts, members, task claims + working_now (avoid collisions), forge_workflow_version.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}SECONDARY (user-driven UI): turn a screen's REFERENCE IMAGE into placed elements. Returns the image itself plus the recipe — the canvas resolution, the fraction→pixel conversion that stops coordinates landing wrong, and what is already on the screen so a second pass updates instead of duplicating. You look at the picture and send back propose_element / update_element with x/y/w/h; it all lands in the owner's Inbox. Use when the user wants the wireframe to match a screenshot or mockup they uploaded.
| Parameter | Type | Description |
|---|---|---|
| screen * | string | The screen whose reference image to trace (name or id) |
| project_id | string |
{
"name": "trace_ui_from_image",
"description": "SECONDARY (user-driven UI): turn a screen's REFERENCE IMAGE into placed elements. Returns the image itself plus the recipe — the canvas resolution, the fraction→pixel conversion that stops coordinates landing wrong, and what is already on the screen so a second pass updates instead of duplicating. You look at the picture and send back propose_element / update_element with x/y/w/h; it all lands in the owner's Inbox. Use when the user wants the wireframe to match a screenshot or mockup they uploaded.",
"inputSchema": {
"type": "object",
"required": [
"screen"
],
"properties": {
"screen": {
"type": "string",
"description": "The screen whose reference image to trace (name or id)"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}What has drifted between the Idea lane and the System Specs — the design's own out-of-sync list, computed deterministically (no AI, no tokens). Three kinds: Idea notes edited since the systems were generated from them (with the systems each one touches), Idea notes whose prose the systems have moved past, and specs whose stamped source fingerprint no longer matches. Read this before assuming the design is coherent; fix the first kind with resync_from_idea.
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "get_stale",
"description": "What has drifted between the Idea lane and the System Specs — the design's own out-of-sync list, computed deterministically (no AI, no tokens). Three kinds: Idea notes edited since the systems were generated from them (with the systems each one touches), Idea notes whose prose the systems have moved past, and specs whose stamped source fingerprint no longer matches. Read this before assuming the design is coherent; fix the first kind with resync_from_idea.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}The recipe for re-syncing ONE changed Idea note into the specs that depend on it — the same scoped job the app's "Re-sync N systems" button does, minus the button. Returns the note, the affected specs in full, and exactly how to send the result back. You do the writing; it lands in the owner's Inbox to ADOPT. CRUCIAL: send updates with `resync:true`, or the owner adopts your fix and the design still reports it as stale.
| Parameter | Type | Description |
|---|---|---|
| note * | string | The Idea note's title or id (from get_stale) |
| project_id | string |
{
"name": "resync_from_idea",
"description": "The recipe for re-syncing ONE changed Idea note into the specs that depend on it — the same scoped job the app's \"Re-sync N systems\" button does, minus the button. Returns the note, the affected specs in full, and exactly how to send the result back. You do the writing; it lands in the owner's Inbox to ADOPT. CRUCIAL: send updates with `resync:true`, or the owner adopts your fix and the design still reports it as stale.",
"inputSchema": {
"type": "object",
"required": [
"note"
],
"properties": {
"note": {
"type": "string",
"description": "The Idea note's title or id (from get_stale)"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}The WHOLE design as one readable document — Vision (+ Project DNA) → every System spec → reference notes, compiled deterministically from the current design. Read this to understand a project end-to-end instead of walking list_systems → get_system N times. Returns markdown plus the project `version` it was compiled from. Long designs come back PAGED — the header says 'part N of M', call again with `page: N+1` for the rest. Pass `for_summary: true` to get the condensed projection instead (every system's Goal + Boundary, tables stripped, one page) — that is what you should summarize from.
| Parameter | Type | Description |
|---|---|---|
| page | number | Which part of the full document to return (default 1). The header tells you how many parts there are. |
| project_id | string | |
| for_summary | boolean | Return the condensed summarization source (all system goals + boundaries, no tables) instead of the full document |
{
"name": "get_design_document",
"description": "The WHOLE design as one readable document — Vision (+ Project DNA) → every System spec → reference notes, compiled deterministically from the current design. Read this to understand a project end-to-end instead of walking list_systems → get_system N times. Returns markdown plus the project `version` it was compiled from. Long designs come back PAGED — the header says 'part N of M', call again with `page: N+1` for the rest. Pass `for_summary: true` to get the condensed projection instead (every system's Goal + Boundary, tables stripped, one page) — that is what you should summarize from.",
"inputSchema": {
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Which part of the full document to return (default 1). The header tells you how many parts there are."
},
"project_id": {
"type": "string"
},
"for_summary": {
"type": "boolean",
"description": "Return the condensed summarization source (all system goals + boundaries, no tables) instead of the full document"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Write the Design Document's Overview — the human-readable page a new team member reads first. WRITES DIRECTLY (no Inbox): it is a derived, clearly-labelled AI summary, not design truth, and the owner can clear or rewrite it in one click. HARD RULES, same as the in-app button: use ONLY facts stated in the design (call get_design_document with for_summary:true first); invent no mechanics, numbers or names; describe, never evaluate; write in the design's dominant language. Structure: `### What this is` · `### The core loop` · `### How the systems fit` (which system feeds which — the part a raw spec list cannot give) · `### Edges` (ONLY if the design states scope limits / open questions). 250-400 words, no top-level heading. Forge stamps the project version it was compiled from, so the owner is told when the design has moved past it.
| Parameter | Type | Description |
|---|---|---|
| summary * | string | The Overview in markdown, starting at `### What this is` |
| project_id | string |
{
"name": "set_design_overview",
"description": "Write the Design Document's Overview — the human-readable page a new team member reads first. WRITES DIRECTLY (no Inbox): it is a derived, clearly-labelled AI summary, not design truth, and the owner can clear or rewrite it in one click. HARD RULES, same as the in-app button: use ONLY facts stated in the design (call get_design_document with for_summary:true first); invent no mechanics, numbers or names; describe, never evaluate; write in the design's dominant language. Structure: `### What this is` · `### The core loop` · `### How the systems fit` (which system feeds which — the part a raw spec list cannot give) · `### Edges` (ONLY if the design states scope limits / open questions). 250-400 words, no top-level heading. Forge stamps the project version it was compiled from, so the owner is told when the design has moved past it.",
"inputSchema": {
"type": "object",
"required": [
"summary"
],
"properties": {
"summary": {
"type": "string",
"description": "The Overview in markdown, starting at `### What this is`"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}ONE-CALL orientation before you build: pass `files` you're about to edit (or a `task`) → the systems that own them, each with Goal + Acceptance + build status/files/last_commit/drift + coupled_systems (code neighbors an edit may break) + pending Inbox changes + recent decisions, plus open-rejection count, who's active, `recent_changes` (what happened since you were last here — a session handoff), and a task to claim. Replaces the get_project_meta→get_system→get_build_region dance.
| Parameter | Type | Description |
|---|---|---|
| task | string | A task id or name — briefs its milestone's systems instead |
| files | array | Repo-relative paths you're about to touch — mapped to their systems |
| project_id | string |
{
"name": "get_briefing",
"description": "ONE-CALL orientation before you build: pass `files` you're about to edit (or a `task`) → the systems that own them, each with Goal + Acceptance + build status/files/last_commit/drift + coupled_systems (code neighbors an edit may break) + pending Inbox changes + recent decisions, plus open-rejection count, who's active, `recent_changes` (what happened since you were last here — a session handoff), and a task to claim. Replaces the get_project_meta→get_system→get_build_region dance.",
"inputSchema": {
"type": "object",
"properties": {
"task": {
"type": "string",
"description": "A task id or name — briefs its milestone's systems instead"
},
"files": {
"type": "array",
"items": {
"type": "string"
},
"description": "Repo-relative paths you're about to touch — mapped to their systems"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}ONE system's full spec (Goal/Boundary/Acceptance, markdown, sources, status) + pending Inbox changes touching it.
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| name | string | If no id |
| project_id | string |
{
"name": "get_system",
"description": "ONE system's full spec (Goal/Boundary/Acceptance, markdown, sources, status) + pending Inbox changes touching it.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"name": {
"type": "string",
"description": "If no id"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}All systems, compact: id, name, status, 1-line goal.
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "list_systems",
"description": "All systems, compact: id, name, status, 1-line goal.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}System→code map per built system: implementing files, status, drift flag, last_commit, and acceptance-evidence COUNTS. Mapped files gone from the repo? report_drift. Pass `system:"<name|id>"` for ONE system plus the full text of its acceptance criteria (omitted from the map — it is the bulk of the payload). Big projects come back paged: the body says 'page N of M', call again with `page: N+1`.
| Parameter | Type | Description |
|---|---|---|
| page | number | Which page of the map (default 1); the body tells you how many there are |
| system | string | One system by name or id — returns its acceptance-criteria detail too |
| project_id | string |
{
"name": "get_build_region",
"description": "System→code map per built system: implementing files, status, drift flag, last_commit, and acceptance-evidence COUNTS. Mapped files gone from the repo? report_drift. Pass `system:\"<name|id>\"` for ONE system plus the full text of its acceptance criteria (omitted from the map — it is the bulk of the payload). Big projects come back paged: the body says 'page N of M', call again with `page: N+1`.",
"inputSchema": {
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Which page of the map (default 1); the body tells you how many there are"
},
"system": {
"type": "string",
"description": "One system by name or id — returns its acceptance-criteria detail too"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Flag CODE DRIFT — mapped files no longer match the repo. Advisory; a fresh report_build_status clears it.
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| name | string | If no id |
| note | string | Optional — what drifted |
| project_id | string | |
| missing_files | array | Paths that no longer exist |
{
"name": "report_drift",
"description": "Flag CODE DRIFT — mapped files no longer match the repo. Advisory; a fresh report_build_status clears it.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"name": {
"type": "string",
"description": "If no id"
},
"note": {
"type": "string",
"description": "Optional — what drifted"
},
"project_id": {
"type": "string"
},
"missing_files": {
"type": "array",
"items": {
"type": "string"
},
"description": "Paths that no longer exist"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}DESIGN MEMORY: recorded decisions/logs/rejections with who/when. Read BEFORE changing a system's direction; empty = no recorded WHY — don't invent one.
| Parameter | Type | Description |
|---|---|---|
| limit | number | Default 30, max 100 |
| query | string | Keyword filter |
| system | string | System id or exact name |
| project_id | string |
{
"name": "get_history",
"description": "DESIGN MEMORY: recorded decisions/logs/rejections with who/when. Read BEFORE changing a system's direction; empty = no recorded WHY — don't invent one.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Default 30, max 100"
},
"query": {
"type": "string",
"description": "Keyword filter"
},
"system": {
"type": "string",
"description": "System id or exact name"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}BLAST RADIUS of a system (deterministic): upstream context, siblings, dependent screens/milestones, files, code-coupled systems, pending Inbox, recent activity. Run BEFORE changing it.
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| name | string | If no id |
| project_id | string |
{
"name": "get_impact",
"description": "BLAST RADIUS of a system (deterministic): upstream context, siblings, dependent screens/milestones, files, code-coupled systems, pending Inbox, recent activity. Run BEFORE changing it.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"name": {
"type": "string",
"description": "If no id"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Owner's DECLINED list — check at session start; follow each entry's guidance, then resolve_rejection(title).
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "get_rejections",
"description": "Owner's DECLINED list — check at session start; follow each entry's guidance, then resolve_rejection(title).",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Report you REVERTED a declined change (unlocks the owner's Clear). Call after realigning the build.
| Parameter | Type | Description |
|---|---|---|
| title * | string | Exactly as get_rejections returned it |
| project_id | string |
{
"name": "resolve_rejection",
"description": "Report you REVERTED a declined change (unlocks the owner's Clear). Call after realigning the build.",
"inputSchema": {
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"description": "Exactly as get_rejections returned it"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}All screens, compact: id, name, purpose, status.
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "list_screens",
"description": "All screens, compact: id, name, purpose, status.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}ONE screen's layout: canvas `resolution` (use THESE px), elements x/y/w/h, links, popups. Read before editing a screen. has_reference_image:true → get_screen_image shows you the actual image.
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| name | string | If no id |
| project_id | string |
{
"name": "get_screen",
"description": "ONE screen's layout: canvas `resolution` (use THESE px), elements x/y/w/h, links, popups. Read before editing a screen. has_reference_image:true → get_screen_image shows you the actual image.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"name": {
"type": "string",
"description": "If no id"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}A screen's reference image (HUD background) as an actual IMAGE you can see — reads the stored file inline (signed-URL fallback past 4MB).
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| name | string | If no id |
| project_id | string |
{
"name": "get_screen_image",
"description": "A screen's reference image (HUD background) as an actual IMAGE you can see — reads the stored file inline (signed-URL fallback past 4MB).",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"name": {
"type": "string",
"description": "If no id"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Move/resize/relabel an element — DIRECT, live. element_id (preferred) or screen+label; x+y also places an unplaced one.
| Parameter | Type | Description |
|---|---|---|
| h | number | |
| w | number | |
| x | number | px on the screen's canvas |
| y | number | |
| note | string | "" clears |
| type | string | e.g. button/bar/panel (optional) |
| label | string | Current label |
| screen | string | With label, if no element_id |
| system | string | System it serves |
| new_label | string | Rename (optional) |
| element_id | string | From get_screen (preferred) |
| project_id | string |
Remove YOUR OWN still-pending Inbox item (id from the propose response / get_inbox).
| Parameter | Type | Description |
|---|---|---|
| id * | string | The pending item's id |
| project_id | string |
{
"name": "withdraw_proposal",
"description": "Remove YOUR OWN still-pending Inbox item (id from the propose response / get_inbox).",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The pending item's id"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}PROPOSE a delete → Inbox (owner adopts; nothing deleted now). id preferred or exact name; flow_edge may use from+to.
| Parameter | Type | Description |
|---|---|---|
| id | string | Entity/task/element/edge id |
| to | string | flow_edge: destination screen |
| from | string | flow_edge: source screen |
| kind * | string | What to delete |
| name | string | Exact name/title (if no id) |
| project_id | string |
{
"name": "delete_entity",
"description": "PROPOSE a delete → Inbox (owner adopts; nothing deleted now). id preferred or exact name; flow_edge may use from+to.",
"inputSchema": {
"type": "object",
"required": [
"kind"
],
"properties": {
"id": {
"type": "string",
"description": "Entity/task/element/edge id"
},
"to": {
"type": "string",
"description": "flow_edge: destination screen"
},
"from": {
"type": "string",
"description": "flow_edge: source screen"
},
"kind": {
"enum": [
"system",
"context",
"screen",
"milestone",
"task",
"element",
"flow_edge"
],
"type": "string",
"description": "What to delete"
},
"name": {
"type": "string",
"description": "Exact name/title (if no id)"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-destructive",
"destructiveHint": true
}
}Remove duplicate-named entries (keep first) — DIRECT, destructive.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | What to dedupe |
| screen | string | For kind=elements |
| project_id | string |
{
"name": "dedupe",
"description": "Remove duplicate-named entries (keep first) — DIRECT, destructive.",
"inputSchema": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"milestones",
"elements"
],
"type": "string",
"description": "What to dedupe"
},
"screen": {
"type": "string",
"description": "For kind=elements"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-destructive",
"destructiveHint": true
}
}Reorder milestones / tasks / elements — DIRECT. order = ids in new order; omitted keep relative order.
| Parameter | Type | Description |
|---|---|---|
| kind * | string | What to reorder |
| order * | array | Ids in the new order |
| screen | string | For kind=elements |
| milestone | string | For kind=tasks (name) |
| project_id | string | |
| milestone_id | string | For kind=tasks |
{
"name": "reorder",
"description": "Reorder milestones / tasks / elements — DIRECT. order = ids in new order; omitted keep relative order.",
"inputSchema": {
"type": "object",
"required": [
"kind",
"order"
],
"properties": {
"kind": {
"enum": [
"milestones",
"tasks",
"elements"
],
"type": "string",
"description": "What to reorder"
},
"order": {
"type": "array",
"items": {
"type": "string"
},
"description": "Ids in the new order"
},
"screen": {
"type": "string",
"description": "For kind=elements"
},
"milestone": {
"type": "string",
"description": "For kind=tasks (name)"
},
"project_id": {
"type": "string"
},
"milestone_id": {
"type": "string",
"description": "For kind=tasks"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}All milestones, compact: id, name, weeks, order, done/total.
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "list_milestones",
"description": "All milestones, compact: id, name, weeks, order, done/total.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}ONE milestone: goal, weeks, difficulty, systems, every task (id/name/done/status/effort).
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| name | string | If no id |
| project_id | string |
{
"name": "get_milestone",
"description": "ONE milestone: goal, weeks, difficulty, systems, every task (id/name/done/status/effort).",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"name": {
"type": "string",
"description": "If no id"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Change history {who, change, entity, kind, when}, newest first; filter kind/who/query.
| Parameter | Type | Description |
|---|---|---|
| who | string | Author email substring (optional) |
| kind | string | system | context | milestone | screen (optional) |
| limit | number | Default 30, max 200 |
| query | string | Keyword filter (optional) |
| project_id | string |
{
"name": "list_activity",
"description": "Change history {who, change, entity, kind, when}, newest first; filter kind/who/query.",
"inputSchema": {
"type": "object",
"properties": {
"who": {
"type": "string",
"description": "Author email substring (optional)"
},
"kind": {
"type": "string",
"description": "system | context | milestone | screen (optional)"
},
"limit": {
"type": "number",
"description": "Default 30, max 200"
},
"query": {
"type": "string",
"description": "Keyword filter (optional)"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}PENDING Inbox (the owner's triage queue). Check BEFORE proposing — avoid duplicates. Read-only.
| Parameter | Type | Description |
|---|---|---|
| project_id | string |
{
"name": "get_inbox",
"description": "PENDING Inbox (the owner's triage queue). Check BEFORE proposing — avoid duplicates. Read-only.",
"inputSchema": {
"type": "object",
"properties": {
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Keyword search — compact hits {kind, id, name} + snippet.
| Parameter | Type | Description |
|---|---|---|
| kinds | array | Optional: system | context | milestone | task | screen | proposal |
| query * | string | Text to search for |
| project_id | string |
{
"name": "search",
"description": "Keyword search — compact hits {kind, id, name} + snippet.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"kinds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: system | context | milestone | task | screen | proposal"
},
"query": {
"type": "string",
"description": "Text to search for"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Propose a NEW system → Inbox. spec = ## Goal / ## Boundary (Owns · Doesn't own) / ## Acceptance. Exists? use update_system. (Alias: create_proposal.)
| Parameter | Type | Description |
|---|---|---|
| spec * | string | Markdown: ## Goal / ## Boundary / ## Acceptance |
| batch | string | import_from_code batch id |
| files | array | Implementing paths, ONE file per entry |
| title * | string | System name (Title Case, English) |
| project_id | string | |
| derives_from | array | Context note title(s) this system derives from → wires provenance (upstream + siblings) |
| acknowledge_rejection | boolean | Only after a DECLINED bounce AND asking the user |
{
"name": "propose_system",
"description": "Propose a NEW system → Inbox. spec = ## Goal / ## Boundary (Owns · Doesn't own) / ## Acceptance. Exists? use update_system. (Alias: create_proposal.)",
"inputSchema": {
"type": "object",
"required": [
"title",
"spec"
],
"properties": {
"spec": {
"type": "string",
"description": "Markdown: ## Goal / ## Boundary / ## Acceptance"
},
"batch": {
"type": "string",
"description": "import_from_code batch id"
},
"files": {
"type": "array",
"items": {
"type": "string"
},
"description": "Implementing paths, ONE file per entry"
},
"title": {
"type": "string",
"description": "System name (Title Case, English)"
},
"project_id": {
"type": "string"
},
"derives_from": {
"type": "array",
"items": {
"type": "string"
},
"description": "Context note title(s) this system derives from → wires provenance (upstream + siblings)"
},
"acknowledge_rejection": {
"type": "boolean",
"description": "Only after a DECLINED bounce AND asking the user"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Propose a new/updated Idea note → Inbox. Title-match to update; send the COMPLETE revised text. Set resync:true ONLY when you rewrote the note FROM the current systems (get_stale lists notes the systems have moved past) — it stops the adopted note from immediately nagging to re-generate the systems it was just written from.
| Parameter | Type | Description |
|---|---|---|
| batch | string | import_from_code batch id |
| title * | string | Match existing to update, or new to add |
| resync | boolean | This note was re-derived from the current systems — re-stamps both staleness signals on adopt |
| content * | string | Complete text, not a delta |
| project_id | string | |
| acknowledge_rejection | boolean | Only after a DECLINED bounce AND asking the user |
{
"name": "propose_context",
"description": "Propose a new/updated Idea note → Inbox. Title-match to update; send the COMPLETE revised text. Set resync:true ONLY when you rewrote the note FROM the current systems (get_stale lists notes the systems have moved past) — it stops the adopted note from immediately nagging to re-generate the systems it was just written from.",
"inputSchema": {
"type": "object",
"required": [
"title",
"content"
],
"properties": {
"batch": {
"type": "string",
"description": "import_from_code batch id"
},
"title": {
"type": "string",
"description": "Match existing to update, or new to add"
},
"resync": {
"type": "boolean",
"description": "This note was re-derived from the current systems — re-stamps both staleness signals on adopt"
},
"content": {
"type": "string",
"description": "Complete text, not a delta"
},
"project_id": {
"type": "string"
},
"acknowledge_rejection": {
"type": "boolean",
"description": "Only after a DECLINED bounce AND asking the user"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Propose Project DNA and/or Tech Notes → Inbox (at least one).
| Parameter | Type | Description |
|---|---|---|
| dna | string | Omit to leave unchanged |
| batch | string | import_from_code batch id |
| project_id | string | |
| tech_notes | string | Omit to leave unchanged |
{
"name": "propose_dna",
"description": "Propose Project DNA and/or Tech Notes → Inbox (at least one).",
"inputSchema": {
"type": "object",
"properties": {
"dna": {
"type": "string",
"description": "Omit to leave unchanged"
},
"batch": {
"type": "string",
"description": "import_from_code batch id"
},
"project_id": {
"type": "string"
},
"tech_notes": {
"type": "string",
"description": "Omit to leave unchanged"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Propose a system UPDATE → Inbox diff. get_system first; send the FULL revised spec. new_title renames; context_title+context bundles the Idea update. Set resync:true ONLY when you rewrote this spec FROM its upstream Idea (see resync_from_idea) — it re-stamps the staleness signal on adopt.
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| name | string | If no id |
| spec * | string | Full revised spec markdown |
| resync | boolean | This spec was re-derived from its upstream Idea — re-stamps sourceSig on adopt. Never set it on an ordinary edit. |
| context | string | Full revised Idea text |
| new_title | string | Rename in the same card |
| project_id | string | |
| context_title | string | Idea section to also update |
| acknowledge_rejection | boolean | Only after a DECLINED bounce AND asking the user |
{
"name": "update_system",
"description": "Propose a system UPDATE → Inbox diff. get_system first; send the FULL revised spec. new_title renames; context_title+context bundles the Idea update. Set resync:true ONLY when you rewrote this spec FROM its upstream Idea (see resync_from_idea) — it re-stamps the staleness signal on adopt.",
"inputSchema": {
"type": "object",
"required": [
"spec"
],
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"name": {
"type": "string",
"description": "If no id"
},
"spec": {
"type": "string",
"description": "Full revised spec markdown"
},
"resync": {
"type": "boolean",
"description": "This spec was re-derived from its upstream Idea — re-stamps sourceSig on adopt. Never set it on an ordinary edit."
},
"context": {
"type": "string",
"description": "Full revised Idea text"
},
"new_title": {
"type": "string",
"description": "Rename in the same card"
},
"project_id": {
"type": "string"
},
"context_title": {
"type": "string",
"description": "Idea section to also update"
},
"acknowledge_rejection": {
"type": "boolean",
"description": "Only after a DECLINED bounce AND asking the user"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Read Balance Lab: stat tables, boards with EVALUATED values, scenarios.
| Parameter | Type | Description |
|---|---|---|
| board | string | One board (omit = all) |
| project_id | string | |
| include_rows | boolean | false = schema only |
{
"name": "get_balance",
"description": "Read Balance Lab: stat tables, boards with EVALUATED values, scenarios.",
"inputSchema": {
"type": "object",
"properties": {
"board": {
"type": "string",
"description": "One board (omit = all)"
},
"project_id": {
"type": "string"
},
"include_rows": {
"type": "boolean",
"description": "false = schema only"
}
}
},
"annotations": {
"forgeTier": "read",
"readOnlyHint": true
}
}Propose a stat-doc TABLE → Inbox. csv (header; `key%` = percent; first column = name) OR schema+rows. Adopting REPLACES same-named.
| Parameter | Type | Description |
|---|---|---|
| csv | string | Header + rows; non-numeric = info |
| rows | array | [{name, atk: 350, …}] |
| title * | string | Table name |
| schema | array | [{key, mode: flat|pct|text, base, min, max, desc}] |
| registry | boolean | true = the shared Stats registry |
| project_id | string |
{
"name": "propose_balance_table",
"description": "Propose a stat-doc TABLE → Inbox. csv (header; `key%` = percent; first column = name) OR schema+rows. Adopting REPLACES same-named.",
"inputSchema": {
"type": "object",
"required": [
"title"
],
"properties": {
"csv": {
"type": "string",
"description": "Header + rows; non-numeric = info"
},
"rows": {
"type": "array",
"items": {
"type": "object"
},
"description": "[{name, atk: 350, …}]"
},
"title": {
"type": "string",
"description": "Table name"
},
"schema": {
"type": "array",
"items": {
"type": "object"
},
"description": "[{key, mode: flat|pct|text, base, min, max, desc}]"
},
"registry": {
"type": "boolean",
"description": "true = the shared Stats registry"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Propose a node board → Inbox. Kinds const|formula|item|sheet|loadout|picker|pool|process|note|frame; formulas reference blocks by NAME; omit x/y = auto-layout. Adopting REPLACES same-named.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Board name |
| nodes * | array | e.g. {kind:"formula",name:"dmg",formula:"atk - mdef"} |
| project_id | string |
{
"name": "propose_balance_board",
"description": "Propose a node board → Inbox. Kinds const|formula|item|sheet|loadout|picker|pool|process|note|frame; formulas reference blocks by NAME; omit x/y = auto-layout. Adopting REPLACES same-named.",
"inputSchema": {
"type": "object",
"required": [
"name",
"nodes"
],
"properties": {
"name": {
"type": "string",
"description": "Board name"
},
"nodes": {
"type": "array",
"items": {
"type": "object"
},
"description": "e.g. {kind:\"formula\",name:\"dmg\",formula:\"atk - mdef\"}"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Propose a NEW milestone (+ optional tasks) → Inbox.
| Parameter | Type | Description |
|---|---|---|
| goal | string | One-line goal (optional) |
| name * | string | Milestone name |
| tasks | array | Task names (optional) |
| project_id | string | |
| acknowledge_rejection | boolean | Only after a DECLINED bounce AND asking the user |
{
"name": "propose_milestone",
"description": "Propose a NEW milestone (+ optional tasks) → Inbox.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"goal": {
"type": "string",
"description": "One-line goal (optional)"
},
"name": {
"type": "string",
"description": "Milestone name"
},
"tasks": {
"type": "array",
"items": {
"type": "string"
},
"description": "Task names (optional)"
},
"project_id": {
"type": "string"
},
"acknowledge_rejection": {
"type": "boolean",
"description": "Only after a DECLINED bounce AND asking the user"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Mark existing-milestone tasks done → Inbox progress card (owner adopts the ticks).
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| milestone | string | Milestone name (if no id) |
| done_tasks * | array | Task names that are done |
| project_id | string |
{
"name": "report_milestone_progress",
"description": "Mark existing-milestone tasks done → Inbox progress card (owner adopts the ticks).",
"inputSchema": {
"type": "object",
"required": [
"done_tasks"
],
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"milestone": {
"type": "string",
"description": "Milestone name (if no id)"
},
"done_tasks": {
"type": "array",
"items": {
"type": "string"
},
"description": "Task names that are done"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Report a SYSTEM's status (todo|in-progress|implemented) — DIRECT, live. ALWAYS pass files (full list — it REPLACES); non-todo with no files shows done-but-EMPTY. 'implemented' counts as VERIFIED only when every UNIT-TESTABLE ## Acceptance bullet is backed via evidence[{criterion,proof}]; a bullet tagged [manual]/[e2e]/[ui]/[wip] is EXEMPT (verified by manual/e2e). Otherwise it's a CLAIM (verified:false) and the response names the unbacked criteria. TWO tiers: VERIFIED = a test is NAMED; GREEN (guarantee) = you RAN the test and reported `passed:true` on the evidence — green goes stale after 21 days, so re-run to keep it.
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| name | string | If no id |
| files | array | ONE file per entry (optional ' — function'); prose → decisions |
| status * | string | todo | in-progress | implemented |
| version | string | e.g. "0.379.0" |
| evidence | array | Map ## Acceptance bullets to a test/file: [{criterion, proof, passed?, at?}]. Re-send full set (replaces). proof-only = backed (claimed); passed:true = test-green (guarantee). |
| decisions | array | Decisions/divergences (prose) |
| project_id | string |
SECONDARY (user-driven UI): propose a link between two existing screens → Inbox.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Destination screen name |
| from * | string | Source screen name |
| label | string | Transition label (optional) |
| project_id | string |
{
"name": "propose_flow_edge",
"description": "SECONDARY (user-driven UI): propose a link between two existing screens → Inbox.",
"inputSchema": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "Destination screen name"
},
"from": {
"type": "string",
"description": "Source screen name"
},
"label": {
"type": "string",
"description": "Transition label (optional)"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}SECONDARY (user-driven UI): propose an element onto a screen → Inbox. ALWAYS pass x/y/w/h (px on the screen's `resolution` from get_screen); no coords = unplaced pile.
| Parameter | Type | Description |
|---|---|---|
| h | number | Default 40 |
| w | number | Default 120 |
| x | number | Left px |
| y | number | Top px |
| note | string | |
| type | string | button/bar/panel/text (default box) |
| label * | string | Element label, e.g. 'HP bar' |
| screen * | string | Existing screen name |
| system | string | System it serves |
| project_id | string |
{
"name": "propose_element",
"description": "SECONDARY (user-driven UI): propose an element onto a screen → Inbox. ALWAYS pass x/y/w/h (px on the screen's `resolution` from get_screen); no coords = unplaced pile.",
"inputSchema": {
"type": "object",
"required": [
"screen",
"label"
],
"properties": {
"h": {
"type": "number",
"description": "Default 40"
},
"w": {
"type": "number",
"description": "Default 120"
},
"x": {
"type": "number",
"description": "Left px"
},
"y": {
"type": "number",
"description": "Top px"
},
"note": {
"type": "string"
},
"type": {
"type": "string",
"description": "button/bar/panel/text (default box)"
},
"label": {
"type": "string",
"description": "Element label, e.g. 'HP bar'"
},
"screen": {
"type": "string",
"description": "Existing screen name"
},
"system": {
"type": "string",
"description": "System it serves"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}SECONDARY (user-driven UI): propose a NEW screen → Inbox. parent = popup over that screen; purpose grounds AI suggestions. Whole UI? design_ui_from_systems first.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Screen name (Title Case, English) |
| parent | string | Make it a POPUP over this screen |
| purpose | string | What this screen is for |
| project_id | string |
{
"name": "propose_screen",
"description": "SECONDARY (user-driven UI): propose a NEW screen → Inbox. parent = popup over that screen; purpose grounds AI suggestions. Whole UI? design_ui_from_systems first.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Screen name (Title Case, English)"
},
"parent": {
"type": "string",
"description": "Make it a POPUP over this screen"
},
"purpose": {
"type": "string",
"description": "What this screen is for"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Report a SCREEN's status (todo|in-progress|implemented) → Inbox.
| Parameter | Type | Description |
|---|---|---|
| screen * | string | Screen name |
| status * | string | todo | in-progress | implemented |
| project_id | string |
{
"name": "report_screen_status",
"description": "Report a SCREEN's status (todo|in-progress|implemented) → Inbox.",
"inputSchema": {
"type": "object",
"required": [
"screen",
"status"
],
"properties": {
"screen": {
"type": "string",
"description": "Screen name"
},
"status": {
"type": "string",
"description": "todo | in-progress | implemented"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "propose-inbox",
"destructiveHint": false
}
}Rename a screen IN PLACE — DIRECT; links/elements follow (id-referenced).
| Parameter | Type | Description |
|---|---|---|
| name * | string | Exact CURRENT name |
| new_name * | string | New name (must not collide) |
| project_id | string |
{
"name": "rename_screen",
"description": "Rename a screen IN PLACE — DIRECT; links/elements follow (id-referenced).",
"inputSchema": {
"type": "object",
"required": [
"name",
"new_name"
],
"properties": {
"name": {
"type": "string",
"description": "Exact CURRENT name"
},
"new_name": {
"type": "string",
"description": "New name (must not collide)"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}Edit milestone goal/weeks/difficulty/name — DIRECT. new_name renames (never delete+recreate).
| Parameter | Type | Description |
|---|---|---|
| id | string | Preferred |
| goal | string | |
| name | string | Current name (if no id) |
| weeks | number | |
| new_name | string | Rename |
| difficulty | string | "" clears |
| project_id | string |
{
"name": "update_milestone",
"description": "Edit milestone goal/weeks/difficulty/name — DIRECT. new_name renames (never delete+recreate).",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"goal": {
"type": "string"
},
"name": {
"type": "string",
"description": "Current name (if no id)"
},
"weeks": {
"type": "number"
},
"new_name": {
"type": "string",
"description": "Rename"
},
"difficulty": {
"enum": [
"easy",
"medium",
"hard",
""
],
"type": "string",
"description": "\"\" clears"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}Add a task to a milestone — DIRECT. assignee:"me" claims on creation.
| Parameter | Type | Description |
|---|---|---|
| done | boolean | |
| name * | string | Task name |
| human | boolean | Human-only (GTM/validation/people work) — next_task & get_briefing skip it |
| effort | string | one of ["S","M","L"] |
| status | string | one of ["in-progress","blocked"] |
| assignee | string | "me" claims it |
| milestone | string | If no id |
| project_id | string | |
| milestone_id | string | Preferred |
{
"name": "add_task",
"description": "Add a task to a milestone — DIRECT. assignee:\"me\" claims on creation.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"done": {
"type": "boolean"
},
"name": {
"type": "string",
"description": "Task name"
},
"human": {
"type": "boolean",
"description": "Human-only (GTM/validation/people work) — next_task & get_briefing skip it"
},
"effort": {
"enum": [
"S",
"M",
"L"
],
"type": "string"
},
"status": {
"enum": [
"in-progress",
"blocked"
],
"type": "string"
},
"assignee": {
"type": "string",
"description": "\"me\" claims it"
},
"milestone": {
"type": "string",
"description": "If no id"
},
"project_id": {
"type": "string"
},
"milestone_id": {
"type": "string",
"description": "Preferred"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}DISPATCHER (multi-agent): atomically pick + claim the next task to build — walks milestones in order, skips human-only tasks and any task whose systems share code files with a task another agent already holds or is actively touching, so parallel agents spread out instead of colliding. Returns the claimed task + systems, or why none is free. dry_run:true peeks without claiming.
| Parameter | Type | Description |
|---|---|---|
| dry_run | boolean | Peek without claiming |
| project_id | string |
{
"name": "next_task",
"description": "DISPATCHER (multi-agent): atomically pick + claim the next task to build — walks milestones in order, skips human-only tasks and any task whose systems share code files with a task another agent already holds or is actively touching, so parallel agents spread out instead of colliding. Returns the claimed task + systems, or why none is free. dry_run:true peeks without claiming.",
"inputSchema": {
"type": "object",
"properties": {
"dry_run": {
"type": "boolean",
"description": "Peek without claiming"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}Edit a task or CLAIM it — DIRECT. assignee:"me"+status:"in-progress" claims (errors if held; force:true for stale); done:true or assignee:"" releases.
| Parameter | Type | Description |
|---|---|---|
| done | boolean | true releases the claim |
| name | string | |
| force | boolean | Take over a STALE claim only |
| human | boolean | true = human-only (next_task/get_briefing skip it); false clears |
| effort | string | "" clears |
| status | string | "" clears |
| task_id * | string | From get_milestone |
| assignee | string | "me" claims; "" releases |
| project_id | string |
{
"name": "update_task",
"description": "Edit a task or CLAIM it — DIRECT. assignee:\"me\"+status:\"in-progress\" claims (errors if held; force:true for stale); done:true or assignee:\"\" releases.",
"inputSchema": {
"type": "object",
"required": [
"task_id"
],
"properties": {
"done": {
"type": "boolean",
"description": "true releases the claim"
},
"name": {
"type": "string"
},
"force": {
"type": "boolean",
"description": "Take over a STALE claim only"
},
"human": {
"type": "boolean",
"description": "true = human-only (next_task/get_briefing skip it); false clears"
},
"effort": {
"enum": [
"S",
"M",
"L",
""
],
"type": "string",
"description": "\"\" clears"
},
"status": {
"enum": [
"in-progress",
"blocked",
""
],
"type": "string",
"description": "\"\" clears"
},
"task_id": {
"type": "string",
"description": "From get_milestone"
},
"assignee": {
"type": "string",
"description": "\"me\" claims; \"\" releases"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}Forge is the live design source-of-truth (vision, Systems[Goal/Boundary/Acceptance], screens, milestones, Inbox) a coding agent builds from. You READ the design and PROPOSE changes — proposals + deletes go to the owner's Inbox to ADOPT in the web app at https://forgeengine.app (you can't adopt or hard-delete). Connect with a forge_sk_ key (Bearer token) — generate one in the web app under "Connect a coding agent"; if the user isn't connected, tell them they can either add the key to their MCP config themselves or paste it to you in chat. Start with get_project_meta; pass project_id (from list_projects) to switch projects. An account key reaches EVERY project its owner has, and nothing pins this connection to one — so CONFIRM which project you are in before you write. Project NAMES are not unique (an account can hold two projects called the same thing, e.g. a port or a sequel), so match on the `id` from list_projects, never on the name. Writing to the wrong project raises no error; it just lands the design in the neighbour. Your CORE loop = Systems + Milestones + Activity: read the SPEC, the PLAN, and who's ACTIVE, then CLAIM your task before building — get_project_meta lists `claims`; update_task(task_id, assignee:"me", status:"in-progress") takes it (errors if someone else holds it), done:true releases. Build, report progress, propose discoveries. Screens & Flow are SECONDARY — user-driven, not part of your default loop. When you add a new System with no milestone task, ASK the user before adding one. FIRST, when you start real work in a repo: check its AGENTS.md / CLAUDE.md for a "Forge working agreement" block. Missing, unversioned, or older than v2026-07-09a? Call get_workflow and WIRE IT IN right away — add/replace the block (create the file if needed) WITHOUT waiting to be asked, then tell the user in one line what you added and why; if they object, remove it and don't re-add. Skip only scratch/throwaway directories. Call get_help anytime for how-to (proposing, what's a System, logging, billing).
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "update_element",
"description": "Move/resize/relabel an element — DIRECT, live. element_id (preferred) or screen+label; x+y also places an unplaced one.",
"inputSchema": {
"type": "object",
"properties": {
"h": {
"type": "number"
},
"w": {
"type": "number"
},
"x": {
"type": "number",
"description": "px on the screen's canvas"
},
"y": {
"type": "number"
},
"note": {
"type": "string",
"description": "\"\" clears"
},
"type": {
"type": "string",
"description": "e.g. button/bar/panel (optional)"
},
"label": {
"type": "string",
"description": "Current label"
},
"screen": {
"type": "string",
"description": "With label, if no element_id"
},
"system": {
"type": "string",
"description": "System it serves"
},
"new_label": {
"type": "string",
"description": "Rename (optional)"
},
"element_id": {
"type": "string",
"description": "From get_screen (preferred)"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}{
"name": "report_build_status",
"description": "Report a SYSTEM's status (todo|in-progress|implemented) — DIRECT, live. ALWAYS pass files (full list — it REPLACES); non-todo with no files shows done-but-EMPTY. 'implemented' counts as VERIFIED only when every UNIT-TESTABLE ## Acceptance bullet is backed via evidence[{criterion,proof}]; a bullet tagged [manual]/[e2e]/[ui]/[wip] is EXEMPT (verified by manual/e2e). Otherwise it's a CLAIM (verified:false) and the response names the unbacked criteria. TWO tiers: VERIFIED = a test is NAMED; GREEN (guarantee) = you RAN the test and reported `passed:true` on the evidence — green goes stale after 21 days, so re-run to keep it.",
"inputSchema": {
"type": "object",
"required": [
"status"
],
"properties": {
"id": {
"type": "string",
"description": "Preferred"
},
"name": {
"type": "string",
"description": "If no id"
},
"files": {
"type": "array",
"items": {
"type": "string"
},
"description": "ONE file per entry (optional ' — function'); prose → decisions"
},
"status": {
"type": "string",
"description": "todo | in-progress | implemented"
},
"version": {
"type": "string",
"description": "e.g. \"0.379.0\""
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"properties": {
"at": {
"type": "string",
"description": "ISO time of the pass (defaults to now); green expires after 21d"
},
"proof": {
"type": "string"
},
"passed": {
"type": "boolean",
"description": "true = you RAN this test and it passed → counts toward TEST-GREEN"
},
"criterion": {
"type": "string"
}
}
},
"description": "Map ## Acceptance bullets to a test/file: [{criterion, proof, passed?, at?}]. Re-send full set (replaces). proof-only = backed (claimed); passed:true = test-green (guarantee)."
},
"decisions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Decisions/divergences (prose)"
},
"project_id": {
"type": "string"
}
}
},
"annotations": {
"forgeTier": "direct-edit",
"destructiveHint": false
}
}