Skip to main content
skill CX Codex

mcp-maintainer — Claude Code skill: MCP server maintenance

The mcp-maintainer skill guides maintenance of the repository’s local MCP server, from checking its API to validating tool changes. Use it when updating MCP tools or investigating runtime issues.

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-maintainer -a claude-code
Open on GitHub

What mcp-maintainer does

The skill lays out a workflow for the local MCP server. Check the dashboard API at /api/health, then inspect the relevant modules under mcp/src/tools/domains/. Changes to safety checks belong alongside the existing guards in mcp/src/policy/tool-guards.ts.

Run npm run mcp:typecheck and npm run mcp:build to validate changes. The skill also points to a tool-domain map and an operations runbook: references/tool-domain-map.md and references/operations-runbook.md.

Keep target checks restricted to loopback, and require explicit flags for tools that mutate or destroy data. Protocol data must stay out of stdout. Removing that boundary can expose data through the server’s output.

What it helps with

  • check whether the MCP dashboard API responds
  • locate the domain module behind a tool
  • preserve guards while changing policy checks
  • type-check and build the MCP server

Example prompts for the agent

  • Check the dashboard API at /api/health and locate the affected tool module.
  • Update the guard in mcp/src/policy/tool-guards.ts while retaining loopback-only target checks.
  • Run npm run mcp:typecheck and npm run mcp:build after the changes.

How to install mcp-maintainer

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about mcp-maintainer

How do I install mcp-maintainer in Claude Code?

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

What does mcp-maintainer do?

It provides a workflow for maintaining this repository’s local MCP server: checking the dashboard API, inspecting tool modules and validating changes.

What safety checks does the skill cover?

Target checks must remain loopback-only, while mutating and destructive tools require explicit flags. Protocol data must not be written to stdout.

Source text

SKILL.md · MIT
---
name: mcp-maintainer
description: Operate and maintain the local MCP server for this repository. Use for MCP tool updates, policy-guard changes, host configuration, and MCP runtime troubleshooting.
---

# MCP Maintainer Skill

## Workflow
- Confirm dashboard API availability (`/api/health`).
- Inspect affected MCP domain modules under `mcp/src/tools/domains/`.
- Preserve safety gates in `mcp/src/policy/tool-guards.ts`.
- Validate with `npm run mcp:typecheck` and `npm run mcp:build`.

## Safety rules
- Keep loopback-only target checks enabled.
- Keep mutating and destructive tools behind explicit flags.
- Do not log protocol data to stdout.

## References
- `references/tool-domain-map.md`
- `references/operations-runbook.md`

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

Similar skills

SKILL.md skills catalog →

From the same set155

The whole set →
backend-node backend-node is a Claude Code rule for Node.js backend files and hook ingestion logic. It keeps API responses compatible and enforces database transaction safety. CX Codex +1 ★ 1,198repo stars report report is a Claude Code command that creates CCAM executive, cost, reliability, or workflow reports. Specify a report type and data scope in the request. CX Codex +1 ★ 1,198repo stars release-guard release-guard is a Claude Code skill that checks a repository before merge or release, comparing documented commands with package.json and architecture notes with current code paths. CX Codex +1 ★ 1,198repo stars repo-onboarding repo-onboarding guides AI coding agents through codebase architecture, layer selection, and test command discovery before editing. CX Codex +1 ★ 1,198repo stars file-headers file-headers makes each source file open with a short, honest overview plus the exact line @author Son Nguyen <[email protected]>. CX Codex +1 ★ 1,198repo stars status Polls the local Claude Code Agent Monitor dashboard to print health status and session counts in a single line. CX Codex +1 ★ 1,198repo stars open-dashboard open-dashboard prints the Agent Monitor address and the commands to start or open it. Use it when you need the local dashboard instructions. CX Codex +1 ★ 1,198repo stars report-analyst report-analyst builds executive, cost, reliability and workflow reports from a local CCAM API, keeping units, scope and data freshness intact. Handy when a stakeholder summary has to hold up to scrutiny. CX Codex ★ 1,198repo stars

Project sponsors

Companies that keep this analytics open