Skip to content
MCP server

Tribal

Self-hosted semantic memory over MCP for an engineering team's tacit knowledge. Needs…

Install
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.1

Add 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.Required
  • TRIBAL_PROJECT_REMOTEFirst-run only: the git remote that identifies the project bootstrapped on first start.Required
  • TRIBAL_PROJECT_NAMEFirst-run only: the name of the project bootstrapped on first start.Required
  • TRIBAL_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.

How AIPoweredBot checks servers