Supavec is an MCP server that enables AI assistants to search and retrieve embeddings and indexed file content from the Supavec vector platform. Built for software engineers and knowledge workers using MCP-compatible environments like Claude Desktop, Cursor, and VS Code Copilot, the server provides direct access to remote document repositories. Instead of manually copying context or configuring custom retrieval pipelines, users can invoke Supavec tools directly from their chat interface. The server connects to the Supavec API using an authentication key provided either via command-line arguments or environment variables. Once connected, clients can query specific documents to extract semantically relevant text passages or list existing files stored in their Supavec account. This retrieval architecture supports document-grounded question answering, contextual code navigation, and technical documentation search without requiring local embedding generation or manual data preprocessing.
Category: AI Memory & Context
Tags: embeddings, rag, supavec, vector-search
.cursor/mcp.json, .vscode/mcp.json, or Claude Desktop configuration): json { "mcpServers": { "supavec": { "command": "npx", "args": [ "-y", "@supavec/mcp-server@latest", "--api-key", "your_supavec_api_key" ] } } } 3. Alternatively, export the environment variable export SUPAVEC_API_KEY=your_supavec_api_key and run without the --api-key flag. 4. Restart your MCP client to load the tools.Part of MCP Servers
You can run it without manual installation using npx by executing npx @supavec/mcp-server --api-key your_api_key. Alternatively, install it globally using npm install -g @supavec/mcp-server and run supavec-mcp with your key.
The server exposes tools to retrieve context from Supavec. Specifically, fetch-embeddings searches a specified file by ID and query to return relevant content, while list-user-files retrieves user files with pagination and sorting controls.
Supavec works with any Model Context Protocol compliant client. The documentation provides explicit setup configurations for Cursor, VS Code with Copilot, and Claude Desktop.
You can authenticate by passing your API key via the --api-key command-line argument or by setting the SUPAVEC_API_KEY environment variable. The command-line argument takes precedence if both are set.
Yes, the Supavec MCP server is open source and licensed under the MIT License on GitHub.