Ragora

Ragora MCP Server

Search your knowledge bases from any AI assistant using the Model Context Protocol.

Ragora's MCP server is a hosted cloud service — no local installation required. Just configure your AI tool with the server URL and your API key.

Server URL: https://mcp.ragora.app/mcp

Quick Start

1. Get an API Key

Sign up at ragora.app and create an API key at Settings > API Keys.

2. Connect Your AI Tool

Claude Desktop

Option 1: CLI (recommended)

claude mcp add --transport http ragora https://mcp.ragora.app/mcp \

--header "Authorization: Bearer sk_live_your_key_here"

Option 2: Config file

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{

"mcpServers": { "ragora": { "type": "http", "url": "https://mcp.ragora.app/mcp", "headers": { "Authorization": "Bearer sk_live_your_key_here" } } } }

Claude Code

claude mcp add --transport http ragora https://mcp.ragora.app/mcp \

--header "Authorization: Bearer sk_live_your_key_here"

Cursor

Add to .cursor/mcp.json in your project root:

{

"mcpServers": { "ragora": { "type": "http", "url": "https://mcp.ragora.app/mcp", "headers": { "Authorization": "Bearer sk_live_your_key_here" } } } }

VS Code / GitHub Copilot

Add to .vscode/mcp.json in your project root:

{

"mcpServers": { "ragora": { "type": "http", "url": "https://mcp.ragora.app/mcp", "headers": { "Authorization": "Bearer sk_live_your_key_here" } } } }

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "ragora": { "serverUrl": "https://mcp.ragora.app/mcp", "headers": { "Authorization": "Bearer sk_live_your_key_here" } } } }

Any MCP Client

Ragora uses Streamable HTTP transport. Point any MCP-compatible client to:

• URL: https://mcp.ragora.app/mcp
• Method: POST
• Header: Authorization: Bearer sk_live_your_key_here

Available Tools

Tool Parameters

`search(query, top_k?)`

• query (required): Natural language search query
• top_k (optional): Number of results to return (default: 5)

`search_collection(collection_name, query, top_k?, custom_tags?, filters?)`

• collection_name (required): Collection name or slug (use discover_collections to find names)
• query (required): Natural language search query
• top_k (optional): Number of results (default: 5)
• custom_tags (optional): Tags to scope retrieval
• filters (optional): Metadata filters

Dynamic Collection Tools

For each collection you have access to, dedicated tools are generated using the collection's slug:

• search_{slug} — semantic search with optional version, tags, and filters
• get_topic_{slug} — retrieve information about a specific topic
• list_versions_{slug} — list available documentation versions

For example, a collection called "Employee Handbook" gets:

• search_employee_handbook
• get_topic_employee_handbook
• list_versions_employee_handbook

Configure tool names and descriptions in the Ragora dashboard under Collection > MCP Settings.

Usage Examples

Search all collections:

"Search my docs for webhook event handling"

Search a specific collection:

"Look up the refund policy in the employee handbook"

Discover what's available:

"What workspaces do I have, and what's in them?"

How It Works

Your AI Tool                        Ragora Cloud

┌──────────────────┐ ┌──────────────────┐ │ Claude / Cursor │ HTTP POST │ MCP Server │ │ / VS Code / etc │──────────────>│ (Streamable HTTP)│ └──────────────────┘ /mcp └────────┬─────────┘ │ ┌────────▼─────────┐ │ Gateway API │ │ (Auth + Search) │ └────────┬─────────┘ ┌────┴────┐ ▼ ▼ Postgres Qdrant (metadata) (vectors)

• No local install — connect directly via HTTP
• Multi-tenant — your API key determines which collections you can access
• Dynamic tools — tools are generated based on your accessible collections
• Hybrid search — dense (E5-Large) + sparse (BM25) with reciprocal rank fusion

Security

• API keys authenticate all requests via Authorization: Bearer header
• Each API key is scoped to the user's owned and purchased collections
• Cross-tenant data access is impossible — all queries are filtered by accessible collection IDs
• API keys should never be committed to version control

Troubleshooting

Links

• Ragora — Sign up and manage your knowledge bases
• MCP Integration Guide — Full documentation
• API Keys — Create your API key
• Model Context Protocol — MCP specification

License

MIT