mempalace/website/guide/mcp-integration.md

MCP Integration

MemPalace provides 19 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 19 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:

1. On wake-up: Call mempalace_status to load the palace overview
2. Before responding about any person, project, or past event: search first, never guess
3. If unsure: Say "let me check" and query the palace
4. After each session: Write diary entries to record what happened
5. 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

Palace (write)

Tool	What
mempalace_add_drawer	File verbatim content
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

Navigation

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

Agent Diary

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

For detailed schemas and parameters, see MCP Tools Reference.