accueil / serveurs / Dev & Code / app.forgeengine/forge
app.forgeengine/forge
serveur MCP (Model Context Protocol) · forge 0.1.0
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que app.forgeengine/forge est sûr ?
Au dernier audit MCP Hub, le serveur MCP « app.forgeengine/forge » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 54 outils
- add_task≈ 202 tokens
Add a task to a milestone — DIRECT. assignee:"me" claims on creation.
Paramètres, retour & exemple (9)
Paramètresdone· boolean · optionnelname· string · requis
Task namehuman· boolean · optionnel
Human-only (GTM/validation/people work) — next_task & get_briefing skip iteffort· string · optionnel · S | M | Lstatus· string · optionnel · in-progress | blockedassignee· string · optionnel
"me" claims itmilestone· string · optionnel
If no idproject_id· string · optionnelmilestone_id· string · optionnel
Preferred
Exemple d'appel{"name": "add_task", "arguments": {"name": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - dedupe≈ 112 tokens
Remove duplicate-named entries (keep first) — DIRECT, destructive.
Paramètres, retour & exemple (3)
Paramètreskind· string · requis · milestones | elements
What to dedupescreen· string · optionnel
For kind=elementsproject_id· string · optionnel
Exemple d'appel{"name": "dedupe", "arguments": {"kind": "milestones"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - delete_entity≈ 196 tokens
PROPOSE a delete → Inbox (owner adopts; nothing deleted now). id preferred or exact name; flow_edge may use from+to.
Paramètres, retour & exemple (6)
Paramètresid· string · optionnel
Entity/task/element/edge idto· string · optionnel
flow_edge: destination screenfrom· string · optionnel
flow_edge: source screenkind· string · requis · system | context | screen | milestone | task | element | flow_edge
What to deletename· string · optionnel
Exact name/title (if no id)project_id· string · optionnel
Exemple d'appel{"name": "delete_entity", "arguments": {"kind": "system"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - design_ui_from_systems≈ 88 tokens
Recipe to design the UI from Systems (user request only): steps + batch id — confirm canvas aspect, then screens + PLACED elements + edges in one batch.
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "design_ui_from_systems", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_balance≈ 101 tokens
Read Balance Lab: stat tables, boards with EVALUATED values, scenarios.
Paramètres, retour & exemple (3)
Paramètresboard· string · optionnel
One board (omit = all)project_id· string · optionnelinclude_rows· boolean · optionnel
false = schema only
Exemple d'appel{"name": "get_balance", "arguments": {"board": "texte", "project_id": "texte", "include_rows": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_briefing≈ 230 tokens
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.
Paramètres, retour & exemple (3)
Paramètrestask· string · optionnel
A task id or name — briefs its milestone's systems insteadfiles· array · optionnel
Repo-relative paths you're about to touch — mapped to their systemsproject_id· string · optionnel
Exemple d'appel{"name": "get_briefing", "arguments": {"task": "texte", "files": [], "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_build_region≈ 207 tokens
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`.
Paramètres, retour & exemple (3)
Paramètrespage· number · optionnel
Which page of the map (default 1); the body tells you how many there aresystem· string · optionnel
One system by name or id — returns its acceptance-criteria detail tooproject_id· string · optionnel
Exemple d'appel{"name": "get_build_region", "arguments": {"page": 1, "system": "texte", "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_design_document≈ 276 tokens
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.
Paramètres, retour & exemple (3)
Paramètrespage· number · optionnel
Which part of the full document to return (default 1). The header tells you how many parts there are.project_id· string · optionnelfor_summary· boolean · optionnel
Return the condensed summarization source (all system goals + boundaries, no tables) instead of the full document
Exemple d'appel{"name": "get_design_document", "arguments": {"page": 1, "project_id": "texte", "for_summary": true}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_help≈ 69 tokens
Forge how-to on demand (no project needed): propose→adopt, what a System is, Balance Lab formats, sign-in. Call when unsure.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_help", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_history≈ 135 tokens
DESIGN MEMORY: recorded decisions/logs/rejections with who/when. Read BEFORE changing a system's direction; empty = no recorded WHY — don't invent one.
Paramètres, retour & exemple (4)
Paramètreslimit· number · optionnel
Default 30, max 100query· string · optionnel
Keyword filtersystem· string · optionnel
System id or exact nameproject_id· string · optionnel
Exemple d'appel{"name": "get_history", "arguments": {"limit": 1, "query": "texte", "system": "texte", "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_impact≈ 120 tokens
BLAST RADIUS of a system (deterministic): upstream context, siblings, dependent screens/milestones, files, code-coupled systems, pending Inbox, recent activity. Run BEFORE changing it.
Paramètres, retour & exemple (3)
Paramètresid· string · optionnel
Preferredname· string · optionnel
If no idproject_id· string · optionnel
Exemple d'appel{"name": "get_impact", "arguments": {"id": "texte", "name": "texte", "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_inbox≈ 70 tokens
PENDING Inbox (the owner's triage queue). Check BEFORE proposing — avoid duplicates. Read-only.
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "get_inbox", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_milestone≈ 97 tokens
ONE milestone: goal, weeks, difficulty, systems, every task (id/name/done/status/effort).
Paramètres, retour & exemple (3)
Paramètresid· string · optionnel
Preferredname· string · optionnel
If no idproject_id· string · optionnel
Exemple d'appel{"name": "get_milestone", "arguments": {"id": "texte", "name": "texte", "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_project_context≈ 70 tokens
FULL design dump — LARGE, last resort; prefer get_project_meta + list_*/get_*/search.
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "get_project_context", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_project_meta≈ 76 tokens
START HERE. Tiny overview: counts, members, task claims + working_now (avoid collisions), forge_workflow_version.
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "get_project_meta", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_rejections≈ 74 tokens
Owner's DECLINED list — check at session start; follow each entry's guidance, then resolve_rejection(title).
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "get_rejections", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_screen≈ 122 tokens
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.
Paramètres, retour & exemple (3)
Paramètresid· string · optionnel
Preferredname· string · optionnel
If no idproject_id· string · optionnel
Exemple d'appel{"name": "get_screen", "arguments": {"id": "texte", "name": "texte", "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_screen_image≈ 110 tokens
A screen's reference image (HUD background) as an actual IMAGE you can see — reads the stored file inline (signed-URL fallback past 4MB).
Paramètres, retour & exemple (3)
Paramètresid· string · optionnel
Preferredname· string · optionnel
If no idproject_id· string · optionnel
Exemple d'appel{"name": "get_screen_image", "arguments": {"id": "texte", "name": "texte", "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_stale≈ 161 tokens
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.
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "get_stale", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_system≈ 102 tokens
ONE system's full spec (Goal/Boundary/Acceptance, markdown, sources, status) + pending Inbox changes touching it.
Paramètres, retour & exemple (3)
Paramètresid· string · optionnel
Preferredname· string · optionnel
If no idproject_id· string · optionnel
Exemple d'appel{"name": "get_system", "arguments": {"id": "texte", "name": "texte", "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - get_workflow≈ 83 tokens
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).
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "get_workflow", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - import_from_code≈ 82 tokens
One-command codebase import: recipe + batch id — propose one Context overview + one System per real module; the owner adopts all at once.
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "import_from_code", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_activity≈ 147 tokens
Change history {who, change, entity, kind, when}, newest first; filter kind/who/query.
Paramètres, retour & exemple (5)
Paramètreswho· string · optionnel
Author email substring (optional)kind· string · optionnel
system | context | milestone | screen (optional)limit· number · optionnel
Default 30, max 200query· string · optionnel
Keyword filter (optional)project_id· string · optionnel
Exemple d'appel{"name": "list_activity", "arguments": {"who": "texte", "kind": "texte", "limit": 1, "query": "texte", "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_milestones≈ 63 tokens
All milestones, compact: id, name, weeks, order, done/total.
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "list_milestones", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_projects≈ 59 tokens
Projects your key reaches (id, name, role); pass an id as project_id to switch.
Paramètres, retour & exemple (0)
Exemple d'appel{"name": "list_projects", "arguments": {}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_screens≈ 59 tokens
All screens, compact: id, name, purpose, status.
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "list_screens", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - list_systems≈ 60 tokens
All systems, compact: id, name, status, 1-line goal.
Paramètres, retour & exemple (1)
Paramètresproject_id· string · optionnel
Exemple d'appel{"name": "list_systems", "arguments": {"project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - next_task≈ 162 tokens
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.
Paramètres, retour & exemple (2)
Paramètresdry_run· boolean · optionnel
Peek without claimingproject_id· string · optionnel
Exemple d'appel{"name": "next_task", "arguments": {"dry_run": true, "project_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - post_log≈ 133 tokens
Append a build-log entry to Activity — what you built/decided (commit-note style).
Paramètres, retour & exemple (4)
Paramètrestext· string · requis
What you did / decided (1–2 sentences)entity· string · optionnel
System/screen/milestone it's aboutversion· string · optionnel
e.g. "0.379.0"project_id· string · optionnel
Exemple d'appel{"name": "post_log", "arguments": {"text": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - propose_balance_board≈ 156 tokens
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.
Paramètres, retour & exemple (3)
Paramètresname· string · requis
Board namenodes· array · requis
e.g. {kind:"formula",name:"dmg",formula:"atk - mdef"}project_id· string · optionnel
Exemple d'appel{"name": "propose_balance_board", "arguments": {"name": "texte", "nodes": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - propose_balance_table≈ 202 tokens
Propose a stat-doc TABLE → Inbox. csv (header; `key%` = percent; first column = name) OR schema+rows. Adopting REPLACES same-named.
Paramètres, retour & exemple (6)
Paramètrescsv· string · optionnel
Header + rows; non-numeric = inforows· array · optionnel
[{name, atk: 350, …}]title· string · requis
Table nameschema· array · optionnel
[{key, mode: flat|pct|text, base, min, max, desc}]registry· boolean · optionnel
true = the shared Stats registryproject_id· string · optionnel
Exemple d'appel{"name": "propose_balance_table", "arguments": {"title": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - propose_context≈ 264 tokens
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.
Paramètres, retour & exemple (6)
Paramètresbatch· string · optionnel
import_from_code batch idtitle· string · requis
Match existing to update, or new to addresync· boolean · optionnel
This note was re-derived from the current systems — re-stamps both staleness signals on adoptcontent· string · requis
Complete text, not a deltaproject_id· string · optionnelacknowledge_rejection· boolean · optionnel
Only after a DECLINED bounce AND asking the user
Exemple d'appel{"name": "propose_context", "arguments": {"title": "texte", "content": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - propose_dna≈ 120 tokens
Propose Project DNA and/or Tech Notes → Inbox (at least one).
Paramètres, retour & exemple (4)
Paramètresdna· string · optionnel
Omit to leave unchangedbatch· string · optionnel
import_from_code batch idproject_id· string · optionneltech_notes· string · optionnel
Omit to leave unchanged
Exemple d'appel{"name": "propose_dna", "arguments": {"dna": "texte", "batch": "texte", "project_id": "texte", "tech_notes": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - propose_element≈ 234 tokens
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.
Paramètres, retour & exemple (10)
Paramètresh· number · optionnel
Default 40w· number · optionnel
Default 120x· number · optionnel
Left pxy· number · optionnel
Top pxnote· string · optionneltype· string · optionnel
button/bar/panel/text (default box)label· string · requis
Element label, e.g. 'HP bar'screen· string · requis
Existing screen namesystem· string · optionnel
System it servesproject_id· string · optionnel
Exemple d'appel{"name": "propose_element", "arguments": {"label": "texte", "screen": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - propose_flow_edge≈ 130 tokens
SECONDARY (user-driven UI): propose a link between two existing screens → Inbox.
Paramètres, retour & exemple (4)
Paramètresto· string · requis
Destination screen namefrom· string · requis
Source screen namelabel· string · optionnel
Transition label (optional)project_id· string · optionnel
Exemple d'appel{"name": "propose_flow_edge", "arguments": {"to": "texte", "from": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - propose_milestone≈ 155 tokens
Propose a NEW milestone (+ optional tasks) → Inbox.
Paramètres, retour & exemple (5)
Paramètresgoal· string · optionnel
One-line goal (optional)name· string · requis
Milestone nametasks· array · optionnel
Task names (optional)project_id· string · optionnelacknowledge_rejection· boolean · optionnel
Only after a DECLINED bounce AND asking the user
Exemple d'appel{"name": "propose_milestone", "arguments": {"name": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - propose_screen≈ 155 tokens
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.
Paramètres, retour & exemple (4)
Paramètresname· string · requis
Screen name (Title Case, English)parent· string · optionnel
Make it a POPUP over this screenpurpose· string · optionnel
What this screen is forproject_id· string · optionnel
Exemple d'appel{"name": "propose_screen", "arguments": {"name": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - propose_system≈ 257 tokens
Propose a NEW system → Inbox. spec = ## Goal / ## Boundary (Owns · Doesn't own) / ## Acceptance. Exists? use update_system. (Alias: create_proposal.)
Paramètres, retour & exemple (7)
Paramètresspec· string · requis
Markdown: ## Goal / ## Boundary / ## Acceptancebatch· string · optionnel
import_from_code batch idfiles· array · optionnel
Implementing paths, ONE file per entrytitle· string · requis
System name (Title Case, English)project_id· string · optionnelderives_from· array · optionnel
Context note title(s) this system derives from → wires provenance (upstream + siblings)acknowledge_rejection· boolean · optionnel
Only after a DECLINED bounce AND asking the user
Exemple d'appel{"name": "propose_system", "arguments": {"spec": "texte", "title": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - rename_screen≈ 112 tokens
Rename a screen IN PLACE — DIRECT; links/elements follow (id-referenced).
Paramètres, retour & exemple (3)
Paramètresname· string · requis
Exact CURRENT namenew_name· string · requis
New name (must not collide)project_id· string · optionnel
Exemple d'appel{"name": "rename_screen", "arguments": {"name": "texte", "new_name": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - reorder≈ 184 tokens
Reorder milestones / tasks / elements — DIRECT. order = ids in new order; omitted keep relative order.
Paramètres, retour & exemple (6)
Paramètreskind· string · requis · milestones | tasks | elements
What to reorderorder· array · requis
Ids in the new orderscreen· string · optionnel
For kind=elementsmilestone· string · optionnel
For kind=tasks (name)project_id· string · optionnelmilestone_id· string · optionnel
For kind=tasks
Exemple d'appel{"name": "reorder", "arguments": {"kind": "milestones", "order": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - report_build_status≈ 479 tokens
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.
Paramètres, retour & exemple (8)
Paramètresid· string · optionnel
Preferredname· string · optionnel
If no idfiles· array · optionnel
ONE file per entry (optional ' — function'); prose → decisionsstatus· string · requis
todo | in-progress | implementedversion· string · optionnel
e.g. "0.379.0"evidence· array · optionnel
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 · optionnel
Decisions/divergences (prose)project_id· string · optionnel
Exemple d'appel{"name": "report_build_status", "arguments": {"status": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - report_drift≈ 148 tokens
Flag CODE DRIFT — mapped files no longer match the repo. Advisory; a fresh report_build_status clears it.
Paramètres, retour & exemple (5)
Paramètresid· string · optionnel
Preferredname· string · optionnel
If no idnote· string · optionnel
Optional — what driftedproject_id· string · optionnelmissing_files· array · optionnel
Paths that no longer exist
Exemple d'appel{"name": "report_drift", "arguments": {"id": "texte", "name": "texte", "note": "texte", "project_id": "texte", "missing_files": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - report_milestone_progress≈ 140 tokens
Mark existing-milestone tasks done → Inbox progress card (owner adopts the ticks).
Paramètres, retour & exemple (4)
Paramètresid· string · optionnel
Preferredmilestone· string · optionnel
Milestone name (if no id)done_tasks· array · requis
Task names that are doneproject_id· string · optionnel
Exemple d'appel{"name": "report_milestone_progress", "arguments": {"done_tasks": []}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - report_screen_status≈ 112 tokens
Report a SCREEN's status (todo|in-progress|implemented) → Inbox.
Paramètres, retour & exemple (3)
Paramètresscreen· string · requis
Screen namestatus· string · requis
todo | in-progress | implementedproject_id· string · optionnel
Exemple d'appel{"name": "report_screen_status", "arguments": {"screen": "texte", "status": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - resolve_rejection≈ 103 tokens
Report you REVERTED a declined change (unlocks the owner's Clear). Call after realigning the build.
Paramètres, retour & exemple (2)
Paramètrestitle· string · requis
Exactly as get_rejections returned itproject_id· string · optionnel
Exemple d'appel{"name": "resolve_rejection", "arguments": {"title": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - resync_from_idea≈ 182 tokens
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.
Paramètres, retour & exemple (2)
Paramètresnote· string · requis
The Idea note's title or id (from get_stale)project_id· string · optionnel
Exemple d'appel{"name": "resync_from_idea", "arguments": {"note": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - search≈ 117 tokens
Keyword search — compact hits {kind, id, name} + snippet.
Paramètres, retour & exemple (3)
Paramètreskinds· array · optionnel
Optional: system | context | milestone | task | screen | proposalquery· string · requis
Text to search forproject_id· string · optionnel
Exemple d'appel{"name": "search", "arguments": {"query": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - set_design_overview≈ 294 tokens
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.
Paramètres, retour & exemple (2)
Paramètressummary· string · requis
The Overview in markdown, starting at `### What this is`project_id· string · optionnel
Exemple d'appel{"name": "set_design_overview", "arguments": {"summary": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - trace_ui_from_image≈ 206 tokens
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.
Paramètres, retour & exemple (2)
Paramètresscreen· string · requis
The screen whose reference image to trace (name or id)project_id· string · optionnel
Exemple d'appel{"name": "trace_ui_from_image", "arguments": {"screen": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_element≈ 238 tokens
Move/resize/relabel an element — DIRECT, live. element_id (preferred) or screen+label; x+y also places an unplaced one.
Paramètres, retour & exemple (12)
Paramètresh· number · optionnelw· number · optionnelx· number · optionnel
px on the screen's canvasy· number · optionnelnote· string · optionnel
"" clearstype· string · optionnel
e.g. button/bar/panel (optional)label· string · optionnel
Current labelscreen· string · optionnel
With label, if no element_idsystem· string · optionnel
System it servesnew_label· string · optionnel
Rename (optional)element_id· string · optionnel
From get_screen (preferred)project_id· string · optionnel
Exemple d'appel{"name": "update_element", "arguments": {"h": 1, "w": 1, "x": 1, "y": 1, "note": "texte", "type": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_milestone≈ 160 tokens
Edit milestone goal/weeks/difficulty/name — DIRECT. new_name renames (never delete+recreate).
Paramètres, retour & exemple (7)
Paramètresid· string · optionnel
Preferredgoal· string · optionnelname· string · optionnel
Current name (if no id)weeks· number · optionnelnew_name· string · optionnel
Renamedifficulty· string · optionnel · easy | medium | hard |
"" clearsproject_id· string · optionnel
Exemple d'appel{"name": "update_milestone", "arguments": {"id": "texte", "goal": "texte", "name": "texte", "weeks": 1, "new_name": "texte", "difficulty": "easy"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_system≈ 300 tokens
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.
Paramètres, retour & exemple (9)
Paramètresid· string · optionnel
Preferredname· string · optionnel
If no idspec· string · requis
Full revised spec markdownresync· boolean · optionnel
This spec was re-derived from its upstream Idea — re-stamps sourceSig on adopt. Never set it on an ordinary edit.context· string · optionnel
Full revised Idea textnew_title· string · optionnel
Rename in the same cardproject_id· string · optionnelcontext_title· string · optionnel
Idea section to also updateacknowledge_rejection· boolean · optionnel
Only after a DECLINED bounce AND asking the user
Exemple d'appel{"name": "update_system", "arguments": {"spec": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - update_task≈ 251 tokens
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.
Paramètres, retour & exemple (9)
Paramètresdone· boolean · optionnel
true releases the claimname· string · optionnelforce· boolean · optionnel
Take over a STALE claim onlyhuman· boolean · optionnel
true = human-only (next_task/get_briefing skip it); false clearseffort· string · optionnel · S | M | L |
"" clearsstatus· string · optionnel · in-progress | blocked |
"" clearstask_id· string · requis
From get_milestoneassignee· string · optionnel
"me" claims; "" releasesproject_id· string · optionnel
Exemple d'appel{"name": "update_task", "arguments": {"task_id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]} - withdraw_proposal≈ 94 tokens
Remove YOUR OWN still-pending Inbox item (id from the propose response / get_inbox).
Paramètres, retour & exemple (2)
Paramètresid· string · requis
The pending item's idproject_id· string · optionnel
Exemple d'appel{"name": "withdraw_proposal", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}]}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».
Source
https://mmvdabzadclebfxyzudg.supabase.co/functions/v1/forge-mcp