@opengsd/mcp-server

Read a file

Echo a string value

Echoes the message back

Returns a circle image for visualization

Save evidence

Write a todo item

Find files by pattern

A custom tool

Perform basic arithmetic operations

Evaluate mathematical expressions

Ask questions

Deduped tool

Plan slice

Plan task

Reassess roadmap

Save UAT result

Probe-visible tool

Discover-visible tool

Probe-visible workflow tool

Echo request _meta

A simple greeting tool

Return a final structured answer. Use this as your last action when the user asks for structured output or a machine-readable summary.

Start a GSD auto-mode session for a project directory. Returns a sessionId for tracking.

Get the result of a GSD session. Returns partial results if the session is still running.

Cancel a running GSD session. Aborts the current operation and stops the process. Provide sessionId (from gsd_execute) or projectDir as a fallback for interactive/restarted sessions.

Cancel the active GSD session for a project directory. Use when sessionId is unknown (e.g. Hermes gateway /gsd cancel).

Query GSD project state from the filesystem. By default returns STATE.md, PROJECT.md, requirements, and milestone listing. Pass `query` to narrow the response (accepted:

Resolve a pending blocker in a GSD session by sending a response to the UI request.

Collect environment variables securely via form input. Values are written directly to .env (or Vercel/Convex) and NEVER appear in tool output — only key names and applied/skipped status are returned. Use this instead of asking users to manually edit .env files or paste secrets into chat.

Get structured project progress: active milestone/slice/task, phase, completion counts, blockers, and next action. No session required — reads directly from .gsd/ on disk.

Get the full project roadmap structure: milestones with their slices, tasks, status, risk, and dependencies. Optionally filter to a single milestone. No session required.

Get execution history with cost, token usage, model, and duration per unit. Returns totals across all units. No session required.

Run a lightweight structural health check on the .gsd/ directory. Checks for missing files, status inconsistencies, and orphaned state. No session required.

Get captured ideas and thoughts from CAPTURES.md with triage status. Filter by pending, actionable, or all. No session required.

Get the project knowledge base: rules, patterns, and lessons learned accumulated during development. No session required.

Record a project decision to the GSD database and regenerate DECISIONS.md.

Alias for gsd_decision_save. Record a project decision to the GSD database and regenerate DECISIONS.md.

List decisions from the GSD database. Returns canonical store (never stale). Use instead of parsing DECISIONS.md.

Fetch a single decision by ID from the GSD database. Returns the full row or error (not_found / db_unavailable).

Update an existing requirement in the GSD database and regenerate REQUIREMENTS.md.

Alias for gsd_requirement_update. Update an existing requirement in the GSD database and regenerate REQUIREMENTS.md.

Record a new requirement to the GSD database and regenerate REQUIREMENTS.md.

Alias for gsd_requirement_save. Record a new requirement to the GSD database and regenerate REQUIREMENTS.md.

List requirements from the GSD database. Returns canonical store (never stale). Use instead of parsing REQUIREMENTS.md.

Fetch a single requirement by ID from the GSD database. Returns the full row or error (not_found / db_unavailable).

Generate the next milestone ID for a new GSD milestone.

Alias for gsd_milestone_generate_id. Generate the next milestone ID for a new GSD milestone.

Write milestone planning state to the GSD database and render ROADMAP.md from DB.

Alias for gsd_plan_milestone. Write milestone planning state to the GSD database and render ROADMAP.md from DB.

Alias for gsd_plan_slice. Write slice/task planning state to the GSD database and render plan artifacts from DB.

Alias for gsd_plan_task. Write task planning state to the GSD database and render the slice PLAN from DB.

Replan a slice after a blocker is discovered, preserving completed tasks and re-rendering PLAN.md + REPLAN.md.

Alias for gsd_replan_slice. Replan a slice after a blocker is discovered.

Update one pending task

Persist a structured task rework brief whose blocking findings gate gsd_task_complete.

Commit evidence-backed Slice completion in one revision- and Authority-Epoch-fenced SQLite operation, then refresh readable projections; projection failure is reported as stale.

Alias for gsd_slice_complete. Commit evidence-backed Slice completion in SQLite, then refresh readable projections.

Cancel a Slice atomically in SQLite, preserve completed work, interrupt running Attempts, and grant a current Slice-scoped dependency Waiver before refreshing projections.

Commit validated Milestone completion atomically, then render its readable SUMMARY projection.

Alias for gsd_complete_milestone. Commit validated Milestone completion atomically, then render its readable SUMMARY projection.

Validate a milestone, persist validation results to the GSD database, and render VALIDATION.md.

Alias for gsd_validate_milestone. Validate a milestone and render VALIDATION.md.

Prepare a source-bound subjective Milestone UAT question with a recommendation for a real user decision.

Record the user

Alias for gsd_reassess_roadmap. Reassess a roadmap after slice completion.

Save a quality gate result to the GSD database.

Save a GSD summary/research/context/assessment artifact to the database and disk. Omit milestone_id only for root-level PROJECT/PROJECT-DRAFT/REQUIREMENTS/REQUIREMENTS-DRAFT artifacts.

Alias for gsd_summary_save. Save a GSD summary/research/context/assessment artifact to the database and disk.

Record a Task execution result in SQLite; canonical Tasks advance to host verification or recovery, while legacy Tasks complete directly and refresh readable projections.

Alias for gsd_task_complete. Record a Task result and advance canonical host verification/recovery or legacy completion.

Reset a completed task back to pending so it can be re-done.

Alias for gsd_task_reopen. Reset a completed task back to pending so it can be re-done.

Authorize one new Task Attempt after the current durable abort cause has been repaired.

Operator tool: settle a Task

Reopen a terminal Slice and all Tasks atomically in SQLite while preserving immutable history, revoking cancellation Waivers, and blocking progressed downstream Slices.

Alias for gsd_slice_reopen. Reopen a terminal Slice and all Tasks atomically in SQLite while preserving immutable history and enforcing downstream guards.

Reopen a terminal Milestone hierarchy atomically while preserving immutable history, then refresh readable projections. Pass keepCompleted=true to unlock the milestone without resetting completed slices/tasks or deleting their SUMMARYs.

Alias for gsd_milestone_reopen. Reopen a terminal Milestone hierarchy atomically, then refresh readable projections. Pass keepCompleted=true to unlock without resetting completed work.

Read the current status of a milestone and all its slices from the GSD database. Includes `dependsOn`, the persisted milestone dependencies.

Flush the SQLite WAL into gsd.db so git add stages the current GSD database state.

Query the structured event journal for auto-mode iterations.

Run one UAT-scoped bash/node/python check with milestone/slice/check metadata. Evidence persists under .gsd/exec with kind=uat_exec.

Run a short bash/node/python script in the project directory. Capped stdout/stderr and metadata persist under .gsd/exec; only a digest returns to MCP.

Search prior gsd_exec runs from .gsd/exec/*.meta.json without re-running them.

Read .gsd/last-snapshot.md so agents can re-orient after compaction or session resume.

Record a durable project insight into the GSD memory store. Categories: architecture, convention, gotcha, preference, environment, pattern. Mirrors the in-process capture_thought tool for external MCP clients.

Search the GSD memory store by keyword. Returns ranked memories with id, category, content, confidence, scope, and tags. Mirrors the in-process memory_query tool for external MCP clients.

Inspect the relationship graph between memories. mode=query walks edges from a given memoryId. mode=build is a placeholder reserved for future graph rebuilds. Distinct from gsd_graph (project knowledge graph) — see ADR-013.

Look up a value

Doubles a number and returns the result

Returns a red circle image with a short text description.

Perform basic arithmetic operations

Run a shell command