Palace overview — total drawers, wing and room counts

List all wings with drawer counts

List rooms within a wing (or all rooms if no wing given)

Full taxonomy: wing → room → drawer count

Get the AAAK dialect specification — the compressed memory format MemPalace uses. Call this if you need to read or write AAAK-compressed memories.

Query the knowledge graph for an entity's relationships. Returns typed facts with temporal validity. E.g. 'Max' → child_of Alice, loves chess, does swimming. Filter by date with as_of to see what was true at a point in time.

Add a fact to the knowledge graph. Subject → predicate → object with optional time window. E.g. ('Max', 'started_school', 'Year 7', valid_from='2026-09-01').

Mark a fact as no longer true. E.g. ankle injury resolved, job ended, moved house.

Chronological timeline of facts. Shows the story of an entity (or everything) in order.

Knowledge graph overview: entities, triples, current vs expired facts, relationship types.

Walk the palace graph from a room. Shows connected ideas across wings — the tunnels. Like following a thread through the palace: start at 'chromadb-setup' in wing_code, discover it connects to wing_myproject (planning) and wing_user (feelings about it).

Find rooms that bridge two wings — the hallways connecting different domains. E.g. what topics connect wing_code to wing_team?

Palace graph overview: total rooms, tunnel connections, edges between wings.

Create a cross-wing tunnel linking two palace locations. Use when content in one project relates to another — e.g., an API design in project_api connects to a database schema in project_database.

List all explicit cross-wing tunnels. Optionally filter by wing.

Delete an explicit tunnel by its ID.

Follow tunnels from a room to see what it connects to in other wings. Returns connected rooms with drawer previews.

Semantic search. Returns verbatim drawer content with similarity scores. IMPORTANT: 'query' must contain ONLY search keywords. Use 'context' for background. Results with cosine distance > max_distance are filtered out.

Check if content already exists in the palace before filing

File verbatim content into the palace. Checks for duplicates first.

Delete a drawer by ID. Irreversible.

Fetch a single drawer by ID — returns full content and metadata.

List drawers with pagination. Optional wing/room filter. Returns IDs, wings, rooms, and content previews.

Update an existing drawer's content and/or metadata (wing, room). Fetches existing drawer first; returns error if not found.

Write to your personal agent diary in AAAK format. Your observations, thoughts, what you worked on, what matters. Each agent has their own diary with full history. Write in AAAK for compression — e.g. 'SESSION:2026-04-04|built.palace.graph+diary.tools|ALC.req:agent.diaries.in.aaak|★★★'. Use entity codes from the AAAK spec.

Read your recent diary entries (in AAAK). See what past versions of yourself recorded — your journal across sessions.

Get or set hook behavior. silent_save: True = save directly (no MCP clutter), False = legacy blocking. desktop_toast: True = show desktop notification. Call with no args to view.

Check if a recent palace checkpoint was saved. Returns message count and timestamp.

Force reconnect to the palace database. Use after external scripts or CLI commands modified the palace directly, which can leave the in-memory HNSW index stale.