Supavec MCP Server

What is Supavec MCP Server?

A Model Context Protocol (MCP) server that enables AI assistants to fetch relevant embeddings and content from Supavec. It works with Cursor, Claude, VS Code Copilot, and other MCP-compatible tools.

How to use Supavec MCP Server?

Install via npx @supavec/mcp-server --api-key your_api_key or globally with npm install -g @supavec/mcp-server. Configure by adding the server to your MCP client’s JSON configuration (e.g., .cursor/mcp.json). Provide your Supavec API key via the --api-key argument or the SUPAVEC_API_KEY environment variable.

Key features of Supavec MCP Server

• Fetch embeddings from Supavec files by ID and query
• List all user-uploaded files with pagination
• Flexible authentication: command-line argument or environment variable
• Easy one-command setup via npx
• Integrates with Cursor, Claude, VS Code Copilot, and other MCP tools
• Supports file type, creation date, and team ID in responses

Use cases of Supavec MCP Server

• Retrieve relevant documentation or content from Supavec files via AI assistants
• Search for specific topics (e.g., “authentication”) within uploaded files
• List and paginate through all files in a Supavec account
• Enable AI tools to query embeddings without manual file access
• Use with Cursor, Claude, or VS Code Copilot for contextual file search

FAQ from Supavec MCP Server

What does the “fetch-embeddings” tool do?

It retrieves embeddings from a specific Supavec file based on a given query, returning relevant content.

How do I get a Supavec API key?

Visit Supavec.com, sign up or log in, navigate to API settings, and generate a new key.

What if I see “Supavec API key is required”?

You must provide an API key via --api-key or the SUPAVEC_API_KEY environment variable.

What do 401 or 404 errors mean?

A 401 error indicates an invalid or expired API key; a 404 error means the file ID does not exist or you lack access.

Does the server support pagination?

Yes, the “list-user-files” tool accepts limit, offset, and order_dir parameters for pagination and sorting.