Mcp check
Validate MCP configuration and suggest improvements. Use when MCP servers fail to load, after editing .mcp.json, or when the user runs /mcp-check.From its SKILL.md
npx -y skills add claude-world/director-mode-lite --skill mcp-checkAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- reads credentialsReads from 3 credential sources: `.mcp.json` and 2 more.
- runs commandsInstructs the agent to run 1 command, including `claude mcp reset-project-choices`.
SKILL.md
2.1 KB, 492 tokens by cl100k_base, as published. Nobody here has run it
MCP Configuration Validator
Validate the project's MCP setup for correctness and completeness.
Validation Steps
1. Check Configuration Files
| File | Scope | What lives here |
|---|---|---|
.mcp.json (project root) | Project | mcpServers — the server definitions, written by claude mcp add --scope project |
.claude/settings.json | Project | Toggles only: enableAllProjectMcpServers, enabledMcpjsonServers |
~/.claude.json | User | User-scope mcpServers, available across all projects |
The source of truth for project servers is .mcp.json at the project root. Read mcpServers from there — .claude/settings.json never holds server definitions, only approval toggles.
2. Validate Structure
-
.mcp.jsonis valid JSON (no trailing commas) -
mcpServersobject exists in.mcp.json - Project servers are approved via
.claude/settings.json: eitherenableAllProjectMcpServers: true, or each server named inenabledMcpjsonServers
3. Validate Each MCP
-
commandis valid -
argsproperly formatted -
envvariables set
4. Check Essential MCPs
| MCP | Required? |
|---|---|
| memory | Recommended |
| filesystem | Optional |
| github | If .git exists |
5. Security Check
- No hardcoded secrets
- Sensitive values use env vars
Output Format
## MCP Configuration Report
### Status: VALID / ISSUES / INVALID
### Configuration Summary
| MCP Server | Status | Notes |
|------------|--------|-------|
| memory | OK/FAIL | details |
### Issues Found
1. [Issue and fix]
### Missing Recommended MCPs
- memory: `claude mcp add --scope project memory...`
Common Issues
| Issue | Fix |
|---|---|
| Invalid JSON | Check trailing commas |
| MCP not loading | claude mcp reset-project-choices |
| Missing env vars | Add with -e KEY=value |
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.
Gives 0 of the 12 instructions most quality gates skills give in 492 tokens
Counted across 1,524 of the 2,830 authors here whose files we hold, read 2026-09-06
- Read full output and check exit codein 45 of 1524, across 40 files
- Verify output confirms the claimin 44 of 1524, across 39 files
- Identify the command that proves the claimin 43 of 1524, across 39 files
- Execute the full verification commandin 36 of 1524, across 30 files
- Produce a verification reportin 34 of 1524, across 18 files
- Review git diff changesin 30 of 1524, across 16 files
- Fix build failures immediatelyin 29 of 1524, across 9 files
- Group findings by severityin 28 of 1524
- State claim only with evidencein 27 of 1524, across 22 files
- Verify regression tests with red-green cyclein 26 of 1524, across 22 files
- Run the full test suitein 26 of 1524, across 25 files
- Run test suite with coveragein 25 of 1524, across 10 files
Said here and by no other author read
- Read mcpServers from the project root
- Ensure mcpServers object exists
- Check server approval in settings.json
- Validate command and args for each server
- Suggest missing recommended MCP servers
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.