Skip to main content
skill CX Codex

mcp-operations — Claude Code skill for MCP setup

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

MIT ★ 1,198 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-operations -a claude-code
Open on GitHub

What mcp-operations 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.

What it helps with

  • 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 for the agent

  • 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.

How to install mcp-operations

1Skills CLI (Vercel)

npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-operations -a claude-code

2Manually: put the files in place

~/.claude/skills/mcp-operations/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mcp-operations/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about mcp-operations

How do I install mcp-operations in Claude Code?

Run npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-operations -a claude-code. The skill file is placed at ~/.claude/skills/mcp-operations/SKILL.md.

What does mcp-operations do?

It provides a workflow for checking the local MCP server, configuring its host, and handling safety flags. For code changes, it calls for typecheck, test, and build commands.

When can destructive MCP mode be enabled?

Only temporarily for an explicit admin task, with a confirmation token. The default policy is read-only.

Source text

SKILL.md · MIT
---
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`

© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor

Similar skills

All skills for Backend and APIs →

From the same set155

The whole set →
recent recent fetches the latest Claude Code sessions from Agent Monitor with costs and run statuses. Useful when you need a quick summary of agent activity and spending. CX Codex +1 ★ 1,198repo stars ship-feature ship-feature — a workflow for taking medium or large feature changes from module inspection through implementation, verification, and documentation updates. Covers backend, frontend, and MCP work. CX Codex +1 ★ 1,198repo stars budget Puts your Claude spend next to a monthly budget you name, then tells you whether you are under it, on pace or already over. CX Codex +1 ★ 1,198repo stars tail-events tail-events fetches recent events from a local Agent Monitor dashboard and displays them in a compact table. Useful for tracking agent tool calls and session state. CX Codex +1 ★ 1,198repo stars errors errors pulls recent APIError events from the local Agent Monitor dashboard and prints one line per failure: time, session, short summary. CX Codex +1 ★ 1,198repo stars cost-today cost-today fetches total token spending and single-line per-model expenses from Agent Monitor. CX Codex +1 ★ 1,198repo stars inventory The inventory command reports counts for skills, agents, commands, MCP servers, and hooks in a compact block. Use it to inspect the user and project split in a Claude Code setup. CX Codex +1 ★ 1,198repo stars dag dag prints the parent-to-child subagent edges for one session, pulled from the local dashboard at http://localhost:4820. CX Codex +1 ★ 1,198repo stars

Project sponsors

Companies that keep this analytics open