
XERJ
Local search engine for AI agents with cited answers over your code and docs
The repository was last updated 7 hours ago and is published under Apache-2.0.
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- GitHub stars
- 19.2K
- Last commit
- today
- Language
- Rust
About XERJ
XERJ is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
XERJ is a local search engine built for AI agents, shipped as a single Rust binary. It combines search, vectors, facts, memory and an Elasticsearch-compatible API, and runs offline on a CPU.
Its XERJ Query-1 model turns a question into a short program that the engine runs over stored facts, returning the answer with evidence. With no supporting fact it answers UNKNOWN. The MCP server connects an agent to a running XERJ node, and can index open-source repos so agents read real definitions.
It suits developers whose agents need code and docs search, and teams that keep data inside their network.
Install
Run in a terminal
claude mcp add xerj --env XERJ_AUTH='<XERJ_AUTH>' -- npx -y https://github.com/xerj-org/xerj/releases/download/mcpb-v1.0.0-rc.99/xerj-mcp-1.0.0-rc.99.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"xerj": {
"command": "npx",
"args": [
"-y",
"https://github.com/xerj-org/xerj/releases/download/mcpb-v1.0.0-rc.99/xerj-mcp-1.0.0-rc.99.mcpb"
],
"env": {
"XERJ_AUTH": "<XERJ_AUTH>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"xerj": {
"command": "npx",
"args": [
"-y",
"https://github.com/xerj-org/xerj/releases/download/mcpb-v1.0.0-rc.99/xerj-mcp-1.0.0-rc.99.mcpb"
],
"env": {
"XERJ_AUTH": "<XERJ_AUTH>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"xerj": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/xerj-org/xerj/releases/download/mcpb-v1.0.0-rc.99/xerj-mcp-1.0.0-rc.99.mcpb"
],
"env": {
"XERJ_AUTH": "<XERJ_AUTH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"xerj": {
"command": "npx",
"args": [
"-y",
"https://github.com/xerj-org/xerj/releases/download/mcpb-v1.0.0-rc.99/xerj-mcp-1.0.0-rc.99.mcpb"
],
"env": {
"XERJ_AUTH": "<XERJ_AUTH>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"xerj": {
"command": "npx",
"args": [
"-y",
"https://github.com/xerj-org/xerj/releases/download/mcpb-v1.0.0-rc.99/xerj-mcp-1.0.0-rc.99.mcpb"
],
"env": {
"XERJ_AUTH": "<XERJ_AUTH>"
}
}
}
}Configuration
XERJ_URLES-compatible listener of a running XERJ node (start one with `xerj --insecure --data-dir ~/xerj-data`).XERJ_AUTHAuthorization header for a node with auth on, e.g. 'ApiKey <key>'. Optional for a loopback node: the key is read from <data-dir>/admin.key.
What it does
- Single binary
- Search, vectors, facts and memory in one Rust program.
- Evidence-backed answers
- Answers come with the program and evidence used.
- Runs locally
- Works offline on a CPU, on a laptop or server.
- Elasticsearch-compatible API
- Exposes an API compatible with Elasticsearch.
- Reference coding
- Index open-source repos so agents consult real definitions.
- MCP integration
- Stdio MCP server connects to a running node.
Good for
- Search local code and docs from an agent
- Give an agent persistent memory notes
- Look up real API definitions
- Answer questions with checkable evidence
- Keep search inside a private network
Pricing
Open source
Free binary; separate Reader-1 model priced per token on waitlist
Prices change. Check xerj.org before you buy.
XERJ FAQ
Does it need a running server?
Yes, the MCP server connects to a XERJ node at XERJ_URL, default http://localhost:9200.
What license applies?
The engine source is Apache-2.0.
Does it work offline?
Yes, the site says it runs offline on a CPU.
What does it say without evidence?
It returns UNKNOWN.
Is XERJ free?
Yes. XERJ is open source, so you can use and self-host it for free.
How do I add XERJ to Claude Code?
Run this command in your terminal: claude mcp add xerj --env XERJ_AUTH='<XERJ_AUTH>' -- npx -y https://github.com/xerj-org/xerj/releases/download/mcpb-v1.0.0-rc.99/xerj-mcp-1.0.0-rc.99.mcpb
What are the best alternatives to XERJ?
The closest alternatives to XERJ are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and Ouroboros.
Alternatives to XERJ

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling