Context RepoContext Repo Docs
MCP Server

MCP Server

Connect your AI assistant to Context Repo with the Model Context Protocol (MCP). Access 26 tools for managing prompts, documents, collections, and search — directly from Claude, Cursor, VS Code, and more.

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. Instead of copying and pasting between your AI assistant and Context Repo, MCP gives your assistant direct access to your prompts, documents, and collections — so it can read, create, update, and search your workspace without you ever leaving the conversation.

Why MCP Matters

Without MCP, working with AI context looks something like this:

  • Open Context Repo in one tab, your AI assistant in another
  • Copy a prompt, switch tabs, paste it in
  • Get a response, switch back, save it as a document
  • Repeat for every interaction

With the Context Repo MCP Server, your AI assistant handles all of this directly. Ask it to list your prompts, create a document, search your collections, or explore content chunk by chunk — all through natural conversation.

One connection. 26 tools. Zero tab-switching.

Tools Overview

The MCP Server provides 26 tools organized into 6 categories. Each tool maps to a specific action in your Context Repo workspace.

User Info

ToolDescription
get_user_infoGet your account details (name, email, profile image)

Prompts (7 tools)

ToolDescription
list_promptsList all your prompts with optional search filtering
get_promptGet a specific prompt's full content, variables, and metadata
create_promptCreate a new prompt template with title, description, content, and engine
update_promptUpdate an existing prompt's title, description, or content
delete_promptPermanently delete a prompt
get_prompt_versionsView a prompt's version history with change logs
restore_prompt_versionRestore a prompt to a previous version

Documents (7 tools)

ToolDescription
list_documentsList all your documents with optional search filtering
get_documentGet a specific document's full content and metadata
create_documentCreate a new text document with optional tags
update_documentUpdate an existing document's title or content
delete_documentPermanently delete a document
get_document_versionsView a document's version history with change logs
restore_document_versionRestore a document to a previous version

Collections (7 tools)

ToolDescription
list_collectionsList all your collections with optional search filtering
get_collectionGet a collection's details and its items
create_collectionCreate a new collection with name, description, icon, and color
update_collectionUpdate a collection's name, description, icon, or color
delete_collectionDelete a collection (items aren't deleted — they stay in your workspace)
add_to_collectionAdd prompts or documents to a collection
remove_from_collectionRemove prompts or documents from a collection

Search (1 tool)

ToolDescription
find_itemsSearch across prompts, documents, and collections using semantic similarity or keyword matching. Filter by type and toggle between search modes.

Deep Search (3 tools)

ToolDescription
deep_searchSearch within document content and get ranked, hierarchical chunks with navigation links
deep_readRead a specific chunk with full content, structural position, and metadata
deep_expandNavigate from a chunk in 5 directions: up (parent), down (children), next, previous, or surrounding

Deep Search is designed for exploring large documents progressively. Start with deep_search to find relevant passages, use deep_read to examine them in detail, and deep_expand to navigate through the document's structure without loading everything at once.

Authentication

The MCP Server supports two authentication methods:

  • Clerk OAuth (primary) — When you connect through a supported client like Cursor or Claude Desktop, you'll sign in with your Context Repo account. This is the recommended method and happens automatically during setup.
  • API Key (fallback) — Generate an API key from Dashboard > Settings > API Keys and pass it as the authentication token. This works with any MCP-compatible client and is useful for programmatic access.

Both methods give you access to all 26 tools for your account.

Get Started

Ready to connect your AI assistant?