# Memory Crystal

## Docs

- [Authentication](https://docs.memorycrystal.ai/api/authentication.md): How Memory Crystal authenticates MCP and HTTP access, and which variables or headers matter in practice.
- [Error Reference](https://docs.memorycrystal.ai/api/error-reference.md): HTTP status codes, error responses, and debugging memory blocking and rate limiting.
- [Knowledge-base endpoints](https://docs.memorycrystal.ai/api/knowledge-base-endpoints.md): The HTTP endpoints that create, list, import, and query Knowledge Bases.
- [Memory endpoints](https://docs.memorycrystal.ai/api/memory-endpoints.md): The HTTP endpoints that capture, recall, search, trace, and inspect Memory Crystal state.
- [Rate Limits](https://docs.memorycrystal.ai/api/rate-limits.md): Tier-based API request limits, per-endpoint budgets, and retry strategies.
- [Changelog](https://docs.memorycrystal.ai/changelog.md): What changed in each release of Memory Crystal.
- [Context Engine](https://docs.memorycrystal.ai/concepts/context-engine.md): How Memory Crystal chooses which context to surface before a response or through the tool/API layer.
- [Knowledge Bases](https://docs.memorycrystal.ai/concepts/knowledge-bases.md): Understand how Knowledge Bases differ from conversational memory and when to use them.
- [Memory Layers](https://docs.memorycrystal.ai/concepts/memory-layers.md): Understand how short-term and long-term memory work together in Memory Crystal.
- [Memory Stores](https://docs.memorycrystal.ai/concepts/memory-stores.md): The five store types Memory Crystal uses and why each one exists.
- [Environment Variables](https://docs.memorycrystal.ai/configuration/environment-variables.md): Which variables matter, who uses them, and how they map to the install scripts, MCP servers, and backend runtime.
- [Local-First Setup](https://docs.memorycrystal.ai/configuration/local-first.md): Run Memory Crystal with a local Docker Convex data plane while keeping hosted auth and license checks.
- [Plugin Options](https://docs.memorycrystal.ai/configuration/plugin-options.md): Which OpenClaw plugin knobs exist and where they are actually defined.
- [Self-Hosting](https://docs.memorycrystal.ai/configuration/self-hosting.md): Public self-hosting paths and how they differ from local-first installs.
- [FAQ](https://docs.memorycrystal.ai/help/faq.md): Fast answers to common Memory Crystal questions.
- [Troubleshooting](https://docs.memorycrystal.ai/help/troubleshooting.md): The first places to look when setup, auth, plugin wiring, or docs-driven flows go wrong.
- [Uninstall](https://docs.memorycrystal.ai/help/uninstall.md): Safely disconnect Memory Crystal from supported runtimes and CLIs without guessing at config files.
- [Installation](https://docs.memorycrystal.ai/installation.md): Choose the universal installer, local-first mode, or a single-client install path.
- [Claude Code](https://docs.memorycrystal.ai/integrations/claude-code.md): Connect Memory Crystal to Claude Code using the current MCP path and understand what the installer actually does.
- [Claude Desktop](https://docs.memorycrystal.ai/integrations/claude-desktop.md): Connect Memory Crystal to Claude Desktop using the deprecated compatibility path documented in the repo.
- [Codex CLI](https://docs.memorycrystal.ai/integrations/codex-cli.md): Connect Memory Crystal to Codex CLI and understand both the installer path and direct MCP registration.
- [Factory Droid](https://docs.memorycrystal.ai/integrations/factory-droid.md): Connect Memory Crystal to Factory Droid using the repo's hosted MCP installer path.
- [Hermes Agent](https://docs.memorycrystal.ai/integrations/hermes-agent.md): Install Memory Crystal as a Hermes plugin with MCP tool parity.
- [MCP Server](https://docs.memorycrystal.ai/integrations/mcp-server.md): Understand the current and legacy MCP server paths, what they expose, and which client should use which path.
- [OpenClaw Plugin](https://docs.memorycrystal.ai/integrations/openclaw-plugin.md): Understand how the OpenClaw plugin captures, recalls, and wires Memory Crystal into the OpenClaw lifecycle.
- [Introduction](https://docs.memorycrystal.ai/introduction.md): Memory Crystal is a persistent memory layer that helps AI agents remember context, decisions, and workflows across sessions.
- [Pricing](https://docs.memorycrystal.ai/pricing.md): How Memory Crystal is packaged today, how plan limits show up in the repo, and what changes across tiers.
- [Quick Start](https://docs.memorycrystal.ai/quickstart.md): Get Memory Crystal working quickly, then choose hosted or local-first storage for your AI client.
- [crystal_checkpoint](https://docs.memorycrystal.ai/tools/checkpoint.md): Create a labeled checkpoint snapshot of memory state.
- [crystal_edit](https://docs.memorycrystal.ai/tools/edit.md): Update an existing memory in Memory Crystal.
- [crystal_forget](https://docs.memorycrystal.ai/tools/forget.md): Archive or permanently delete a memory.
- [Importing data](https://docs.memorycrystal.ai/tools/knowledge-bases/import.md): The public import paths for loading stable reference material into a Knowledge Base.
- [List](https://docs.memorycrystal.ai/tools/knowledge-bases/list.md)
- [Knowledge Bases](https://docs.memorycrystal.ai/tools/knowledge-bases/overview.md): The reference-data side of Memory Crystal's public tool surface.
- [Query knowledge base](https://docs.memorycrystal.ai/tools/knowledge-bases/query.md): Search within a specific Memory Crystal knowledge base by semantic similarity.
- [Tools Overview](https://docs.memorycrystal.ai/tools/overview.md): Complete reference to Memory Crystal's 18+ tools, grouped by function with decision trees and recommended usage patterns.
- [crystal_preflight](https://docs.memorycrystal.ai/tools/preflight.md): Run a pre-flight check before risky actions.
- [Dependency chain](https://docs.memorycrystal.ai/tools/reasoning/dependency-chain.md)
- [Explain connection](https://docs.memorycrystal.ai/tools/reasoning/explain-connection.md)
- [Reasoning tools](https://docs.memorycrystal.ai/tools/reasoning/overview.md): Memory graph traversal and reasoning helpers for exploring relationships, ownership, and decision archaeology.
- [crystal_what_do_i_know](https://docs.memorycrystal.ai/tools/reasoning/what-do-i-know.md): Broad topic scan over Memory Crystal memories.
- [Who owns](https://docs.memorycrystal.ai/tools/reasoning/who-owns.md)
- [Why did we](https://docs.memorycrystal.ai/tools/reasoning/why-did-we.md)
- [Recall tools](https://docs.memorycrystal.ai/tools/recall.md): The tools and backend flows that help Memory Crystal search across recent messages, durable memories, and relationships.
- [crystal_recent](https://docs.memorycrystal.ai/tools/recent.md): Fetch the most recent short-term messages.
- [Remember & edit](https://docs.memorycrystal.ai/tools/remember.md): The memory-writing side of the public tool surface: remember, checkpoint, edit, archive, and related maintenance actions.
- [Search & scope](https://docs.memorycrystal.ai/tools/search.md): How Memory Crystal searches across messages and memories while respecting channel, client, and knowledge-base boundaries.
- [Stats & diagnostics](https://docs.memorycrystal.ai/tools/stats.md): Get health metrics and memory usage statistics for Memory Crystal.
- [crystal_trace](https://docs.memorycrystal.ai/tools/trace.md): Trace a memory back to its source conversation.
- [crystal_wake](https://docs.memorycrystal.ai/tools/wake.md): Get an opening briefing for the current memory session.

## OpenAPI Specs

- [openapi](https://docs.memorycrystal.ai/api-reference/openapi.json)