OpenRAG is a comprehensive, single package Retrieval-Augmented Generation platform built on Langflow, Docling, and Opensearch.
OpenRAG MCP
The Python package
openrag-mcpis deprecated and no longer updated. Use the built-in streamable HTTP endpoint instead.
OpenRAG ships a built-in Model Context Protocol (MCP) server over streamable HTTP, mounted on your OpenRAG instance at /mcp. This endpoint is part of your OpenRAG deployment; when connecting locally, nothing leaves your network.
Any MCP client that supports URL-based server configs, such as Cursor, Claude Desktop, and the MCP SDK, can connect directly to this endpoint.
There is no subprocess to spawn and nothing extra to install. Your client connects over HTTP using the same OpenRAG API key you use for the REST API. Document ingestion, task tracking, and knowledge filter tools are available directly.
Prerequisites
In addition to a running OpenRAG instance, you need an OpenRAG API key and your OpenRAG MCP endpoint URL.
Authentication
You need an OpenRAG API key (prefixed by orag_). You can create an OpenRAG API key in Settings → API Keys.
Pass your OpenRAG API key on every request using the X-API-Key or Authorization: Bearer headers.
The same key works for both the REST API and MCP, and it is forwarded transparently to the underlying endpoints.
Endpoint URL
The MCP endpoint is /mcp on your OpenRAG instance. The host and port depend on how OpenRAG is deployed:
| Deployment | MCP URL |
|---|---|
| Default Docker deployment | http://localhost:3000/mcp |
| Backend run directly (dev, outside Docker) | http://localhost:8000/mcp |
| Remote / deployed instance | https://your-openrag-instance.com/mcp |
In the default Docker deployment the backend port (8000) is not published to the host. The OpenRAG frontend on port 3000 proxies /mcp to the backend and forwards your authentication headers. Therefore, http://localhost:3000/mcp is the correct local URL for a standard install.
Use http://localhost:8000/mcp only when you run the backend directly without the frontend.
The following examples use the local Docker URL; replace this URL with your own host if you need to connect to a remote instance.
Cursor
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"openrag": {
"url": "http://localhost:3000/mcp",
"headers": {
"X-API-Key": "orag_your_api_key_here"
}
}
}
}
Restart Cursor after saving the config file.
Claude Desktop
Config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"openrag": {
"url": "http://localhost:3000/mcp",
"headers": {
"X-API-Key": "orag_your_api_key_here"
}
}
}
}
Restart Claude Desktop after editing the config file.
IBM Bob
Add the server to your IBM Bob MCP config with type set to streamable-http:
{
"mcpServers": {
"openrag": {
"type": "streamable-http",
"url": "http://localhost:3000/mcp",
"headers": {
"x-api-key": "orag_your_api_key_here"
}
}
}
}
For more information, see MCP integration with IBM Bob.
Available tools
All tools are auto-exposed from the /v1/ API, and they are available immediately after connecting:
| Tool | Description |
|---|---|
openrag_chat |
Send a message and get a RAG-enhanced response. Supports chat_id and filter_id. |
openrag_list_chats |
List all chat conversations. |
openrag_get_chat |
Get a specific chat conversation by ID. |
openrag_delete_chat |
Delete a chat conversation by ID. |
openrag_search |
Semantic search over the knowledge base. Supports filters, score threshold, data sources. |
openrag_ingest |
Ingest documents (files, URLs, text) into the knowledge base. Returns a task_id. |
openrag_get_task_status |
Check the status of an ingestion task by task_id. |
openrag_delete_document |
Delete a document from the knowledge base by filename. |
openrag_get_settings |
Get current OpenRAG configuration (LLM, embeddings, chunk settings, system prompt). |
openrag_update_settings |
Update OpenRAG configuration. All fields are optional. |
openrag_list_models |
List available models for a provider (openai, anthropic, ollama, watsonx). |
openrag_create_knowledge_filter |
Create a knowledge filter to scope searches and chats. |
openrag_search_knowledge_filters |
Search knowledge filters by name or criteria. |
openrag_get_knowledge_filter |
Get a knowledge filter by ID. |
openrag_update_knowledge_filter |
Update an existing knowledge filter. |
openrag_delete_knowledge_filter |
Delete a knowledge filter by ID. |
License
Apache 2.0 — see LICENSE for details.