{
  "markdown": "# Ragora MCP Server\n\nSearch your knowledge bases from any AI assistant using the [Model Context Protocol](https://modelcontextprotocol.io/).\n\nRagora'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.\n\n**Server URL:** `https://mcp.ragora.app/mcp`\n\n<a href=\"https://glama.ai/mcp/servers/@velarynai/ragora\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@velarynai/ragora/badge\" alt=\"ragora MCP server\" />\n</a>\n\n## Quick Start\n\n### 1. Get an API Key\n\nSign up at [ragora.app](https://ragora.app) and create an API key at **Settings > API Keys**.\n\n### 2. Connect Your AI Tool\n\n#### Claude Desktop\n\n**Option 1: CLI (recommended)**\n\n```bash\nclaude mcp add --transport http ragora https://mcp.ragora.app/mcp \\\n  --header \"Authorization: Bearer sk_live_your_key_here\"\n```\n\n**Option 2: Config file**\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"ragora\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.ragora.app/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Claude Code\n\n```bash\nclaude mcp add --transport http ragora https://mcp.ragora.app/mcp \\\n  --header \"Authorization: Bearer sk_live_your_key_here\"\n```\n\n#### Cursor\n\nAdd to `.cursor/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"ragora\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.ragora.app/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### VS Code / GitHub Copilot\n\nAdd to `.vscode/mcp.json` in your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"ragora\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.ragora.app/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Windsurf\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"ragora\": {\n      \"serverUrl\": \"https://mcp.ragora.app/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Any MCP Client\n\nRagora uses **Streamable HTTP** transport. Point any MCP-compatible client to:\n\n- **URL:** `https://mcp.ragora.app/mcp`\n- **Method:** `POST`\n- **Header:** `Authorization: Bearer sk_live_your_key_here`\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `discover_collections` | List all knowledge bases you have access to, with descriptions, stats, and usage examples |\n| `search` | Search across **all** your knowledge bases at once |\n| `search_collection` | Search a **specific** collection by name, with optional tag/metadata filters |\n\n### Tool Parameters\n\n**`search(query, top_k?)`**\n- `query` (required): Natural language search query\n- `top_k` (optional): Number of results to return (default: 5)\n\n**`search_collection(collection_name, query, top_k?, custom_tags?, filters?)`**\n- `collection_name` (required): Collection name or slug (use `discover_collections` to find names)\n- `query` (required): Natural language search query\n- `top_k` (optional): Number of results (default: 5)\n- `custom_tags` (optional): Tags to scope retrieval\n- `filters` (optional): Metadata filters\n\n## Dynamic Collection Tools\n\nFor each collection you have access to, dedicated tools are generated using the collection's slug:\n\n- `search_{slug}` — semantic search with optional version, tags, and filters\n- `get_topic_{slug}` — retrieve information about a specific topic\n- `list_versions_{slug}` — list available documentation versions\n\nFor example, a collection called \"Employee Handbook\" gets:\n- `search_employee_handbook`\n- `get_topic_employee_handbook`\n- `list_versions_employee_handbook`\n\nConfigure tool names and descriptions in the Ragora dashboard under **Collection > MCP Settings**.\n\n## Usage Examples\n\n**Search all collections:**\n> \"Search my docs for webhook event handling\"\n\n**Search a specific collection:**\n> \"Look up the refund policy in the employee handbook\"\n\n**Discover what's available:**\n> \"What workspaces do I have, and what's in them?\"\n\n## How It Works\n\n```\nYour AI Tool                        Ragora Cloud\n┌──────────────────┐               ┌──────────────────┐\n│ Claude / Cursor  │   HTTP POST   │  MCP Server      │\n│ / VS Code / etc  │──────────────>│  (Streamable HTTP)│\n└──────────────────┘    /mcp       └────────┬─────────┘\n                                            │\n                                   ┌────────▼─────────┐\n                                   │  Gateway API      │\n                                   │  (Auth + Search)  │\n                                   └────────┬─────────┘\n                                       ┌────┴────┐\n                                       ▼         ▼\n                                   Postgres    Qdrant\n                                   (metadata)  (vectors)\n```\n\n- **No local install** — connect directly via HTTP\n- **Multi-tenant** — your API key determines which collections you can access\n- **Dynamic tools** — tools are generated based on your accessible collections\n- **Hybrid search** — dense (E5-Large) + sparse (BM25) with reciprocal rank fusion\n\n## Security\n\n- API keys authenticate all requests via `Authorization: Bearer` header\n- Each API key is scoped to the user's owned and purchased collections\n- Cross-tenant data access is impossible — all queries are filtered by accessible collection IDs\n- API keys should never be committed to version control\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| \"Tool not found\" | Restart your AI app after config changes. Verify your API key starts with `sk_live_` |\n| \"Unauthorized\" | Check the `Authorization: Bearer` header format. Verify the key hasn't expired |\n| No results | Ensure documents are uploaded and processing is complete. Try broader queries |\n| Connection timeout | Check internet access. Verify server status at `https://mcp.ragora.app/health` |\n\n## Links\n\n- [Ragora](https://ragora.app) — Sign up and manage your knowledge bases\n- [MCP Integration Guide](https://ragora.app/mcp) — Full documentation\n- [API Keys](https://ragora.app/settings?tab=developer) — Create your API key\n- [Model Context Protocol](https://modelcontextprotocol.io/) — MCP specification\n\n## License\n\nMIT",
  "bytes": 6393,
  "sha": "399666ed502bfdec2472e0ec7a36b8590227f35e0418303f3aed3a86aaad0078",
  "repo_slug": "velarynai/ragora-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mregmi_ragora_mcp_6558aab7/readme"
}