Igor Lins e Silva
0cb9ee5c58
- 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
127 lines
3.8 KiB
Markdown
127 lines
3.8 KiB
Markdown
# MCP Integration
|
|
|
|
MemPalace provides 29 tools through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/), 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:
|
|
|
|
```bash
|
|
mempalace mcp
|
|
```
|
|
|
|
### Manual Connection
|
|
|
|
```bash
|
|
claude mcp add mempalace -- python -m mempalace.mcp_server
|
|
```
|
|
|
|
### With Custom Palace Path
|
|
|
|
```bash
|
|
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](/guide/openclaw)
|
|
- **ChatGPT** — via MCP bridge
|
|
- **Cursor** — native MCP support
|
|
- **Gemini CLI** — see [Gemini CLI guide](/guide/gemini-cli)
|
|
|
|
## 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 |
|
|
|
|
### 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 |
|
|
|
|
### 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 |
|
|
|
|
### 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](/reference/mcp-tools).
|