Files

T

Igor Lins e Silva 0cb9ee5c58 fix(website): correct false claims and stale numbers in live docs

- Landing: replace nonexistent `mempalace remember` CLI demo with real
  `mempalace mine ./notes`
- Landing: soften unverifiable absolutes ("forever available",
  "100% recall by design", "<50 ms", "90%+ compression",
  "two-thousand-year-old", "tens of thousands of entries")
- MCP tool count: 19 → 29 across mcp-integration, claude-code, openclaw,
  and modules; expand tool overview with Drawers, Tunnels, and System
  categories to match mcp_server.py
- Wake-up token range: ~170–900 → ~600–900 in cli/api-reference/python-api
  to match cli.py help text and concept docs
- Gemini CLI: move `--scope user` before target name and add `--`
  separator so `-m mempalace.mcp_server` isn't parsed as Gemini flags

2026-04-16 23:31:35 -03:00

3.8 KiB

Raw Blame History

MCP Integration

MemPalace provides 29 tools through the Model Context Protocol (MCP), giving any MCP-compatible AI full read/write access to your palace.

Setup

Setup Helper

MemPalace includes a setup helper that prints the exact configuration commands for your environment:

mempalace mcp

Manual Connection

claude mcp add mempalace -- python -m mempalace.mcp_server

With Custom Palace Path

claude mcp add mempalace -- python -m mempalace.mcp_server --palace /path/to/palace

Now your AI has all 29 tools available. Ask it anything:

"What did we decide about auth last month?"

Claude calls mempalace_search automatically, gets verbatim results, and answers you.

Compatible Tools

MemPalace works with any tool that supports MCP:

Claude Code — native via plugin or manual MCP
OpenClaw — via official skill, see OpenClaw Skill
ChatGPT — via MCP bridge
Cursor — native MCP support
Gemini CLI — see Gemini CLI guide

Memory Protocol

When the AI first calls mempalace_status, it receives the Memory Protocol — a behavior guide that teaches it to:

On wake-up: Call mempalace_status to load the palace overview
Before responding about any person, project, or past event: search first, never guess
If unsure: Say "let me check" and query the palace
After each session: Write diary entries to record what happened
When facts change: Invalidate old facts, add new ones

This protocol is what turns storage into memory — the AI knows to verify before speaking.

Tool Overview

Palace (read)

Tool	What
`mempalace_status`	Palace overview + AAAK spec + memory protocol
`mempalace_list_wings`	Wings with counts
`mempalace_list_rooms`	Rooms within a wing
`mempalace_get_taxonomy`	Full wing → room → count tree
`mempalace_search`	Semantic search with wing/room filters
`mempalace_check_duplicate`	Check before filing
`mempalace_get_aaak_spec`	AAAK dialect reference

Drawers (read)

Tool	What
`mempalace_get_drawer`	Fetch a single drawer by ID
`mempalace_list_drawers`	List drawers with pagination

Palace (write)

Tool	What
`mempalace_add_drawer`	File verbatim content
`mempalace_update_drawer`	Update drawer content or metadata
`mempalace_delete_drawer`	Remove by ID

Knowledge Graph

Tool	What
`mempalace_kg_query`	Entity relationships with time filtering
`mempalace_kg_add`	Add facts
`mempalace_kg_invalidate`	Mark facts as ended
`mempalace_kg_timeline`	Chronological entity story
`mempalace_kg_stats`	Graph overview

Tool	What
`mempalace_traverse`	Walk the graph from a room across wings
`mempalace_find_tunnels`	Find rooms bridging two wings
`mempalace_graph_stats`	Graph connectivity overview

Tunnels

Tool	What
`mempalace_create_tunnel`	Create an explicit cross-wing tunnel
`mempalace_list_tunnels`	List all explicit tunnels
`mempalace_delete_tunnel`	Delete an explicit tunnel
`mempalace_follow_tunnels`	Follow tunnels out from a room

Agent Diary

Tool	What
`mempalace_diary_write`	Write AAAK diary entry
`mempalace_diary_read`	Read recent diary entries

System

Tool	What
`mempalace_hook_settings`	Get or set hook behavior
`mempalace_memories_filed_away`	Check whether the last checkpoint was saved
`mempalace_reconnect`	Force reconnect to the database

For detailed schemas and parameters, see MCP Tools Reference.

3.8 KiB Raw Blame History