The tool catalog¶

This is a reference to the MCP tools Aletheia exposes, grouped by purpose. Your connected client discovers the full, current set automatically — this catalog is here so you know what's possible and which tool to reach for. Every tool operates on your workspace only, returns a consistent result envelope, and paginates large results.

You usually don't call these by hand

In chat — and in a connected assistant — you ask in plain English and the model picks the tools. This catalog is for understanding the surface and for power users scripting against it.

The MCP Integration panel under Settings. — A connected client discovers this whole surface automatically — you wire it up once under Settings → Integrations.

Workflow tools¶

Higher-level compositions that do real work in one call — what chat reaches for first.

Tool	What it does
`synthesize_topic`	Research a topic across the corpus and write a synthesized summary
`find_relationships`	Reason about how a set of notes relate
`trace_connections`	Find and explain the multi-hop path between two things
`build_timeline`	Assemble a temporal narrative about a subject
`find_notes`	Smart note discovery for a natural-language ask
`find_quotes`	Pull the key quotes on a topic
`find_contradictions`	Surface conflicting statements in the corpus
`whats_on_my_plate`	Your open action items, curated to you

Retrieval tools¶

The core search primitives (the app's Search surface is built on these).

Tool	What it does
`search_hybrid`	Fused keyword + semantic search (the default)
`search_lexical`	Exact keyword (BM25) search
`search_semantic`	Meaning-based (embedding) search
`search_chunks`	Search at passage granularity
`find_bridges`	Find connecting notes between two sets

A search result card, the app-side view of the retrieval tools. — The retrieval tools power the app's Search: **①** Preview a note · **②** matched chunks show which passages a query hit.

Note & notebook access¶

Tool	What it does
`get_note`	A full note plus its extracted companions
`get_note_chunks`	A note's passages
`get_notes_batch` / `note_titles`	Fetch many notes, or just their titles (for rendering citations)
`list_notebooks`	The notebook hierarchy
`getting_started`	Onboarding guidance + sample queries

Graph & connections¶

Tool	What it does
`get_linked_notes` / `get_backlinks`	Outgoing / incoming connections
`get_neighborhood`	Everything within N hops of a note
`find_path`	The shortest path between two notes

Tags & entities¶

Tool	What it does
`list_tags` / `get_notes_by_tag`	Browse tags; notes under a (hierarchical) tag
`get_related_tags` / `get_tag_timeline`	Co-occurring tags; usage over time
`list_entities` / `get_entity`	Browse entities; a single entity's detail
`get_notes_by_entity`	Notes mentioning an entity
`get_entity_cooccurrences` / `get_entity_timeline`	Who/what co-occurs; mentions over time

Action items & analytics¶

Tool	What it does
`get_action_items`	Action items by assignee / status / date (`"me"` resolves to you)
`create_action_item` / `update_action_item` / `set_action_item_status`	Manage to-dos
`detect_contradictions`	Find conflicting statements
`get_attribution_audit`	Speaker attribution for transcript notes

Writing to the corpus¶

Tool	What it does
`create_note` / `append_to_note`	Create a note; add to one
`update_note` / `insert_into_note` / `replace_in_note`	Full or surgical edits
`delete_note` / `restore_note`	Soft-delete; restore from Trash
`set_note_starred` / `add_note_tag` / `remove_note_tag`	Star; tag management
`create_notebook` / `rename_notebook` / `move_notebook` / `delete_notebook`	Notebook management

Content: revisions, attachments, diagrams¶

Tool	What it does
`list_note_revisions` / `get_note_revision` / `restore_note_revision`	Note history
`list_note_attachments` / `get_attachment`	A note's attachments
`list_diagrams` / `get_diagram` / `upsert_diagram`	Interactive diagram operations

Time & metadata¶

Tool	What it does
`get_notes_in_range`	Notes created within a date range
`search_by_metadata`	Pure filter query — no search text

Prefer surgical writes over full rewrites

When an assistant edits a note, insert_into_note / replace_in_note (change one section) keep revision history legible and reduce the blast radius of a bad edit, versus update_note replacing the whole body. This matters because MCP write tools act on your real corpus.

Next: Appearance & themes →