fetch-embeddings
Fetch embeddings for a file by ID and query
LABSCO SUMMARY
Retrieval only: the corpus has to exist in Supavec before either call has anything to return.
There is no upload path in the tool surface — list-user-files reports what is already there and fetch-embeddings queries one file at a time by file_id — so ingestion stays inside Supavec itself. That makes this a tightly scoped reader over a corpus someone else maintains, and it means a session that cannot find the file it wants has no way from here to add it.
What it is
A server over a Supavec account, exposing the uploaded file list and embedding retrieval against one file at a time.
What you get
- fetch-embeddings retrieves embeddings for a single file, addressed by file_id, against a query.
- list-user-files returns the files uploaded to Supavec for the current user, paged with limit, offset and order_dir.
Requirements
A Supavec account with an API key, supplied as SUPAVEC_API_KEY.
Setup effort
One command plus a key — npx @supavec/mcp-server --api-key <YOUR_API_KEY>, then supply credentials
USE CASES
01
Answering a question out of a document you have already indexed
Find the file among what is uploaded, then query inside it by its file_id rather than searching the whole account.
2 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
list-user-files
List all files uploaded to Supavec for the current user
BEFORE YOU INSTALL
What to know first
Tools you get
2 tools when we connected. Both tools only read; documents go into Supavec through Supavec itself. Names use dashes: list-user-files and fetch-embeddings.
Requires
- npx on PATH
- Node.js 16.0.0 or later
- A Supavec API key, passed as --api-key or set in SUPAVEC_API_KEY
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 2 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx @supavec/mcp-server --api-key <YOUR_API_KEY>MCP Clients
Cursor, Claude Desktop
JSON
{
"mcpServers": {
"supavec": {
"command": "npx",
"args": [
"-y",
"@supavec/mcp-server@latest",
"--api-key",
"<YOUR_SUPAVEC_API_KEY>"
]
}
}
}The blocks on this page pass the key as --api-key. You can instead export SUPAVEC_API_KEY and delete the two --api-key lines; if both are set, --api-key wins.
GitHub Copilot in VS Code
GITHUB COPILOT IN VS CODE · JSON
{
"servers": {
"supavec": {
"command": "npx",
"args": [
"-y",
"@supavec/mcp-server@latest",
"--api-key",
"<YOUR_SUPAVEC_API_KEY>"
]
}
}
}The blocks on this page pass the key as --api-key. You can instead export SUPAVEC_API_KEY and delete the two --api-key lines; if both are set, --api-key wins.
