---

name: mcp-tool-selection description: Decision rules for when to use MCP Qdrant-Indexer semantic search vs grep/literal file tools. Use this skill when starting exploration, debugging, or answering "where/why" questions about code.

MCP Tool Selection Rules

Core principle: MCP Qdrant-Indexer tools are primary for exploring code and history. Start with MCP for exploration, debugging, or "where/why" questions; use literal search/file-open only for narrow exact-literal lookups.

Use MCP Qdrant-Indexer When

• Exploring or don't know exact strings/symbols
• Need semantic or cross-file understanding (relationships, patterns, architecture)
• Want ranked results with surrounding context, not just line hits
• Asking conceptual/architectural or "where/why" behavior questions
• Need rich context/snippets around matches

Use Literal Search/File-Open Only When

• Know exact string/function/variable or error message
• Only need to confirm existence or file/line quickly (not to understand behavior)

Grep Anti-Patterns (DON'T)

Copygrep -r "auth" .        # → Use MCP: "authentication mechanisms"
grep -r "cache" .       # → Use MCP: "caching strategies"  
grep -r "error" .       # → Use MCP: "error handling patterns"
grep -r "database" .    # → Use MCP: "database operations"

Literal Search Patterns (DO)

Copygrep -rn "UserAlreadyExists" .      # Specific error class
grep -rn "def authenticate_user" .  # Exact function name
grep -rn "REDIS_HOST" .             # Exact environment variable

Quick Decision Heuristic

If in doubt → start with MCP