MCP Operations

Use this skill whenever work touches mcp/ behavior or MCP host integration.

Core workflow

• Confirm dashboard API is running (/api/health).
• Confirm MCP server build status.
• Validate env flags for mutation/destructive modes.
• Verify host configuration path and command.

Safe operations policy

• Default to read-only mode (MCP_DASHBOARD_ALLOW_MUTATIONS=false).
• Enable mutations only for explicit admin tasks.
• Enable destructive mode only transiently and require explicit confirmation token.

Required verification for code changes

• npm run mcp:typecheck
• npm run test:mcp
• npm run mcp:build

Catalog invariant

• Add tools only through mcp/src/tools/domains/ and registerAllTools.
• Protocol transports and REPL must use the same declarations and schemas.
• Update .agents/skills/mcp-maintainer/references/tool-domain-map.md when a domain changes.

References

• Host config examples: references/host-config.md
• Operations runbook: references/runbook.md