mcp-operations git:20260804.9eab0d7A

Immutable. This exact content is served forever at /api/v1/blob/dbaf121edb39b14f.

---
name: mcp-operations
description: Operate and maintain the local MCP server for this project. Use when creating MCP host config, troubleshooting tool connectivity, modifying tool domains, or adjusting safety policy flags.
---

# 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`