Skip to content

MCP tools

Every tool the MCP server provides, with its parameters.

cortrix-mcp provides 31 tools in v1.0.0-rc.2. The tool names and parameters come from the tool list returned by a running MCP server.

A * after a parameter name means it’s required. A tool that isn’t given a namespace uses the default namespace set by the CORTRIX_NAMESPACE environment variable.

For installation and setup, see MCP server.

Note

Tools marked In development have no documentation yet.

Health and namespaces

ToolWhat it doesParameters
cortrix_healthChecks that the Cortrix service is running and reachable—
cortrix_list_namespacesLists the namespaces you have access tolimit, offset
cortrix_create_namespaceCreates a namespacename*

Query

ToolWhat it doesParameters
cortrix_queryRuns a semantic query over one or more namespacesquery*, top_k, namespaces, rerank
cortrix_cross_ns_queryQueries across several namespacesquery*, namespaces*, top_k, rerank
cortrix_query_explainRuns a query and returns an explanation of the path it tookquery*, top_k, namespaces, rerank

For cortrix_query, top_k defaults to 5 and rerank defaults to true.

Documents

ToolWhat it doesParameters
cortrix_uploadUploads document content for asynchronous processing and returns a taskcontent*, namespace, filename, metadata
cortrix_async_uploadUploads a larger document asynchronously and returns a taskcontent*, namespace, filename, metadata
cortrix_batch_submitSubmits up to 100 documents to one namespace at oncenamespace*, documents*, async_, on_duplicate
cortrix_list_documentsLists the documents in a namespacenamespace, limit, offset
cortrix_document_statusShows a document’s processing status and detailsdoc_id*, namespace
cortrix_task_statusShows the progress of an asynchronous upload tasktask_id*
cortrix_cancel_taskCancels an asynchronous upload tasktask_id*

Directory watchers

ToolWhat it doesParameters
cortrix_add_watcherAdds a watcher that imports the files in a directory automaticallydata_dir*, namespace, recursive
cortrix_list_watchersLists all watchers—

Memory

ToolWhat it doesParameters
cortrix_memory_createCreates a memorynamespace*, content*, memory_type*, metadata
cortrix_memory_listLists memoriesnamespace, memory_type, include_invalidated, limit, offset
cortrix_memory_editEdits a memory’s content or metadatamemory_id*, namespace, content, metadata
cortrix_memory_invalidateSoft-deletes a memorymemory_id*, namespace, reason
cortrix_memory_searchRuns a semantic search over conversation memoryquery*, namespace, top_k
cortrix_memory_search_filterSearches memory filtered by memory typequery*, memory_type*, namespace, top_k
cortrix_memory_opt_outOpts a session out of memory, or revokes the opt-outsession_id*, opt_out, namespace, reason
cortrix_memory_get_auditQueries the memory audit recordsmemory_id, namespace, limit

These tools are In development:

ToolWhat it doesParameters
cortrix_memory_extractExtracts memories from a conversation in one callmessages*, namespace
cortrix_memory_extract_triggerTriggers memory extraction for a session manuallynamespace, session_id
cortrix_memory_revoke_factRevokes an automatically extracted factmemory_id*, namespace

Interactions and the operation log

ToolWhat it doesParameters
cortrix_log_interactionSaves a conversation turn: the user’s question and the assistant’s answersession_id*, query_text*, response_text*, namespace
cortrix_list_interactionsLists a user’s interactionsnamespace*, user_id*, filter, limit, offset
cortrix_list_operationsQueries the operation loguser_id, namespace, action, action_in, start_time, end_time, limit, offset, sort_order

Admin

Admin tools require the server to accept the caller as an admin.

ToolWhat it doesParameters
cortrix_admin_db_credential_registerRegisters a database connection credentialname, dsn, expire_days, connection_ref, description
cortrix_admin_db_import_runStarts a database importconnection_ref*, namespace*, table, filter, sql

These two tools are In development.

Responses and errors

Every tool returns two layers, data and meta. For the response schema and the adapter’s own error codes, see MCP server.

Table reader