grepai-mcp-toolslisted
Install: claude install-skill NNIIKKKKII/grepai-skills
# GrepAI MCP Tools Reference
This skill provides a complete reference for all tools available through GrepAI's MCP server.
## When to Use This Skill
- Understanding available MCP tools
- Learning tool parameters and options
- Integrating GrepAI with AI assistants
- Debugging MCP tool usage
## Starting the MCP Server
```bash
grepai mcp-serve
```
The server exposes tools via the Model Context Protocol.
## Available Tools
### 1. grepai_search
Semantic code search using embeddings.
#### Parameters
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `query` | string | Yes | - | Search query describing what to find |
| `limit` | number | No | 10 | Maximum results to return |
| `compact` | boolean | No | false | Return compact output (no content) |
| `format` | string | No | "json" | Output format: "json" or "toon" (v0.26.0+) |
#### Example Request
```json
{
"tool": "grepai_search",
"parameters": {
"query": "user authentication middleware",
"limit": 5,
"compact": true,
"format": "toon"
}
}
```
#### Response (Compact)
```json
{
"q": "user authentication middleware",
"r": [
{"s": 0.92, "f": "src/auth/middleware.go", "l": "15-45"},
{"s": 0.85, "f": "src/auth/jwt.go", "l": "23-55"},
{"s": 0.78, "f": "src/handlers/auth.go", "l": "10-40"}
],
"t": 3
}
```
#### Response (Full)
```json
{
"query": "user authentication middleware",
"results": [
{
"score": 0.92,