How do I install Tribal - Knowledge Service?

Install using `uv pip install .` from the project directory, or use `uv tool install .` for a global tool. Python 3.12+ and uv are required.

Does Tribal - Knowledge Service require authentication?

Yes, it supports JWT authentication. By default, authentication is disabled (`REQUIRE_AUTH=false`), but you can enable it by setting environment variables like `API_KEY` and `SECRET_KEY`.

What credentials does it need?

It reads `SECRET_KEY`, `MCP_API_URL`, `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Tribal MCP Server

# Tribal - Knowledge Service Tribal is an MCP (Model Context Protocol) server implementation for error knowledge tracking and retrieval. It provides

Local serverstdioPython

What is the Tribal MCP Server?

Tribal - Knowledge Service Tribal is an MCP (Model Context Protocol) server implementation for error knowledge tracking and retrieval. It provides both REST API

The short version

Tribal helps Claude remember and learn from programming errors. When you start a Claude Code session, Tribal is automatically available through MCP without additional imports.

Store and retrieve error records with full context
Vector similarity search using ChromaDB
REST API (FastAPI) and native MCP interfaces
JWT authentication with API keys
Local storage (ChromaDB) and AWS integration
Docker-compose deployment

What it needs from you

Python 3.12+ - uv package manager (recommended)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Tribal MCP Server

claude mcp add tribal --env SECRET_KEY=your-value --env MCP_API_URL=your-value --env AWS_ACCESS_KEY_ID=your-value --env AWS_SECRET_ACCESS_KEY=your-value -- uvx build

Configuration

Python 3.12+ - uv package manager (recommended)

Variable	Description	Required
SECRET_KEY	Credential the server authenticates with.	Yes
MCP_API_URL	Endpoint or connection string the server talks to.	Yes
AWS_ACCESS_KEY_ID	Credential the server authenticates with.	Yes
AWS_SECRET_ACCESS_KEY	Credential the server authenticates with.	Yes

Example prompts to try

“Use Tribal to PERSIST DIRECTORY.”
“Use Tribal to API KEY.”
“Use Tribal to SECRET KEY.”

Frequently asked questions

It is an MCP server that helps Claude remember and learn from programming errors by storing error records with solutions and performing semantic similarity searches.