MCP Token-Efficient Tools

KB Efficiency Tools (5)

Code Analysis Tools (7)

Tool Specifications

kb_headlines

{ "directory?": "mechanics", "tag?": "combat", "limit": 50 }
// Returns: { count, files: [{ path, title }] }

kb_section

{ "file_path": "mechanics/combat.md", "heading": "Damage" }
// Returns: Extracted section content

summarize_kb_file

{ "file_path": "mechanics/combat.md", "preview_chars": 500 }
// Returns: { title, path, preview, headings[], total_chars }

batch_search_kb

{ "queries": ["combat", "skills"], "limit_per_query": 3 }
// Returns: { "combat": [results], "skills": [results] }

kb_file_stats

{ "file_path": "mechanics/combat.md" }
// Returns: { words, headings, links, code_blocks, tags, frontmatter_keys }

rust_module_outline

{ "file_path": "/path/to/file.rs", "include_private": false }
// Returns: pub structs, enums, fns with signatures (no bodies)

rust_crate_structure

{ "crate_path": "/path/to/crate" }
// Returns: { crate, entry, modules[] }

rust_impl_summary

{ "type_name": "Player", "scope": "/path/to/src" }
// Returns: All impl blocks for type (grep output)

find_type_usages

{ "type_name": "Player", "scope": "/path/to/src", "limit": 30 }
// Returns: { type, usages, locations: ["file:line"] }

get_function_signature

{ "function_name": "calculate_damage", "file_path": "/path/to/file.rs" }
// Returns: Just the fn signature, no body

list_cargo_deps

{ "crate_path": "/path/to/crate" }
// Returns: [dependencies] section from Cargo.toml

find_trait_impls

{ "trait_name": "Display", "scope": "/path/to/src" }
// Returns: { trait, implementations: [{ location, impl }] }

Bonus: Agent Context Tool

get_agent_rules

{ "include_coding_standards": false, "include_workflows": true }
// Returns: { agent_instructions[], rust_standards?, nodejs_standards?, available_workflows[] }

Usage Pattern

read_kb_file → full 5000 char file
read_kb_file → full 3000 char file
grep for type → full lines

batch_search_kb → compact results
kb_section → only needed section
find_type_usages → file:line pairs only

Implementation

• Source: role_efficiency.ts
• Tests: role_efficiency.test.ts