Tools
The Mixedbread MCP server provides a comprehensive set of tools for store management and search.
Tool Categories
Search Operations
Store Search
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 Search
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 Management
Store Create
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 Retrieve
Get detailed information about a specific store.
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
store_identifier | string | Yes | - | The identifier of the store |
Store List
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 Delete
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: October 8, 2025