Home

Contextator

Give your AI agent your documentation.

Contextator is a self-hosted documentation server that speaks the Model Context Protocol. You point it at the places your documentation actually lives — a folder on the server, a git repository, a zip someone sent you, an Obsidian vault, a Notion workspace — and each project becomes its own URL that Claude Code, Cursor, Claude Desktop and any other MCP client can search semantically:

http://localhost:3444/mcp/my-project

Ask your agent "how do we rotate the signing key?" and it searches your documentation, quotes the right paragraph and tells you which file it came from.

No repository clone needed — this pulls the published image, contextator/contextator:

mkdir contextator && cd contextator
curl -fsSLO https://raw.githubusercontent.com/Contextator/Contextator/main/docker-compose.yml
curl -fsSLO https://raw.githubusercontent.com/Contextator/Contextator/main/.env.example
cp .env.example .env
docker compose up -d

Then open http://localhost:3444/ and create your first project. The whole walkthrough is in Quick Start — about ten minutes from nothing to an agent answering questions.

---

What makes it different

• One URL per project, fully isolated. A client connected to /mcp/billing can never see /mcp/mobile. Separate documents, separate embeddings, separate everything.
• Many sources per project. A local directory and two git repositories and an uploaded vault and a Notion workspace — merged into one searchable endpoint, each under its own name.
• Open or closed, per project. An endpoint is open by default, as it has always been; one switch puts it behind a bearer token that your client sends as an ordinary header. See Security.
• Accounts, not a shared password. Everyone signs in as themselves; root and admin reach every project, and a member reaches only the ones you add it to, as a viewer or an editor. See Accounts and Permissions.
• 100 % local by default. Embeddings run on your CPU. No API key, no account with anyone else, nothing leaves the machine. Switch to OpenAI embeddings with two environment variables if you prefer.
• Multilingual. The default model covers 50+ languages including Turkish, and answers questions across languages.
• One container. PostgreSQL and the application ship in a single image. There is no database to install and no migration to run.
• Incremental. Files are hashed; a re-index only re-embeds what actually changed.
• Works with old and new clients. Both MCP transports are served on the same URL, so clients pick whichever they support without any configuration.

---

Start here

I want to…	Page
Get it running and connected in ten minutes	Quick Start
Install it properly (Compose, plain docker run, build it yourself, or from source)	Installation
Understand every setting	Configuration
Learn my way around the dashboard	Dashboard Tour
Give my team accounts, and decide who sees what	Accounts and Permissions
Add documentation from somewhere	Document Sources
Connect Claude Code / Cursor / Claude Desktop	Connecting AI Clients
Know what the agent can actually do	MCP Tools
Fix something that is not working	Troubleshooting

Sources

Source	Page
A folder mounted on the server	Local Directory Source
A git repository (GitHub, GitLab, Bitbucket, Gitea…)	Git Repository Source
Files, folders and archives you upload	Upload Source
An Obsidian vault	Obsidian Vaults
A Notion workspace	Notion

Going deeper

Indexing · Embedding Models · Content Types · Push Webhooks · Admin API · Accounts and Permissions · Security · Backup and Data · FAQ

---

Contextator is free software under the GNU AGPL v3 or later — run it, change it, share it; a modified version you let others reach over a network owes them its source. A commercial licence is available if those terms do not fit.