| name | mcp-gate-debug |
| description | After Fusebase Gate MCP tool sessions, produce a concise debug-oriented summary — what went smoothly, what did not, and actionable improvements to fusebase-gate skills, prompts, or MCP server behavior. Prioritize isolated SQL/NoSQL store flows. |
MCP Gate debug summary
Purpose
Close the loop on Gate MCP work: turn friction into specific improvement ideas for:
.claude/skills/fusebase-gate/ (especially SKILL.md and references/*.md)
- MCP prompts / tool descriptions (upstream server)
- Local app code only when the issue is clearly client-side misuse
When to run
After you finish (or pause) a coherent batch of Gate MCP tool_call operations — especially:
- Isolated stores —
listIsolatedStores, createIsolatedStore, initIsolatedStoreStage, migration status/apply, row CRUD, queryIsolatedStoreSql, NoSQL equivalents
- Org users, tokens, permissions, health/bootstrap when those sessions were rough
If the user only asked a one-line question with no tools, skip this summary unless they ask for it.
Output format (in the conversation)
Keep it scannable:
- Went well — bullets (tools, prompts, docs that helped).
- Friction — wrong assumptions, missing context, repeated
tools_describe, unclear errors, wrong orgId/storeId/stage, migration/drift confusion, permission surprises.
- Improvements — ordered by impact. For each idea, prefer:
- Target: file path (e.g.
fusebase-gate/references/isolated-sql-integrator-troubleshooting.md) or “MCP tool X description / prompt Y”
- Change: one sentence
- Why: link to the failure you saw
Isolated stores first
When isolated-store tools were used, before proposing doc changes, re-read if needed:
.claude/skills/fusebase-gate/references/isolated-sql.md
.claude/skills/fusebase-gate/references/isolated-sql-migration-discipline.md
.claude/skills/fusebase-gate/references/isolated-sql-integrator-troubleshooting.md
.claude/skills/fusebase-gate/references/isolated-nosql.md (if NoSQL)
The summary should call out:
- Missing playbook steps (status before apply,
dryRun, checksum/version discipline).
- Confusion between dev and prod stages.
- Whether
structuredIssues / drift messaging was understandable.
Boundaries
- Do not dump raw tool JSON; summarize patterns.
- If the fix belongs in this repo’s
project-template only, say so; if it belongs to the Gate MCP service or platform, label it as upstream.
Flag
This skill is copied into the project only when the global CLI flag mcp-gate-debug is enabled (fusebase config set-flag mcp-gate-debug then fusebase update --skip-mcp --skip-deps --skip-cli-update --skip-commit).