MCP tools

The OpenBrain MCP server registers these tools (snake_case names for Node/cutover parity):

Tool	Purpose
memory_ingest	Store a new memory (optional subjectKey)
memory_search	Semantic search with optional filters (filter.subjectKey, metadata)
memory_get	Fetch one memory by id
memory_update	Update content/metadata/subjectKey (admin)
memory_delete	Soft-delete (admin)
memory_upsert	Keyed upsert by column-backed externalKey
memory_ingest_batch	Batch ingest or upsert (per-item subjectKey)
memory_stats	Faceted counts for the current organization (optional filter.subjectKey)
memory_changes	Incremental changes since an ISO-8601 timestamp (optional filter.subjectKey)
memory_recent	Most recently stored memories (optional filter.subjectKey)
openbrain_health	Readiness probe (database + embeddings; cached with the public health checks)

Write tools that accept content (memory_ingest, memory_upsert, memory_ingest_batch item content, memory_update) reject bodies longer than OPENBRAIN_MAX_CONTENT_LENGTH (default 100000 UTF-8 characters) with an MCP tool error. The same cap applies on REST (422) and is enforced again inside the memory writer so dashboard and webhook paths cannot bypass it.

See Connect your AI app for non-technical setup, or MCP setup (technical) for manual configuration.