briefd
Self-hosted server that compiles git-stored team knowledge into token-budgeted context
- 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.0Add 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>/RequiredBRIEFD_API_TOKENBearer token clients must send to /mcp and /apiRequiredBRIEFD_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.


