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

<a href="https://glama.ai/mcp/servers/@velarynai/ragora">

</a>

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 | Description |
|------|-------------|
| discover_collections | List all knowledge bases you have access to, with descriptions, stats, and usage examples |
| search | Search across all your knowledge bases at once |
| search_collection | Search a specific collection by name, with optional tag/metadata filters |

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

| Issue | Solution |
|-------|----------|
| "Tool not found" | Restart your AI app after config changes. Verify your API key starts with sk_live_ |
| "Unauthorized" | Check the Authorization: Bearer header format. Verify the key hasn't expired |
| No results | Ensure documents are uploaded and processing is complete. Try broader queries |
| Connection timeout | Check internet access. Verify server status at https://mcp.ragora.app/health |

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