MCP tool reference

The live list is always tools/list, mirrored byte-for-byte at /.well-known/mcp/server-card.json. This page is the human-readable version of the same surface.

Memory tools

All of these touch a user's private memory and require an OAuth grant.

cortex_ask

Searches the memory, fusing vector, full-text and graph retrieval, and answers with provenance. Scope: memory:read.

It returns evidence, not prose. Every response carries results[] (each with a universal_id, a score and a preview), freshness[], cited_graph_url, and memory naming which office answered:

{
  "results": [
    {
      "universal_id": "gmail_messages:18f2c9a...",
      "score": 0.412,
      "title": "Re: tier pricing",
      "preview": "Agreed: Solo goes to $19.99/seat from July.",
      "source_table": "gmail_messages"
    }
  ],
  "freshness": [{ "source_id": "google-workspace", "last_success_at": "2026-08-26T18:02:00Z" }],
  "cited_graph_url": "https://mitosislabs.ai/graph?office=4d38b034-...&cite=gmail_messages%3A18f2c9a...",
  "memory": { "office_id": "4d38b034-...", "office_name": "Mitosis Labs" }
}

It may also carry memory_state, source_gap or possible_source_gap, which say why an answer is thin. Read them before composing a reply: see reading the response and handling a gap.

cortex_recall

Semantic-only vector search returning source excerpts. Prefer cortex_ask unless you specifically want nearest-neighbour matches on meaning. Scope: memory:read.

cortex_manifest

An index of the memory: counts and source names, never content. Takes no arguments. Scope: memory:read.

cortex_status

Ingestion and feed status, including backlog. Use it to explain why a freshly-connected source is not answering yet. Scope: memory:read.

cortex_connectable_sources

Lists sources the user has not connected, and what each would answer. No arguments. Scope: memory:read.

cortex_connect_link

Returns the connect link for one source. Scope: memory:read.

cortex_remember

Saves one durable fact into the graph. Scope: memory:write.

cortex_ingest

Pushes a document into the memory so its text is searchable. Scope: memory:write.

This is how an agent adds a file the user handed it (a CSV, a note, an export). Pass the text; this HTTP server cannot read a local filesystem path. The stdio server (mi-cortex-mcp) also accepts path / paths and reads those files from disk.

{
  "filename": "investors.csv",
  "content": "name,email\nAda,[email protected]\n"
}

A new source waits for Standard or a described goal. The response carries choice; when choice.choice_required is true, record the user's answer with cortex_choose_enrichment.

cortex_ingest_conversation

Ingests a whole conversation so the exchange itself becomes retrievable. Scope: memory:write.

{
  "turns": [
    { "role": "user", "text": "What did we decide about pricing?" },
    { "role": "assistant", "text": "Solo moved to $19.99/seat in July 2026." }
  ],
  "session_id": "chat_01H9X...",
  "title": "Pricing decision"
}

Exclude tool output, hidden reasoning, connect links, exchanges where you could not answer, and anything resembling a credential. Split a very long conversation across calls, reusing the same session_id.

cortex_choose_enrichment

Records what the user wants pulled out of a source: Standard, or one or more saved goals. A new source waits until this is answered. Scope: memory:write.

cortex_list_goals

Lists saved goals this office already asked Mitosis to pull out. Last-used first. Pass chosen ids as goal_ids to cortex_choose_enrichment. No arguments. Scope: memory:read.

cortex_create_goal

Designs a goal from the user's own words and returns a read-back of what Mitosis understood, with a real example from their data. When the goal leaves something Mitosis cannot decide, the reply carries answer_required: true and one round of questions, each with the options it can act on.

Designing a goal extracts nothing. Designing, saving, and running are three separate operations. Scope: memory:write.

cortex_answer_goal

Records the answer to the questions from cortex_create_goal, keyed by question id. {"*":"skip"} is the answer for a user who says to go ahead with whatever Mitosis thinks best.

This is the last round. The reply carries answer_required: false and no further questions: Mitosis asks about a goal once. Scope: memory:write.

cortex_accept_goal

Saves a settled goal into the memory's goal library with the recipe it was designed with, and returns its goal id. Still extracts nothing: cortex_choose_enrichment with choice=describe_goal and that id in goal_ids is what runs it on a source. Scope: memory:write.

Search and fetch

Present for clients that expect the search / fetch pair. ChatGPT in particular refuses a server whose search and fetch it cannot see.

Public tools

No credential. Safe to call before any sign-in, and useful as a connectivity check.

Resources