Loading...
Loading...
Design effective MCP tools and Claude Code integrations using the consolidation principle. Fewer, better-designed tools dramatically improve agent success rates. Use when creating MCP servers, designing tool interfaces, optimizing tool sets, or when user mentions 'tool design', 'MCP', 'fewer tools', 'tool consolidation', 'tool architecture', or 'tool optimization'.
npx skill4agent add greyhaven-ai/claude-code-config grey-haven-tool-design| Tool Count | Expected Success | Example |
|---|---|---|
| 1-3 | 95-100% | Vercel d0 (2 tools) |
| 4-7 | 85-95% | Focused agent |
| 8-15 | 70-85% | General assistant |
| 15+ | <70% | Kitchen sink |
examples/reference/checklists/create_file, read_file, update_file, delete_file,
list_directory, search_files, get_file_info,
create_folder, rename_file, move_file, copy_file,
get_permissions, set_permissions, watch_file,
compress_file, decompress_file, calculate_hashfile_operation(action, path, content?, options?)
directory_operation(action, path, options?)search_code(query: string)
search_files(pattern: string)
search_in_file(file: string, query: string)
search_directory(dir: string, query: string)
search_with_regex(regex: string)search(options: {
query: string
type: 'code' | 'files' | 'content'
path?: string
regex?: boolean
})mcp__firecrawl__search // External MCP
mcp__linear__create_issue // External MCP
search // Claude Code native| Use Tool When | Use Agent When |
|---|---|
| Single operation | Multi-step workflow |
| Deterministic result | Judgment required |
| Fast execution (<1s) | Complex reasoning |
| Simple I/O | Context accumulation |
| Server | Tools | Purpose |
|---|---|---|
| firecrawl | 5 | Web scraping, search |
| linear | 12 | Issue/project management |
| playwright | 15 | Browser automation |
| context7 | 2 | Documentation lookup |
| filesystem | 10 | File operations |
// Instead of exposing all 15 playwright tools
// Create 3 workflow-level tools:
browser_navigate(url, options?) // Navigate + wait
browser_interact(selector, action) // Click/type/select
browser_extract(selector, format) // Screenshot/text/htmlgetUserfetch_projectlistTeamsSEARCH_ISSUESverb_nounget_userlist_projectsapi-design-standardsllm-project-developmentcontext-management# Audit your tool set
cat checklists/tool-audit-checklist.md
# Learn consolidation patterns
cat reference/consolidation-guide.md
# See real examples
cat examples/mcp-consolidation-examples.md