create-tool

Create Tool

Scaffold all files for a new MCP tool following project conventions.

Workflow

1. Gather requirements

Ask the user:

• Tool name (snake_case, e.g., get_dependency_graph)
• Description (one sentence, used in MCP tool listing)
• Input parameters (name, type, required/optional, description)
• Output shape (what the result looks like)

2. Reference existing patterns

Read docs/patterns.md for tool registration, error handling, and testing patterns. Also read an existing tool in src/tools/ as a concrete example.

3. Create files

1. Types: src/types/[concern].ts (named by domain, e.g. complexity.ts, thresholds.ts), export from src/types/index.ts
2. Implementation: src/tools/[toolName].ts following the registration pattern
3. Tests: src/tools/[toolName].test.ts using getToolHandler/parseContent from src/testUtils/toolTestHarness.ts
4. Registration: add the import and register*Tool(server) call in createServer() in src/server.ts, and add the tool name to EXPECTED_TOOLS in src/server.test.ts

4. Update documentation

• Add the tool to the quick reference table in TOOLS.md
• Add detailed docs to the appropriate docs/tools-*.md file
• Add the tool to the list in README.md, and bump the tool count there and in docs/tools-overview.md (both currently say 8)

5. Verify

npm run check       # check:versions + lint:fix + typecheck
npm run test        # all tests pass

Use check_thresholds to verify the new files are within size limits.