Tools Reference
Available Tools
The Mixedbread MCP server exposes 8 specialized tools for comprehensive vector store management. Each tool is designed for specific operations and can be invoked through natural language commands in your MCP client.
Search Tools
Vector Store Search
Search for relevant document chunks within vector stores using semantic search.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | - | The search query text |
vector_store_identifiers | string[] | Yes | - | Array of vector store IDs or names to search in |
top_k | number | No | 5 | Number of top results to return (max: 100) |
filters | object | No | - | Custom filters to apply to the search |
file_ids | string[] | No | - | Specific file IDs to search within |
search_options | object | No | - | Additional search configuration options |
Example Usage
Vector Store File Search
Search for relevant files within vector stores.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | - | The search query text |
vector_store_identifiers | string[] | Yes | - | Array of vector store IDs or names |
top_k | number | No | 5 | Number of top files to return |
filters | object | No | - | Custom filters to apply |
file_ids | string[] | No | - | Specific file IDs to search within |
search_options | object | No | - | Advanced search options |
For detailed information about search options and their differences between file and chunk search, see the API Reference documentation.
Example Usage
Management Tools
Vector Store Create
Create a new vector store with specified name and optional description.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | - | Name of the vector store (must be unique) |
description | string | No | - | Optional description of the store's purpose |
Example Usage
Vector Store Retrieve
Get detailed information about a specific vector store.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
vector_store_identifier | string | Yes | - | The identifier of the vector store |
Example Usage
Vector Store List
List all available vector stores with optional filtering and pagination.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | No | - | Search query to filter vector stores by name |
limit | number | No | 20 | Maximum number of stores to return (max: 100) |
cursor | string | No | - | Pagination cursor for next page |
include_total | boolean | No | false | Include total count in response |
Example Usage
Vector Store Delete
Delete an existing vector store and all its contents.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
vector_store_identifier | string | Yes | - | The identifier of the vector store to delete |
Example Usage
Deleting a vector store is permanent and cannot be undone. All files and chunks within the store will be deleted.
File Operations
Vector Store Upload
Upload a file to a vector store with automatic processing and chunking.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
vector_store_identifier | string | Yes | - | Target vector store identifier |
file_path | string | Yes | - | Absolute path to the local file |
filename | string | No | basename | Custom filename for the uploaded file |
mime_type | string | No | auto | MIME type (auto-detected if not provided) |
Example Usage
Vector Store File Retrieve
Get detailed information about a specific file in a vector store.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
file_id | string | Yes | - | The ID of the file to retrieve |
vector_store_identifier | string | Yes | - | The identifier of the containing vector store |
Example Usage
Last updated: July 5, 2025