Update Ignored Endpoints
This skill updates the IGNORED_ENDPOINTS.md file by analyzing which API endpoints are intentionally not implemented as MCP tools. It auto-discovers all generated API client files to support projects with multiple Orval configurations.
When to Use
Use this skill when:
- User asks to update the ignored endpoints documentation
- User wants to verify which endpoints are not implemented
- User needs to refresh the endpoint coverage analysis
- Changes have been made to tool implementations and documentation needs updating
Instructions
- Run the update script from the consumer project root:
npx tsx ${CLAUDE_PLUGIN_ROOT}/skills/update-ignored-endpoints/scripts/update-ignored-endpoints.ts
Review the changes to
docs/analysis/IGNORED_ENDPOINTS.mdThe script will:
- Auto-discover all
*.tsfiles insrc/umbraco-api/api/generated/(excluding*.zod.tsandexampleApi.ts) - Extract all API endpoint names from Result type exports
- Compare against implemented MCP tools (files with
ToolDefinition+withStandardDecorators) - Categorize ignored endpoints using collection names from
.discover.json(falls back to "Uncategorized" if no manifest exists) - Update the documentation with current ignored endpoints
- Preserve the rationale sections
- Update the total count and coverage percentage
- Auto-discover all
Environment Variables
| Variable | Description | Default |
|---|---|---|
PROJECT_ROOT |
Root of the consumer project | . |
TOOLS_DIR |
Path to the tools directory (relative to PROJECT_ROOT) | src/umbraco-api/tools |
OUTPUT_FILE |
Path for the output markdown file (relative to PROJECT_ROOT) | docs/analysis/IGNORED_ENDPOINTS.md |
API_GENERATED_DIR |
Path to generated API client files (relative to PROJECT_ROOT) | src/umbraco-api/api/generated |
Supporting Files
The update script is at scripts/update-ignored-endpoints.ts and analyzes all generated API client files and existing MCP tools to generate updated documentation.