warp-grep
Parallel code search with Warp-Grep MCP. Use for codebase discovery, understanding how things work, data flow analysis, or when the user asks "how does X work" about the codebase.
When & Why to Use This Skill
Warp-Grep is a high-performance MCP server designed for parallel codebase discovery and deep architectural analysis. It significantly enhances Claude's ability to navigate large repositories by executing up to 8 concurrent searches per turn, allowing developers to trace complex data flows, understand module interactions, and uncover system logic with high efficiency.
Use Cases
- Codebase Discovery: Rapidly map out and understand unfamiliar or legacy repositories by asking high-level architectural questions.
- Data Flow Analysis: Trace how information moves across multiple files and modules to identify hidden dependencies and state changes.
- Architectural Understanding: Explain complex system logic, such as authentication flows or API request handling, using contextual code snippets.
- Cross-cutting Concerns: Efficiently locate and analyze patterns that span the entire codebase, such as error handling, logging, or security implementations.
| name | warp-grep |
|---|---|
| description | Parallel code search with Warp-Grep MCP. Use for codebase discovery, understanding how things work, data flow analysis, or when the user asks "how does X work" about the codebase. |
Warp-Grep (MCP Server)
Parallel codebase search. Runs 8 searches per turn for efficient discovery.
When This Applies
| Signal | Action |
|---|---|
| "How does X work?" | Use Warp-Grep |
| Data flow across files | Use Warp-Grep |
| Cross-cutting concerns | Use Warp-Grep |
| Understanding architecture | Use Warp-Grep |
How It Works
Warp-Grep is an MCP tool that activates automatically for natural language code questions. It:
- Interprets your question
- Runs up to 8 parallel searches
- Returns relevant code snippets with context
When to Use Warp-Grep
| Use Case | Use Warp-Grep? |
|---|---|
| "How does authentication work?" | YES |
| Data flow analysis | YES |
| Understanding module interactions | YES |
| Finding all usages of a pattern | YES |
When NOT to Use Warp-Grep
| Use Case | Use Instead |
|---|---|
| Known function name | rg (ripgrep) or Grep tool |
| Known exact file | Just open it with Read |
| Simple existence check | Glob or rg |
| Single specific search | Grep tool |
Query Tips
Good queries:
- "How does the payment processing flow work?"
- "Where are user sessions managed?"
- "How is error handling done in the API layer?"
- "What happens when a request comes in?"
Less effective:
- "Find function X" → Use
rgor Grep instead - "Open file Y" → Use Read tool
Integration with Other Tools
| Need | Tool |
|---|---|
| Codebase discovery | Warp-Grep |
| Specific pattern search | Grep / rg |
| Past session content | CASS |
| Current documentation | Exa |
| Task graph | bv |
Requirements
Requires Morph API key configured:
claude mcp add morph-fast-tools -s user \
-e MORPH_API_KEY=your-key \
-e ALL_TOOLS=true \
-- npx -y @morphllm/morphmcp
See Also
external-docs/— Grounding with web sources via Exacass-search/— Past session search