Tribal
Self-hosted semantic memory over MCP for an engineering team's tacit knowledge. Needs…
- Pricing
- Open source
- Runs
- Remotely
- Version
- 0.4.1
- Listing updated
- 5 days ago
About Tribal
Tribal is an open-source MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Self-hosted semantic memory over MCP for an engineering team's tacit knowledge. Needs Postgres.
Install
Run in a terminal
claude mcp add tribal --env TRIBAL_DATABASE__URL='<TRIBAL_DATABASE__URL>' --env TRIBAL_PROJECT_REMOTE='<TRIBAL_PROJECT_REMOTE>' --env TRIBAL_PROJECT_NAME='<TRIBAL_PROJECT_NAME>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- docker run -i --rm -e TRIBAL_DATABASE__URL -e TRIBAL_PROJECT_REMOTE -e TRIBAL_PROJECT_NAME -e OPENAI_API_KEY -e ANTHROPIC_API_KEY ghcr.io/tribal-memory/tribal:0.4.1Add to claude_desktop_config.json
{
"mcpServers": {
"tribal": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRIBAL_DATABASE__URL",
"-e",
"TRIBAL_PROJECT_REMOTE",
"-e",
"TRIBAL_PROJECT_NAME",
"-e",
"OPENAI_API_KEY",
"-e",
"ANTHROPIC_API_KEY",
"ghcr.io/tribal-memory/tribal:0.4.1"
],
"env": {
"TRIBAL_DATABASE__URL": "<TRIBAL_DATABASE__URL>",
"TRIBAL_PROJECT_REMOTE": "<TRIBAL_PROJECT_REMOTE>",
"TRIBAL_PROJECT_NAME": "<TRIBAL_PROJECT_NAME>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tribal": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRIBAL_DATABASE__URL",
"-e",
"TRIBAL_PROJECT_REMOTE",
"-e",
"TRIBAL_PROJECT_NAME",
"-e",
"OPENAI_API_KEY",
"-e",
"ANTHROPIC_API_KEY",
"ghcr.io/tribal-memory/tribal:0.4.1"
],
"env": {
"TRIBAL_DATABASE__URL": "<TRIBAL_DATABASE__URL>",
"TRIBAL_PROJECT_REMOTE": "<TRIBAL_PROJECT_REMOTE>",
"TRIBAL_PROJECT_NAME": "<TRIBAL_PROJECT_NAME>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tribal": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRIBAL_DATABASE__URL",
"-e",
"TRIBAL_PROJECT_REMOTE",
"-e",
"TRIBAL_PROJECT_NAME",
"-e",
"OPENAI_API_KEY",
"-e",
"ANTHROPIC_API_KEY",
"ghcr.io/tribal-memory/tribal:0.4.1"
],
"env": {
"TRIBAL_DATABASE__URL": "<TRIBAL_DATABASE__URL>",
"TRIBAL_PROJECT_REMOTE": "<TRIBAL_PROJECT_REMOTE>",
"TRIBAL_PROJECT_NAME": "<TRIBAL_PROJECT_NAME>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tribal": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRIBAL_DATABASE__URL",
"-e",
"TRIBAL_PROJECT_REMOTE",
"-e",
"TRIBAL_PROJECT_NAME",
"-e",
"OPENAI_API_KEY",
"-e",
"ANTHROPIC_API_KEY",
"ghcr.io/tribal-memory/tribal:0.4.1"
],
"env": {
"TRIBAL_DATABASE__URL": "<TRIBAL_DATABASE__URL>",
"TRIBAL_PROJECT_REMOTE": "<TRIBAL_PROJECT_REMOTE>",
"TRIBAL_PROJECT_NAME": "<TRIBAL_PROJECT_NAME>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tribal": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TRIBAL_DATABASE__URL",
"-e",
"TRIBAL_PROJECT_REMOTE",
"-e",
"TRIBAL_PROJECT_NAME",
"-e",
"OPENAI_API_KEY",
"-e",
"ANTHROPIC_API_KEY",
"ghcr.io/tribal-memory/tribal:0.4.1"
],
"env": {
"TRIBAL_DATABASE__URL": "<TRIBAL_DATABASE__URL>",
"TRIBAL_PROJECT_REMOTE": "<TRIBAL_PROJECT_REMOTE>",
"TRIBAL_PROJECT_NAME": "<TRIBAL_PROJECT_NAME>",
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
TRIBAL_DATABASE__URLPostgres (pgvector) connection string. Tribal is self-hosted; you provide the database. The supported, complete deployment is docker-compose.yml.RequiredTRIBAL_PROJECT_REMOTEFirst-run only: the git remote that identifies the project bootstrapped on first start.RequiredTRIBAL_PROJECT_NAMEFirst-run only: the name of the project bootstrapped on first start.RequiredTRIBAL_SERVER__TRANSPORTContainerised transport: http or sse. The Docker image does not serve stdio; install the binary for stdio.TRIBAL_SERVER__BIND_ADDRESSAddress the server binds inside the container. Must be 0.0.0.0 (not the loopback default) for the published port to be reachable.TRIBAL_PUBLIC_MCP_URLThe URL clients use to reach the server (for example http://127.0.0.1:8725/mcp). Needed for OAuth dynamic client registration once the server binds a routable interface.OPENAI_API_KEYOptional; only if an ingest or retrieval stage is configured to use OpenAI (defaults target a local Ollama).ANTHROPIC_API_KEYOptional; only if a stage is configured to use Anthropic.
Pricing
Open source
Prices change. Check tribal.build before you buy.
Tribal FAQ
Is Tribal free?
Yes. Tribal is open source, so you can use and self-host it for free.
How do I add Tribal to Claude Code?
Run this command in your terminal: claude mcp add tribal --env TRIBAL_DATABASE__URL='<TRIBAL_DATABASE__URL>' --env TRIBAL_PROJECT_REMOTE='<TRIBAL_PROJECT_REMOTE>' --env TRIBAL_PROJECT_NAME='<TRIBAL_PROJECT_NAME>' --env OPENAI_API_KEY='<OPENAI_API_KEY>' --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- docker run -i --rm -e TRIBAL_DATABASE__URL -e TRIBAL_PROJECT_REMOTE -e TRIBAL_PROJECT_NAME -e OPENAI_API_KEY -e ANTHROPIC_API_KEY ghcr.io/tribal-memory/tribal:0.4.1
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.