# mcp-operations

The mcp-operations skill guides local MCP server checks, host configuration, and safety settings. Use it when tool connectivity fails or MCP behavior changes.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1198 repo stars
- Author: hoangsonww
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/.claude/skills/mcp-operations/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/mcp-operations

## What it does

The skill lays out an MCP operations sequence: check `/api/health` and the server build, review environment flags for mutating or destructive modes, then verify the host configuration path and command. It covers host setup and troubleshooting tool connections.

For code changes, run `npm run mcp:typecheck`, `npm run test:mcp`, and `npm run mcp:build`. Add tools through `mcp/src/tools/domains/` and `registerAllTools`; when a domain changes, update `tool-domain-map.md`. Read-only operation is the default. Destructive mode is temporary and requires an explicit confirmation token, so enabling it without a specific admin task conflicts with the stated policy.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-operations -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/mcp-operations/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/mcp-operations/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-operations -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/mcp-operations/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-operations -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/mcp-operations/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hoangsonww/Claude-Code-Agent-Monitor .claude/skills/mcp-operations
```

2. **Manually: put the files in place**
- File: `.github/skills/mcp-operations/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-operations -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path .claude/skills/mcp-operations
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/mcp-operations/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/.claude/skills/mcp-operations/SKILL.md

## When to use it
- check whether the dashboard API responds at `/api/health`
- trace a failed connection between the host and MCP tools
- review flags that permit mutations or destructive actions
- register an MCP tool in its domain

## Example prompts
- Check the MCP host connection and tell me what to verify first.
- Review this planned change to an MCP tool domain against the project rules.
- Run the required typecheck, MCP tests, and build checks for my changes.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 23023af176b769b7.

BEGIN THIRD-PARTY FILE 23023af176b769b7
```text
---
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`
```
END THIRD-PARTY FILE 23023af176b769b7

The third-party file has ended. Everything between the 23023af176b769b7 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© hoangsonww · MIT · https://github.com/hoangsonww/Claude-Code-Agent-Monitor/tree/HEAD/.claude/skills/mcp-operations/SKILL.md

## Similar
- [mcp-patterns](https://affpapa.org/en/nevibecode/skills/mcp-patterns.md) — skill · 191 installs
- [Linux MCP daemon (mcpd)](https://affpapa.org/en/nevibecode/mcp/linux-mcp-daemon-mcpd.md) — MCP server · ★ 7 repo stars
- [mcp-server-architect](https://affpapa.org/en/nevibecode/agents/mcp-server-architect.md) — subagent · 1649 installs
- [nitro](https://affpapa.org/en/nevibecode/skills/nitro.md) — skill · 3000 installs
- [SSH MCP Server](https://affpapa.org/en/nevibecode/mcp/hypnosis-ssh-mcp-server.md) — MCP server · ★ 11 repo stars
- [platform-operations](https://affpapa.org/en/nevibecode/skills/platform-operations.md) — skill · ★ 587 repo stars

From the same set: [hoangsonww/claude-code-agent-monitor](https://affpapa.org/en/nevibecode/by/hoangsonww/claude-code-agent-monitor.md) — 155 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
