Skip to content
MCP server

XERJ

Local search engine for AI agents with cited answers over your code and docs

Runs locallyActively maintainedStatus and history

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.mcpb

Add 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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools
  6. MCP 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