Bug: CLAUDE.md references nonexistent mcp-categories.json file

Author: zaziszazCreated Jul 19, 2026Updated Jul 19, 2026

Problem

CLAUDE.md line 42 references a file that does not exist in the repository:

markdown
- `mcp-categories.json`: Canonical MCP category definitions shared across plugins

This is a dead link in documentation — users following setup instructions or reading the project structure will look for this file and not find it.

Current State

File: CLAUDE.md line 42

Reference: mcp-categories.json: Canonical MCP category definitions shared across plugins

Actual status: File does not exist anywhere in the repo

bash
$ find . -name 'mcp-categories.json' 2>/dev/null
# (no output)

Resolution Options

  1. Create the file — If intended as a real deliverable for MCP organization and plugin configuration
  2. Remove the reference — If this was a planned but abandoned feature

If creating the file, see issue #298 for proposed schema (standardized MCP metadata with categories, auth, required/optional flags, and skill bindings).

Impact

  • Documentation is misleading
  • Users waste time looking for a nonexistent file
  • Undermines project credibility (broken promises in readme)

Source: anthropics/financial-services