parecode — Claude Code MCP server: search and setup
An MCP server for token-aware code search and atomic edits across multiple files. It helps agents inspect large repositories with bounded context.
claude mcp add parecode -- npx -y parecodeWhat parecode does
parecode exposes ParecodeSearch, ParecodeExpand, and ParecodeEdit to an MCP client. Search runs through ripgrep, returns matches with nearby lines, and reports estimated token use. When a result is clipped, the agent can request a wider range instead of loading the whole file.
ParecodeEdit batches changes across files, checks file stats before and after an edit, and writes same-directory renames atomically. Multiple related patterns can be searched in parallel. The server also keeps a local JSONL session log through parecode stats; runtime network calls are not used.
Node.js 20 or newer and ripgrep on PATH are required. parecode shells out to the system binary, so searches fail when ripgrep is missing from PATH.
What it helps with
- trace every use of a symbol with nearby context
- widen a located code range without reading the whole file
- apply one atomic change across several files
- search related patterns in a single request
- inspect estimated token savings from local session logs
Example prompts for the agent
- Use
ParecodeSearchto find every call tocreateUserand include nearby context. - Use
ParecodeExpandonsrc/users.tsfor the range around lines 40–65. - Replace
oldApiwithnewApiacross all matching files usingParecodeEdit.
How to install parecode
Platform CLI
claude mcp add parecode -- npx -y parecodePlatform CLI
codex mcp add parecode -- npx -y parecodeConfig file
{
"mcpServers": {
"parecode": {
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Config file
{
"servers": {
"parecode": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"parecode"
]
}
}
}Platform CLI
gemini mcp add parecode npx -y parecodeStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about parecode
How do I install parecode in Claude Code?
Run claude mcp add parecode -- npx -y parecode. Node.js 20 or newer and ripgrep on PATH are required.
What does parecode do?
It gives coding agents bounded code search plus atomic multi-file editing. ParecodeSearch and ParecodeExpand control how much code is loaded, while ParecodeEdit applies batched changes.
What does parecode require to run?
You need Node.js 20 or newer, ripgrep on PATH, and an MCP client. The server uses the system ripgrep binary rather than bundling its own.
