grepai-mcp-claude

grepai-mcp-claude is a skill for Claude Code from yoanbernabeu/grepai-skills. It costs 31 tokens per session (1,745 once invoked), scanned A, original, MIT.

A setup guide for connecting GrepAI’s semantic code search to Claude Code through MCP, a standard way for assistants to use external tools.

In plain words
What is it for?
Installing and configuring the GrepAI MCP server, checking prerequisites, and troubleshooting the connection.
Why use it?
It lets Claude Code search an indexed project by meaning and inspect related code relationships instead of relying only on exact text matches.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: reads .claude/ paths; mentions Claude Code.

Part of the grepai-integration plugin — 3 skills shipped together , and of grepai-complete

Good fit Installing and configuring the GrepAI MCP server, checking prerequisites, and troubleshooting the connection.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/yoanbernabeu/grepai-skills/grepai-mcp-claude
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add yoanbernabeu/grepai-skills --skill grepai-mcp-claude
Clone the repo
git clone --depth 1 https://github.com/yoanbernabeu/grepai-skills

Made for: Claude Code.

Or install grepai-integration, the plugin that ships this one along with the rest of its 3 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for grepai-mcp-claude

README.md
[![agentmods](https://agentmods.dev/badge/skills/yoanbernabeu/grepai-skills/grepai-mcp-claude/github.svg)](https://agentmods.dev/skills/yoanbernabeu/grepai-skills/grepai-mcp-claude)
Your own site
<a href="https://agentmods.dev/skills/yoanbernabeu/grepai-skills/grepai-mcp-claude"><img src="https://agentmods.dev/badge/skills/yoanbernabeu/grepai-skills/grepai-mcp-claude/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for grepai-mcp-claude

Your own site · 80×15
<a href="https://agentmods.dev/skills/yoanbernabeu/grepai-skills/grepai-mcp-claude"><img src="https://agentmods.dev/badge/skills/yoanbernabeu/grepai-skills/grepai-mcp-claude.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,745 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • Socket pass 18 Mar 2026
  • Snyk pass 15 Feb 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00031 $0.01745
Opus 5 $0.00015 $0.00873
Sonnet 5 $0.00006 $0.00349
Haiku 4.5 $0.00003 $0.00175

Measured 12d ago against content hash d7fb4a3f4fae, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

grepai-mcp-claude scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

1. Check Ollama is running: `curl http://localhost:11434/api/tags`
skills/integration/grepai-mcp-claude/SKILL.md · 329 lines

How it starts

The opening of the file, as written. The whole thing — 329 lines — stays where its author put it; the contents beside it link to each section on GitHub.

GrepAI MCP Integration with Claude Code

This skill covers integrating GrepAI with Claude Code using the Model Context Protocol (MCP).

When to Use This Skill

  • Setting up GrepAI in Claude Code
  • Enabling semantic search for AI coding assistant
  • Configuring MCP server for Claude
  • Troubleshooting Claude Code integration

What is MCP?

Model Context Protocol (MCP) allows AI assistants to use external tools. GrepAI provides an MCP server that gives Claude Code:

  • Semantic code search
  • Call graph analysis
  • Index status monitoring

Prerequisites

  1. GrepAI installed
  2. Ollama running (or other embedding provider)
  3. Project indexed (grepai watch)
  4. Claude Code installed

Quick Setup

One command to add GrepAI to Claude Code:

claude mcp add grepai -- grepai mcp-serve

That's it! Claude Code can now use GrepAI tools.

Manual Configuration

If you prefer manual setup, add to Claude Code's MCP config:

Location

  • macOS/Linux: ~/.claude/mcp.json
  • Windows: %APPDATA%\Claude\mcp.json

Configuration

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"]
    }
  }
}

With Working Directory

If you want GrepAI to always use a specific project:

{
  "mcpServers": {
    "grepai": {
      "command": "grepai",
      "args": ["mcp-serve"],
      "cwd": "/path/to/your/project"
    }
  }
}

Verifying Installation

Check MCP Server

# Start MCP server manually to test
grepai mcp-serve

You should see:

GrepAI MCP Server started
Listening for requests...

In Claude Code

Ask Claude:

"Search the codebase for authentication code"

Claude should use the grepai_search tool.

Available Tools

Once connected, Claude Code has access to these tools:

Tool Description Parameters
grepai_search Semantic code search query (required), limit, compact
grepai_trace_callers Find function callers symbol (required), compact
grepai_trace_callees Find function callees symbol (required), compact
grepai_trace_graph Build call graph symbol (required), depth
grepai_index_status Check index health verbose (optional)

Read the full file on GitHub · 329 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 329 lines · 31 tokens per session scan A d7fb4a3f4fae

Subscribe to this mod's changes

grepai-mcp-claude is a skill published in the GitHub repository yoanbernabeu/grepai-skills (20 stars, last pushed 7mo ago), licensed MIT. It adds 31 tokens to every session and 1,745 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

codebase-search

Semantic code and documentation search by meaning. Use codebasepeek to find WHERE code is (saves tokens), codebasesearch to see actual code. For exact identifiers, use grep instead. Search local codebase before using websearch for code/library/API/example questions.

Helweg/open-codebase-index · 58 tokens

qdrant-advisor

Diagnose, troubleshoot, and advise on any Qdrant deployment by loading the latest official Qdrant skills live from skills.qdrant.tech. Use this whenever someone raises a Qdrant problem or question — slow or degraded search, high or growing memory / OOM crashes, optimizer stuck or slow, indexing slowness, scaling and…

qdrant/skills · 216 tokens

qdrant-search-quality-diagnosis

Diagnoses Qdrant search quality issues. Use when someone reports 'results are bad', 'wrong results', 'not relevant results', 'missing matches', 'recall is low', 'approximate search worse than exact', 'which embedding model', 'quality dropped after quantization', 'how to measure retrieval quality', 'build a golden…

qdrant/skills · 104 tokens

qdrant-monitoring-debugging

Diagnoses Qdrant production issues using metrics and observability tools. Use when someone reports 'optimizer stuck', 'indexing too slow', 'memory too high', 'OOM crash', 'queries are slow', 'latency spike', or 'search was fast now it's slow'. Also use when performance degrades without obvious config changes.

qdrant/skills · 75 tokens

codebase-search

Preferred local codebase-understanding workflow for Pi and Codex. Start with codebasecontext before shell search or broad reads, then use specialized semantic and graph tools.

Helweg/open-codebase-index · 37 tokens

cocosearch-debugging

Use when debugging an error, unexpected behavior, or tracing how code flows through a system. Guides root cause analysis using CocoSearch semantic and symbol search.

VioletCranberry/coco-search · 37 tokens