grepai-mcp-tools

Documents GrepAI MCP server tools for semantic code search and call tracing.

Updated May 12, 2026
One-click install
npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-mcp-tools-eduardtomasek
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grepai-mcp-tools
Source: https://github.com/eduardtomasek/codex-dev-stack/tree/main/skills/.agents/grepai-mcp-tools
Command: npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill grepai-mcp-tools-eduardtomasek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI assistants integrating with GrepAI's MCP server need accurate knowledge of each tool's parameters, response formats, and error codes to call them correctly and parse results without trial and error. ## Core Features & Use Cases - Complete Tool Reference: Documents all five MCP tools (grepai_search, grepai_trace_callers, grepai_trace_callees, grepai_trace_graph, grepai_index_status) with parameter tables and JSON examples. - Compact Mode Guidance: Explains abbreviated response keys and token savings of roughly 80% when using compact output. - Error Handling Reference: Lists error codes such as INDEX_NOT_FOUND, EMBEDDER_UNAVAILABLE, and SYMBOL_NOT_FOUND with example payloads. - Use Case: An AI coding assistant needs to find callers of a Login function; this reference tells it to call grepai_trace_callers with the symbol parameter and how to interpret the compact response. ## Quick Start Ask the assistant to explain which GrepAI MCP tool and parameters to use for tracing all callers of a specific function in your codebase.

Frequently Asked Questions about grepai-mcp-tools

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use GrepAI MCP tools for semantic code search?▼

Call grepai_search with a query string describing what to find, plus optional limit and compact parameters. Start the server with grepai mcp-serve, then send JSON-RPC tools/call requests with the tool name and arguments.

How to trace function callers and callees with GrepAI?▼

Use grepai_trace_callers to find functions calling a symbol and grepai_trace_callees for functions it calls. Pass the symbol name as a required parameter; grepai_trace_graph builds a full call graph with configurable depth.

What is compact mode in GrepAI MCP responses?▼

Compact mode uses abbreviated keys like q, r, f, and l instead of full field names, reducing token usage by roughly 80 percent. Enable it by setting the compact parameter to true on search and trace tools.

Why does GrepAI return INDEX_NOT_FOUND error?▼

The INDEX_NOT_FOUND error means no code index exists for the project yet. Run grepai watch first to build the index, and verify health with grepai_index_status before issuing searches.

Does GrepAI MCP require Ollama to be running?▼

Yes, when using the default Ollama embedder, the embedding provider must be reachable or tools return EMBEDDER_UNAVAILABLE. Check the embedder connection status with grepai_index_status before searching.