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.

git clone https://github.com/Tunedness/Contextator.git contextator && cd contextator
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.
• 100 % local by default. Embeddings run on your CPU. No API key, no account, 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, or from source)	Installation
Understand every setting	Configuration
Learn my way around the dashboard	Dashboard Tour
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 · 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.