@opengsd/mcp-server
Cloud MCP gateway for brokering remote MCP clients to local GSD runtimes
Versions
1.11.0latest1.10.01.9.01.8.11.8.0+ show 6 moreshow less
1.7.01.6.01.5.01.4.01.3.01.2.0Tools 95
read Read a file
echo_value Echo a string value
echo Echoes the message back
get_circle Returns a circle image for visualization
save_evidence Save evidence
todowrite Write a todo item
find Find files by pattern
my_custom_tool A custom tool
math_operation Perform basic arithmetic operations
calculate Evaluate mathematical expressions
ask_user_questions Ask questions
dedupe_tool Deduped tool
gsd_plan_slice Plan slice
gsd_plan_task Plan task
gsd_reassess_roadmap Reassess roadmap
gsd_uat_result_save Save UAT result
fake fake_tool Probe-visible tool
discover_tool Discover-visible tool
gsd_status Probe-visible workflow tool
echo_meta Echo request _meta
gsd-workflow hello A simple greeting tool
structured_output Return a final structured answer. Use this as your last action when the user asks for structured output or a machine-readable summary.
gsd_execute Start a GSD auto-mode session for a project directory. Returns a sessionId for tracking.
gsd_result Get the result of a GSD session. Returns partial results if the session is still running.
gsd_cancel 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.
gsd_cancel_by_project Cancel the active GSD session for a project directory. Use when sessionId is unknown (e.g. Hermes gateway /gsd cancel).
gsd_query 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:
gsd_resolve_blocker Resolve a pending blocker in a GSD session by sending a response to the UI request.
secure_env_collect 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.
gsd_progress Get structured project progress: active milestone/slice/task, phase, completion counts, blockers, and next action. No session required — reads directly from .gsd/ on disk.
gsd_roadmap Get the full project roadmap structure: milestones with their slices, tasks, status, risk, and dependencies. Optionally filter to a single milestone. No session required.
gsd_history Get execution history with cost, token usage, model, and duration per unit. Returns totals across all units. No session required.
gsd_doctor Run a lightweight structural health check on the .gsd/ directory. Checks for missing files, status inconsistencies, and orphaned state. No session required.
gsd_captures Get captured ideas and thoughts from CAPTURES.md with triage status. Filter by pending, actionable, or all. No session required.
gsd_knowledge Get the project knowledge base: rules, patterns, and lessons learned accumulated during development. No session required.
gsd_decision_save Record a project decision to the GSD database and regenerate DECISIONS.md.
gsd_save_decision Alias for gsd_decision_save. Record a project decision to the GSD database and regenerate DECISIONS.md.
gsd_decision_list List decisions from the GSD database. Returns canonical store (never stale). Use instead of parsing DECISIONS.md.
gsd_decision_get Fetch a single decision by ID from the GSD database. Returns the full row or error (not_found / db_unavailable).
gsd_requirement_update Update an existing requirement in the GSD database and regenerate REQUIREMENTS.md.
gsd_update_requirement Alias for gsd_requirement_update. Update an existing requirement in the GSD database and regenerate REQUIREMENTS.md.
gsd_requirement_save Record a new requirement to the GSD database and regenerate REQUIREMENTS.md.
gsd_save_requirement Alias for gsd_requirement_save. Record a new requirement to the GSD database and regenerate REQUIREMENTS.md.
gsd_requirement_list List requirements from the GSD database. Returns canonical store (never stale). Use instead of parsing REQUIREMENTS.md.
gsd_requirement_get Fetch a single requirement by ID from the GSD database. Returns the full row or error (not_found / db_unavailable).
gsd_milestone_generate_id Generate the next milestone ID for a new GSD milestone.
gsd_generate_milestone_id Alias for gsd_milestone_generate_id. Generate the next milestone ID for a new GSD milestone.
gsd_plan_milestone Write milestone planning state to the GSD database and render ROADMAP.md from DB.
gsd_milestone_plan Alias for gsd_plan_milestone. Write milestone planning state to the GSD database and render ROADMAP.md from DB.
gsd_slice_plan Alias for gsd_plan_slice. Write slice/task planning state to the GSD database and render plan artifacts from DB.
gsd_task_plan Alias for gsd_plan_task. Write task planning state to the GSD database and render the slice PLAN from DB.
gsd_replan_slice Replan a slice after a blocker is discovered, preserving completed tasks and re-rendering PLAN.md + REPLAN.md.
gsd_slice_replan Alias for gsd_replan_slice. Replan a slice after a blocker is discovered.
gsd_replan_task Update one pending task
gsd_rework_brief_save Persist a structured task rework brief whose blocking findings gate gsd_task_complete.
gsd_slice_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.
gsd_complete_slice Alias for gsd_slice_complete. Commit evidence-backed Slice completion in SQLite, then refresh readable projections.
gsd_skip_slice Cancel a Slice atomically in SQLite, preserve completed work, interrupt running Attempts, and grant a current Slice-scoped dependency Waiver before refreshing projections.
gsd_complete_milestone Commit validated Milestone completion atomically, then render its readable SUMMARY projection.
gsd_milestone_complete Alias for gsd_complete_milestone. Commit validated Milestone completion atomically, then render its readable SUMMARY projection.
gsd_validate_milestone Validate a milestone, persist validation results to the GSD database, and render VALIDATION.md.
gsd_milestone_validate Alias for gsd_validate_milestone. Validate a milestone and render VALIDATION.md.
gsd_prepare_milestone_subjective_uat Prepare a source-bound subjective Milestone UAT question with a recommendation for a real user decision.
gsd_answer_milestone_subjective_uat Record the user
gsd_roadmap_reassess Alias for gsd_reassess_roadmap. Reassess a roadmap after slice completion.
gsd_save_gate_result Save a quality gate result to the GSD database.
gsd_summary_save 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.
gsd_save_summary Alias for gsd_summary_save. Save a GSD summary/research/context/assessment artifact to the database and disk.
gsd_task_complete Record a Task execution result in SQLite; canonical Tasks advance to host verification or recovery, while legacy Tasks complete directly and refresh readable projections.
gsd_complete_task Alias for gsd_task_complete. Record a Task result and advance canonical host verification/recovery or legacy completion.
gsd_task_reopen Reset a completed task back to pending so it can be re-done.
gsd_reopen_task Alias for gsd_task_reopen. Reset a completed task back to pending so it can be re-done.
gsd_task_recovery_resume Authorize one new Task Attempt after the current durable abort cause has been repaired.
gsd_task_settle Operator tool: settle a Task
gsd_slice_reopen Reopen a terminal Slice and all Tasks atomically in SQLite while preserving immutable history, revoking cancellation Waivers, and blocking progressed downstream Slices.
gsd_reopen_slice Alias for gsd_slice_reopen. Reopen a terminal Slice and all Tasks atomically in SQLite while preserving immutable history and enforcing downstream guards.
gsd_milestone_reopen 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.
gsd_reopen_milestone Alias for gsd_milestone_reopen. Reopen a terminal Milestone hierarchy atomically, then refresh readable projections. Pass keepCompleted=true to unlock without resetting completed work.
gsd_milestone_status Read the current status of a milestone and all its slices from the GSD database. Includes `dependsOn`, the persisted milestone dependencies.
gsd_checkpoint_db Flush the SQLite WAL into gsd.db so git add stages the current GSD database state.
gsd_journal_query Query the structured event journal for auto-mode iterations.
gsd_uat_exec Run one UAT-scoped bash/node/python check with milestone/slice/check metadata. Evidence persists under .gsd/exec with kind=uat_exec.
gsd_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.
gsd_exec_search Search prior gsd_exec runs from .gsd/exec/*.meta.json without re-running them.
gsd_resume Read .gsd/last-snapshot.md so agents can re-orient after compaction or session resume.
gsd_capture_thought 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.
gsd_memory_query 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.
gsd_memory_graph 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.
lookup Look up a value
double_number Doubles a number and returns the result
get_circle_with_description Returns a red circle image with a short text description.
calculator Perform basic arithmetic operations
bash Run a shell command
Permissions 5
network medium filesystem low shell high database medium env_vars low