Skip to content
MCP server

briefd

Self-hosted server that compiles git-stored team knowledge into token-budgeted context

Install
Pricing
Open source
Platforms
self-hosted, CLI, API
Runs
Remotely
Version
0.9.0
Listing updated
today

Similar MCP servers

About briefd

briefd is an open-source MCP server for knowledge and memory. It runs as a hosted remote server, so there is nothing to install locally.

Instead of loading every CLAUDE.md or AGENTS.md rule into each session, briefd keeps team knowledge as Markdown in a git repository and answers one question for a coding agent: what does it need to know for this task? The answer is a deduplicated bundle that never exceeds the max_tokens the caller sets, ordered from domain to conventions to project, with a source line per section.

The README reports a benchmark on its sample repo of 44 documents and 47 tasks: 86% fewer tokens than pasting everything into CLAUDE.md, with the answering section present 96% of the time. In real Claude Code sessions it reports 35% less context per turn and 40% lower cost per task, at the price of 3 to 4 extra tool-call round trips. It also distinguishes itself from agent memory tools, because people write the knowledge and agents only open pull requests through propose_update.

Retrieval combines SQLite FTS5 with multilingual-e5-small embeddings in pure Go, with no external services. The first run downloads about a 470 MB model. It runs as a team server with a dashboard, or over stdio for one user, and needs a source repo and a bearer token.

Install

Run in a terminal

claude mcp add briefd --env BRIEFD_SOURCE='<BRIEFD_SOURCE>' --env BRIEFD_API_TOKEN='<BRIEFD_API_TOKEN>' --env BRIEFD_GIT_TOKEN='<BRIEFD_GIT_TOKEN>' -- docker run -i --rm -e BRIEFD_SOURCE -e BRIEFD_API_TOKEN -e BRIEFD_GIT_TOKEN ghcr.io/ismailperim/briefd:0.9.0

Add to claude_desktop_config.json

{
  "mcpServers": {
    "briefd": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRIEFD_SOURCE",
        "-e",
        "BRIEFD_API_TOKEN",
        "-e",
        "BRIEFD_GIT_TOKEN",
        "ghcr.io/ismailperim/briefd:0.9.0"
      ],
      "env": {
        "BRIEFD_SOURCE": "<BRIEFD_SOURCE>",
        "BRIEFD_API_TOKEN": "<BRIEFD_API_TOKEN>",
        "BRIEFD_GIT_TOKEN": "<BRIEFD_GIT_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "briefd": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRIEFD_SOURCE",
        "-e",
        "BRIEFD_API_TOKEN",
        "-e",
        "BRIEFD_GIT_TOKEN",
        "ghcr.io/ismailperim/briefd:0.9.0"
      ],
      "env": {
        "BRIEFD_SOURCE": "<BRIEFD_SOURCE>",
        "BRIEFD_API_TOKEN": "<BRIEFD_API_TOKEN>",
        "BRIEFD_GIT_TOKEN": "<BRIEFD_GIT_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "briefd": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRIEFD_SOURCE",
        "-e",
        "BRIEFD_API_TOKEN",
        "-e",
        "BRIEFD_GIT_TOKEN",
        "ghcr.io/ismailperim/briefd:0.9.0"
      ],
      "env": {
        "BRIEFD_SOURCE": "<BRIEFD_SOURCE>",
        "BRIEFD_API_TOKEN": "<BRIEFD_API_TOKEN>",
        "BRIEFD_GIT_TOKEN": "<BRIEFD_GIT_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "briefd": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRIEFD_SOURCE",
        "-e",
        "BRIEFD_API_TOKEN",
        "-e",
        "BRIEFD_GIT_TOKEN",
        "ghcr.io/ismailperim/briefd:0.9.0"
      ],
      "env": {
        "BRIEFD_SOURCE": "<BRIEFD_SOURCE>",
        "BRIEFD_API_TOKEN": "<BRIEFD_API_TOKEN>",
        "BRIEFD_GIT_TOKEN": "<BRIEFD_GIT_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "briefd": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BRIEFD_SOURCE",
        "-e",
        "BRIEFD_API_TOKEN",
        "-e",
        "BRIEFD_GIT_TOKEN",
        "ghcr.io/ismailperim/briefd:0.9.0"
      ],
      "env": {
        "BRIEFD_SOURCE": "<BRIEFD_SOURCE>",
        "BRIEFD_API_TOKEN": "<BRIEFD_API_TOKEN>",
        "BRIEFD_GIT_TOKEN": "<BRIEFD_GIT_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • BRIEFD_SOURCEKnowledge repository: a git URL (https://…, git@…) or a mounted directory with domain/, conventions/, projects/<name>/Required
  • BRIEFD_API_TOKENBearer token clients must send to /mcp and /apiRequired
  • BRIEFD_GIT_TOKENToken for private HTTPS git remotes

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

compile_bundle
Compiles one deduplicated context block for a task within a token budget.
search_context
Returns ranked sections that fit the budget, for inspection.
get_document
Returns one document in full.
list_scopes
Lists scopes with document and section counts.
propose_update
Creates a branch, and a pull request when configured, with a proposed change.
report_usage
Reports which sections helped, or marks a knowledge gap.
suggest_links
Suggests missing and broken links in the knowledge base.

What it does

Token-budgeted bundles
Compiles one deduplicated context block that stays under a set limit.
Git as source of truth
Reads Markdown knowledge from a repo; the index is a disposable cache.
Reviewable updates
Agents propose changes as branches or pull requests, never writing to the index.
Hybrid retrieval
Fuses keyword and multilingual embedding search with no external services.
Staleness and gap tracking
Dates sections and lists unanswered questions as a backlog on the dashboard.
Stdio or HTTP
Runs as a shared team server or a single-user stdio process.

Good for

  • Give coding agents team conventions without loading all of them each turn
  • Keep business rules and terminology in a reviewed repo
  • Spot rules that drift from the code they govern
  • Share one knowledge base across many projects in a domain

Pricing

Open source

Self-hosted; free

briefd FAQ

What does it need to run?

A knowledge source (git URL or mounted directory) and a BRIEFD_API_TOKEN; a git token is only needed for private HTTPS remotes.

How is it different from agent memory tools?

Memory tools record what an agent observed; briefd serves what the team wrote and reviewed in git.

How many tools does it expose?

Seven, adding two each when Jira or Confluence is configured.

Can I try it quickly?

Yes, briefd demo serves a built-in sample knowledge base; the first run downloads about 470 MB of embedding model.

Is briefd free?

Yes. briefd is open source, so you can use and self-host it for free.

How do I add briefd to Claude Code?

Run this command in your terminal: claude mcp add briefd --env BRIEFD_SOURCE='<BRIEFD_SOURCE>' --env BRIEFD_API_TOKEN='<BRIEFD_API_TOKEN>' --env BRIEFD_GIT_TOKEN='<BRIEFD_GIT_TOKEN>' -- docker run -i --rm -e BRIEFD_SOURCE -e BRIEFD_API_TOKEN -e BRIEFD_GIT_TOKEN ghcr.io/ismailperim/briefd:0.9.0

What are the best alternatives to briefd?

The closest alternatives to briefd are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers