Mixpeek integration
Mixpeek is a multimodal data warehouse: files land in buckets as objects, processing pipelines turn them into documents inside collections, and retrievers run multi-stage search (vector, keyword, hybrid, reranked) over those collections. This integration covers that core. Namespaces: create, read, update, list, delete and read usage statistics. Buckets and objects: create and manage buckets, register objects singly or in batch, read, update, list, aggregate and delete them, and drive direct file uploads by requesting an upload URL, confirming it, and doing both in batch. Collections: create, clone, read, update, list, export and delete collections, describe the features they extract, synchronise their schema, apply a taxonomy to the documents already in them, import documents, and trigger processing. Documents: create, read, patch, update, list, aggregate, list distinct values of a field, bulk and batch update, batch delete, delete, validate against the collection schema, update a document access control list, download a document's media, and walk lineage back to the source object or out to everything derived from it. Retrievers: create, clone, patch, list, read and delete retrievers, execute one (auto-optimised, batch, or ad hoc without persisting it), list and read executions with their live status, execution profile and explain plan, run typeahead, and list the retriever stages and feature extractors available. Taxonomies: create, read, patch, list, clone, delete, validate a configuration without saving it, and list or create versions. Tasks: list, read and kill background work. The credential is a Mixpeek API key (mxp_sk_...), sent as a bearer token in the Authorization header, plus the namespace id (ns_...) that scopes the request, sent in the X-Namespace header.
Say what should happen.
The workflow builds itself.
What you can do with Mixpeek
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
List, 11 operations
list_adhoc_executionsList adhoc executionsPOSTList Adhoc Executions.list_bucketsList bucketsPOSTList Buckets.list_collectionsList collectionsPOSTList Collections.list_documentsList documentsPOSTList documents.list_namespacesList namespacesPOSTList Namespaces.list_objectsList objectsPOSTList Objects.list_retriever_executionsList retriever executionsPOSTList Executions.list_retrieversList retrieversPOSTList Retrievers.list_tasksList tasksPOSTList Tasks.list_taxonomiesList taxonomiesPOSTList Taxonomies.list_uploadsList uploadsPOSTList Uploads.
Batch, 6 operations
batch_delete_documentsBatch delete documentsDELETEBatch Delete Documents.batch_execute_retrieverBatch execute retrieverPOSTBatch Execute Retriever.batch_update_documentsBatch update documentsPOSTBatch Update Documents.confirm_uploads_batchConfirm uploads batchPOSTBatch Confirm Uploads.create_objects_batchCreate objects batchPOSTCreate Objects in Batch.create_uploads_batchCreate uploads batchPOSTBatch Create Uploads.
Document, 6 operations
create_documentCreate documentPOSTCreate a document.delete_documentDelete documentDELETEDelete a document by ID.get_documentGet documentGETGet a document by ID.list_documents_derived_from_objectList documents derived from objectGETGet all documents derived from an object.replace_documentReplace documentPUTUpdate Document.update_documentUpdate documentPATCHPatch Document.
Bucket, 5 operations
create_bucketCreate bucketPOSTCreate Bucket.delete_bucketDelete bucketDELETEDelete Bucket.get_bucketGet bucketGETGet Bucket.replace_bucketReplace bucketPUTUpdate Bucket.update_bucketUpdate bucketPATCHPartially Update Bucket.
Namespace, 5 operations
create_namespaceCreate namespacePOSTCreate Namespace.delete_namespaceDelete namespaceDELETEDelete Namespace.get_namespaceGet namespaceGETGet Namespace.replace_namespaceReplace namespacePUTUpdate Namespace.update_namespaceUpdate namespacePATCHPartially Update Namespace.
Object, 5 operations
create_objectCreate objectPOSTCreate Object.delete_objectDelete objectDELETEDelete Object.get_objectGet objectGETGet Object.replace_objectReplace objectPUTUpdate Object.update_objectUpdate objectPATCHPartially Update Object.
Collection, 4 operations
create_collectionCreate collectionPOSTCreate Collection.delete_collectionDelete collectionDELETEDelete Collection.get_collectionGet collectionGETGet Collection.update_collectionUpdate collectionPATCHUpdate Collection.
Retriever, 4 operations
create_retrieverCreate retrieverPOSTCreate Retriever.delete_retrieverDelete retrieverDELETEDelete Retriever.get_retrieverGet retrieverGETGet Retriever.update_retrieverUpdate retrieverPATCHPatch Retriever.
Taxonomie, 4 operations
create_taxonomyCreate taxonomyPOSTCreate Taxonomy.delete_taxonomyDelete taxonomyDELETEDelete Taxonomy.get_taxonomyGet taxonomyGETGet Taxonomy.update_taxonomyUpdate taxonomyPATCHPartially Update Taxonomy.
Clone, 3 operations
clone_collectionClone collectionPOSTClone Collection.clone_retrieverClone retrieverPOSTClone Retriever.clone_taxonomyClone taxonomyPOSTClone Taxonomy.
Execute, 3 operations
execute_adhoc_retrieverExecute adhoc retrieverPOSTExecute Adhoc Retriever.execute_retrieverExecute retrieverPOSTExecute Retriever (Auto-Optimized).validate_taxonomy_configurationValidate taxonomy configurationPOSTTest taxonomy configuration (validation only) , DEPRECATED path.
Upload, 3 operations
create_uploadCreate uploadPOSTCreate Upload.delete_uploadDelete uploadDELETEDelete Upload.get_uploadGet uploadGETGet Upload.
Aggregate, 2 operations
aggregate_documentsAggregate documentsPOSTAggregate Documents.aggregate_objectsAggregate objectsPOSTAggregate Objects.
Execution, 2 operations
get_adhoc_executionGet adhoc executionGETGet Adhoc Execution.get_retriever_executionGet retriever executionGETGet Execution.
Extractor, 2 operations
get_feature_extractorGet feature extractorGETGet Feature Extractor by Name.list_feature_extractorsList feature extractorsGETList Feature Extractors.
Task, 2 operations
get_taskGet taskGETGet Task Information.kill_taskKill taskDELETEKill Task.
Version, 2 operations
create_taxonomy_versionCreate taxonomy versionPOSTCreate Taxonomy Version.list_taxonomy_versionsList taxonomy versionsGETList Taxonomy Versions.
Acl, 1 operation
update_document_aclUpdate document aclPATCHUpdate a document's access control list (ACL).
Apply taxonomy, 1 operation
apply_taxonomy_to_collectionApply taxonomy to collectionPOSTApply Taxonomy to Existing Documents.
Bulk, 1 operation
bulk_update_documentsBulk update documentsPATCHBulk Update Documents.
Confirm, 1 operation
confirm_uploadConfirm uploadPOSTConfirm Upload.
Decomposition tree, 1 operation
get_object_decomposition_treeGet object decomposition treeGETGet decomposition tree visualization.
Distinct, 1 operation
list_distinct_document_valuesList distinct document valuesPOSTReturn distinct values for a single field.
Download, 1 operation
download_document_mediaDownload document mediaGETDownload frame-accurate scene media for this document.
Explain, 1 operation
explain_retriever_execution_planExplain retriever execution planPOSTExplain Retriever Execution Plan.
Export, 1 operation
export_collectionExport collectionPOSTExport Collection.
Feature, 1 operation
describe_collection_featuresDescribe collection featuresGETDescribe collection features.
Import, 1 operation
import_collection_documentsImport collection documentsPOSTImport external documents into a collection.
Lineage, 1 operation
get_document_lineageGet document lineageGETGet document lineage.
Profile, 1 operation
get_execution_profileGet execution profileGETGet Execution Query Profile (explain-on-execute read path).
Stage, 1 operation
list_retriever_stagesList retriever stagesGETList Available Retriever Stages.
Stat, 1 operation
get_namespace_statsGet namespace statsGETGet Namespace Stats.
Statu, 1 operation
get_live_execution_statusGet live execution statusGETGet Live Execution Status.
Sync schema, 1 operation
sync_collection_schemaSync collection schemaPOSTSync Collection Schema.
Trigger, 1 operation
trigger_collection_processingTrigger collection processingPOSTTrigger Collection Processing.
Typeahead, 1 operation
retriever_typeaheadRetriever typeaheadGETTypeahead.
Validate, 1 operation
validate_document_schemaValidate document schemaPOSTValidate document against collection schema.
Use Mixpeek from Claude Code, Cursor or Codex
Connect Mixpeek in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Mixpeek operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Mixpeek
- Create your workspace
Sign up free. Nothing to install.
- Connect Mixpeek once
Add your Mixpeek connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Mixpeek integration FAQ
What can you do with the Mixpeek integration?
LiveContext exposes 89 operations on Mixpeek, covering list, batch, document and bucket.
