Tools
The Mixedbread MCP server provides a comprehensive set of tools for store management and search.
Tool CategoriesLink to section
Search OperationsLink to section
Store SearchLink to section
Search for relevant document chunks within stores.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | - | The search query text |
store_identifiers | string[] | Yes | - | Array of 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 |
Store File SearchLink to section
Search for relevant files stored in stores.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | - | The search query text |
store_identifiers | string[] | Yes | - | Array of 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 |
Store ManagementLink to section
Store CreateLink to section
Create a new store with specified name and optional description.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | - | Name of the store (must be unique) |
description | string | No | - | Optional description of the store's purpose |
Store RetrieveLink to section
Get detailed information about a specific store.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
store_identifier | string | Yes | - | The identifier of the store |
Store ListLink to section
List all available stores with optional filtering and pagination.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
q | string | No | - | Search query for fuzzy matching over name and description fields |
limit | number | No | 20 | Maximum number of items to return per page (1-100) |
after | string | No | - | Cursor for forward pagination - get items after this position. Use last_cursor from previous response. |
before | string | No | - | Cursor for backward pagination - get items before this position. Use first_cursor from previous response. |
include_total | boolean | No | false | Whether to include total count in response (expensive operation) |
Store DeleteLink to section
Delete an existing store and all its contents.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
store_identifier | string | Yes | - | The identifier of the store to delete |
Warning: This action is irreversible. All files and chunks in the store will be permanently deleted.
Last updated: March 17, 2026