Ragora
Search your knowledge bases from any AI assistant using hybrid RAG.
Open source Repository Open in the app JSON README (API)
About
Search your knowledge bases from any AI assistant using hybrid RAG.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- mregmi
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 3.0.0
- Last push
- 2026-03-06T06:15:05Z
- Repository state
- ativo
- License
- MIT
- Added
- 2026-08-29 04:00:51
- Updated
- 2026-08-29 04:00:51
- Origin id
io.github.mregmi/ragora-mcp
README
# Ragora MCP Server
Search your knowledge bases from any AI assistant using the [Model Context Protocol](https://modelcontextprotocol.io/).
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">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@velarynai/ragora/badge" alt="ragora MCP server" />
</a>
## Quick Start
### 1. Get an API Key
Sign up at [ragora.app](https://ragora.app) and create an API key at **Settings > API Keys**.
### 2. Connect Your AI Tool
#### Claude Desktop
**Option 1: CLI (recommended)**
```bash
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):
```json
{
"mcpServers": {
"ragora": {
"type": "http",
"url": "https://mcp.ragora.app/mcp",
"headers": {
"Authorization": "Bearer sk_live_your_key_here"
}
}
}
}
```
#### Claude Code
```bash
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:
```json
{
"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:
```json
{
"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`:
```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](https://ragora.app) — Sign up and manage your knowledge bases
- [MCP Integration Guide](https://ragora.app/mcp) — Full documentation
- [API Keys](https://ragora.app/settings?tab=developer) — Create your API key
- [Model Context Protocol](https://modelcontextprotocol.io/) — MCP specification
## License
MIT