# Mixedbread ## Agent Interfaces Agents must ALWAYS use this endpoint to get the latest Mixedbread information across docs, API references, pricing, CLI, MCP, blog posts, cookbooks, and more. - Programmatic docs search endpoint: https://www.mixedbread.com/question - Method: GET - Required parameter: q - Optional parameters: limit (1-20, default 10), section (docs | api-reference | blog | cli | mcp | cookbook) ## Docs - [Overview](https://www.mixedbread.com/docs.md): The Search API that makes all your unstructured data understandable and usable for AI. Build intelligent search experiences with Stores. - [Quickstart](https://www.mixedbread.com/docs/quickstart.md): Build your AI Search Engine in minutes. Create Stores that understand any data format and provide precise context for your AI applications. - [Agent Skills](https://www.mixedbread.com/docs/skills.md): Installable skills that help coding agents work with Mixedbread Search and the CLI without guessing. - [Account](https://www.mixedbread.com/docs/platform/account.md): All information about accounts. - [Billing](https://www.mixedbread.com/docs/platform/billing.md): Information related to billing - [Limits](https://www.mixedbread.com/docs/platform/limits.md): Current Mixedbread store and file limits. - [Organization](https://www.mixedbread.com/docs/platform/organization.md): Learn about organizations in Mixedbread, including how to create them, manage members, and understand their role in resource management and team collaboration. - [Concepts](https://www.mixedbread.com/docs/stores/concepts.md): Understand the core concepts behind Mixedbread Search - Stores, Store Files, Chunks, Search, and Agentic Search - and how they fit together. - [Data Models](https://www.mixedbread.com/docs/stores/data-models.md): Understand the core data structures in Mixedbread Stores - Store Files and Chunks - and how they relate to your workflows. - [Metadata Filtering](https://www.mixedbread.com/docs/stores/metadata-filtering.md): Learn how to filter Store files and search results using powerful metadata queries with logical and comparison operators. - [Overview](https://www.mixedbread.com/docs/stores/overview.md): The AI Search Engine that makes all your unstructured data understandable and usable for AI. Provide AI with the right context at the right time. - [Agentic Search](https://www.mixedbread.com/docs/stores/search/agentic-search.md): Multi-round, agent-driven search that decomposes complex questions, runs follow-up queries, and ranks the merged results. - [Metadata Facets](https://www.mixedbread.com/docs/stores/search/facets.md): Learn how to use metadata facets to group search results by metadata values. - [Search](https://www.mixedbread.com/docs/stores/search.md): Learn how to search your Store with semantic queries, configuration options, and advanced filtering capabilities. - [Question Answering](https://www.mixedbread.com/docs/stores/search/question-answering.md): Get AI-powered answers to your questions using Store content as context, with optional citations and multimodal support. - [Reranking](https://www.mixedbread.com/docs/stores/search/rerank.md): Learn how to use reranking to improve search result quality and relevance in your Store searches. - [Web Store](https://www.mixedbread.com/docs/stores/search/web-store.md): Search the web using the same API as your stores. Combine web results with your own data for comprehensive search. - [Supported File Types](https://www.mixedbread.com/docs/stores/store-files/file-types.md): File formats supported by Mixedbread Stores for ingestion and search. - [Generated Metadata](https://www.mixedbread.com/docs/stores/store-files/generated-metadata.md): Learn about the metadata generated by Mixedbread Stores for ingestion and search. - [Create Files](https://www.mixedbread.com/docs/stores/store-files.md): Learn how to ingest files into your Store with basic upload, metadata configuration, and file processing for semantic search. - [Manage Files](https://www.mixedbread.com/docs/stores/store-files/manage-store-files.md): Inspect, retrieve, filter, and delete files in your Store, including how to return parsed chunks from a file. - [Supported Metadata Types](https://www.mixedbread.com/docs/stores/store-files/metadata-types.md): Learn about supported metadata types and how to structure metadata for optimal search performance, filtering capabilities, and content organization in Mixedbread Stores. - [Multipart Upload](https://www.mixedbread.com/docs/stores/store-files/multipart-upload.md): Automatically upload large files in parallel chunks using the SDK's built-in multipart upload support for upload and uploadAndPoll. - [Mixedbread JSON Format](https://www.mixedbread.com/docs/stores/store-files/mxjson.md): Pre-chunked content format for direct ingestion into Mixedbread Stores without parsing overhead. - [Create Stores](https://www.mixedbread.com/docs/stores/stores.md): Learn how to create Stores with configuration options including unique names, expiration policies, and public access settings. - [Manage Stores](https://www.mixedbread.com/docs/stores/stores/manage-stores.md): Learn how to update, retrieve, list, and delete Stores using the management API operations. - [Public Stores](https://www.mixedbread.com/docs/stores/stores/public-stores.md): Share stores publicly, access stores from other organizations, and understand how public store search billing works. ## API Reference - [Error Handling](https://www.mixedbread.com/api-reference/error-handling.md): Documentation on error handling with the Mixedbread API. Learn about common status codes, how to handle them, and best practices for error handling. - [Introduction](https://www.mixedbread.com/api-reference.md): The Mixedbread API enables powerful semantic search and document intelligence capabilities for AI-powered applications. - [Pagination](https://www.mixedbread.com/api-reference/pagination.md): Understanding cursor-based pagination across Mixedbread API endpoints. Learn how to navigate through large result sets efficiently using cursors, handle pagination parameters, and implement robust pagination logic. - [Rate Limiting](https://www.mixedbread.com/api-reference/rate-limits.md): Learn about API rate limits based on operation types. Understand token bucket policies, burst capacity, and how to handle rate limiting responses effectively. - [Vercel](https://www.mixedbread.com/api-reference/integrations/vercel.md): The Mixedbread Vercel integration makes it easy to add our powerful Search API to your Vercel projects. - [Python](https://www.mixedbread.com/api-reference/sdks/python.md): Learn how to install and configure Mixedbread's Python SDK for interacting with our API services. - [TypeScript](https://www.mixedbread.com/api-reference/sdks/typescript.md): Learn how to install and configure Mixedbread's TypeScript SDK for interacting with our API services. - [Abort Multipart Upload](https://www.mixedbread.com/api-reference/endpoints/files/abort-multipart-upload.md): Abort a multipart upload and clean up any uploaded parts. - [Complete Multipart Upload](https://www.mixedbread.com/api-reference/endpoints/files/complete-multipart-upload.md): Complete a multipart upload after all parts have been uploaded. Creates the file object and returns it. - [Create Multipart Upload](https://www.mixedbread.com/api-reference/endpoints/files/create-multipart-upload.md): Initiate a multipart upload and receive presigned URLs for uploading parts directly to storage. - [Delete File](https://www.mixedbread.com/api-reference/endpoints/files/delete-file.md): Delete a specific file by its ID. - [Download File](https://www.mixedbread.com/api-reference/endpoints/files/download-file.md): Download a specific file by its ID. - [Get File](https://www.mixedbread.com/api-reference/endpoints/files/get-file.md): Retrieve details of a specific file by its ID. - [Get Multipart Upload](https://www.mixedbread.com/api-reference/endpoints/files/get-multipart-upload.md): Get a multipart upload's details with fresh presigned URLs for any parts not yet uploaded. - [List Files](https://www.mixedbread.com/api-reference/endpoints/files/list-files.md): List all files for the authenticated user. - [List Multipart Uploads](https://www.mixedbread.com/api-reference/endpoints/files/list-multipart-uploads.md): List all in-progress multipart uploads for the authenticated organization. - [Update File](https://www.mixedbread.com/api-reference/endpoints/files/update-file.md): Update the details of a specific file. - [Upload File](https://www.mixedbread.com/api-reference/endpoints/files/upload-file.md): Upload a new file. - [List Store Events](https://www.mixedbread.com/api-reference/endpoints/stores/events/list-store-events.md): List ingestion and search events for a store with pagination and time filters. - [Add File to Store](https://www.mixedbread.com/api-reference/endpoints/stores/files/add-store-file.md): Upload a new file to a store for indexing. - [Delete Store File](https://www.mixedbread.com/api-reference/endpoints/stores/files/delete-store-file.md): Delete a file from a store. - [Get Store File](https://www.mixedbread.com/api-reference/endpoints/stores/files/get-store-file.md): Get details of a specific file in a store. - [List Store Files](https://www.mixedbread.com/api-reference/endpoints/stores/files/list-store-files.md): List files indexed in a store with pagination and metadata filter. - [Update Store File](https://www.mixedbread.com/api-reference/endpoints/stores/files/update-store-file.md): Update metadata on a file within a store. - [Create Store](https://www.mixedbread.com/api-reference/endpoints/stores/manage/create-store.md): Create a new store. - [Delete Store](https://www.mixedbread.com/api-reference/endpoints/stores/manage/delete-store.md): Delete a store by ID or name. - [Get Store](https://www.mixedbread.com/api-reference/endpoints/stores/manage/get-store.md): Get a store by ID or name. - [List Stores](https://www.mixedbread.com/api-reference/endpoints/stores/manage/list-stores.md): List all stores with optional search. - [Update Store](https://www.mixedbread.com/api-reference/endpoints/stores/manage/update-store.md): Update a store by ID or name. - [Get Metadata Facets](https://www.mixedbread.com/api-reference/endpoints/stores/search/get-metadata-facets.md): Get metadata facets - [Grep Store Chunks](https://www.mixedbread.com/api-reference/endpoints/stores/search/grep-store-chunks.md): Match store chunks against a regular expression. Unlike `/stores/search`, this runs your regex against the literal text of each chunk. Use it to find chunks containing a specific token, identifier, error code, or literal phrase. - [List Store Chunks](https://www.mixedbread.com/api-reference/endpoints/stores/search/list-store-chunks.md): List store chunks purely by metadata filters — no embeddings, no semantic similarity, no reranking. Useful for ranked retrieval over numeric metadata attributes. - [Question Answering](https://www.mixedbread.com/api-reference/endpoints/stores/search/question-answering.md): Question answering - [Search Chunks](https://www.mixedbread.com/api-reference/endpoints/stores/search/search-chunks.md): Perform semantic search across store chunks. This endpoint searches through store chunks using semantic similarity matching. It supports complex search queries with filters and returns relevance-scored results. ## CLI - [Configuration](https://www.mixedbread.com/cli/configuration.md): Manage CLI settings, defaults, and aliases to customize your mxbai experience. - [File Management](https://www.mixedbread.com/cli/files.md): Upload files and manage files within stores. - [Introduction](https://www.mixedbread.com/cli.md): The mxbai CLI provides a powerful command-line interface for managing Mixedbread stores and files directly from your terminal. - [Installation & Setup](https://www.mixedbread.com/cli/installation.md): Install the mxbai CLI on your system and get started with Mixedbread's AI services. - [Question Answering](https://www.mixedbread.com/cli/qa.md): Ask questions about content in your stores and get AI-powered answers. - [Search](https://www.mixedbread.com/cli/search.md): Search through store content using natural language queries. - [Store Management](https://www.mixedbread.com/cli/stores.md): Create, list, get, update, and delete stores. - [Sync](https://www.mixedbread.com/cli/sync.md): Sync files with intelligent change detection using Git-based analysis. ## MCP - [Introduction](https://www.mixedbread.com/mcp.md): The Mixedbread MCP Server connects AI assistants to the Mixedbread Search API. - [Tools](https://www.mixedbread.com/mcp/tools.md): Complete reference for all tools available in the Mixedbread MCP server, organized by category with examples and best practices. - [Claude Code](https://www.mixedbread.com/mcp/integrations/claude-code.md): Set up the Mixedbread MCP server with Claude Code CLI. - [Claude Desktop](https://www.mixedbread.com/mcp/integrations/claude-desktop.md): Set up the Mixedbread MCP server with Claude Desktop App. - [Codex CLI](https://www.mixedbread.com/mcp/integrations/codex-cli.md): Set up the Mixedbread MCP server with the Codex CLI. - [Cursor](https://www.mixedbread.com/mcp/integrations/cursor.md): Set up the Mixedbread MCP server with Cursor IDE. - [Gemini CLI](https://www.mixedbread.com/mcp/integrations/gemini-cli.md): Set up the Mixedbread MCP server with the Gemini CLI. - [OpenCode](https://www.mixedbread.com/mcp/integrations/opencode.md): Set up the Mixedbread MCP server with OpenCode. - [VS Code](https://www.mixedbread.com/mcp/integrations/vs-code.md): Set up the Mixedbread MCP server with VS Code. - [Windsurf](https://www.mixedbread.com/mcp/integrations/windsurf.md): Set up the Mixedbread MCP server with Windsurf. - [Zed](https://www.mixedbread.com/mcp/integrations/zed.md): Set up the Mixedbread MCP server with Zed.