count-mcp-tools

umbraco's avatarfrom umbraco

Count the total number of MCP tools in the Umbraco MCP Server project and provide a breakdown by collection. Use when the user asks about tool counts, tool statistics, or how many tools exist.

⭐22stars🔀1forks📁View on GitHub🕐Updated Dec 19, 2025⬇️2downloads

When & Why to Use This Skill

This Claude skill automates the auditing and analysis of MCP (Model Context Protocol) tools within the Umbraco MCP Server project. It provides developers with real-time statistics, including total tool counts and detailed breakdowns by collection, facilitating better project management, architectural oversight, and documentation accuracy.

Use Cases

  • Project Auditing: Quickly assess the scale and functional coverage of the Umbraco MCP Server by generating a complete breakdown of all registered tools.
  • Documentation Automation: Automatically generate and update markdown reports (e.g., api-endpoints-analysis.md) to keep project documentation in sync with the codebase.
  • Development Tracking: Monitor the growth and distribution of tools across different collections during the development lifecycle to ensure architectural consistency.
  • Developer Onboarding: Help new contributors understand the project structure by providing a clear list of tool names and their respective functional groupings.
namecount-mcp-tools
descriptionCount the total number of MCP tools in the Umbraco MCP Server project and provide a breakdown by collection. Use when the user asks about tool counts, tool statistics, or how many tools exist.

Count MCP Tools

This skill counts all MCP tools in the project and provides a detailed breakdown by collection.

When to Use

Use this skill when:

  • User asks "how many tools do we have?"
  • User wants statistics about tool collections
  • User needs to know tool distribution across collections
  • User asks about project size or coverage

Instructions

  1. Run the counting script from the project root:
TOOLS_DIR=src/umb-management-api/tools OUTPUT_FILE=docs/analysis/api-endpoints-analysis.md npx ts-node .claude/skills/count-mcp-tools/scripts/count-tools.ts

Or without saving to file:

TOOLS_DIR=src/umb-management-api/tools npx ts-node .claude/skills/count-mcp-tools/scripts/count-tools.ts

To also show all tool names in the console output:

TOOLS_DIR=src/umb-management-api/tools SHOW_TOOLS=true npx ts-node .claude/skills/count-mcp-tools/scripts/count-tools.ts
  1. Present results showing:
    • Total tool count
    • Breakdown by collection (sorted alphabetically)
    • List of individual tool names per collection (when SHOW_TOOLS=true or in markdown output)
    • Highlight the largest collections (top 5-8)
    • If OUTPUT_FILE is set, saves to markdown file with full tool listing

Environment Variables

Variable Description
TOOLS_DIR Path to the tools directory (default: .)
OUTPUT_FILE Optional path to save markdown analysis report
SHOW_TOOLS Set to true to show individual tool names in console output

Supporting Files

The counting script is available at scripts/count-tools.ts and counts TypeScript files that define actual MCP tools (containing CreateUmbracoTool or CreateUmbracoResource), excluding index.ts, test files, and helper/utility files.