SurrealDB Agent Memory connects to agents through HTTP, MCP, official SDKs, and harness adapters that mirror conversation turns into POST /api/v1/{context_id}/facts/batch, using the same provenance and trust model as the server.
The REST surface is described by an OpenAPI specification. The Python, TypeScript, Swift, and Kotlin clients track that spec so request and response shapes stay aligned with the server.
MCP server (coding assistants)
Native MCP at /mcp on the api port, with the same Authorization: Bearer auth as REST. Prefer this when the client already speaks MCP. Point the client at your instance's /mcp endpoint, or install it with install-mcp:
npx install-mcp https://<your-context-host>/mcp \
--client cursor \
--header "Authorization: Bearer <your-api-key>" --oauth no→ MCP server install · Per-client guides: Claude · Cursor · VS Code · JetBrains · Zed · Windsurf · Codex · Antigravity · OpenCode
SDKs
Call SurrealDB Agent Memory directly from application code.
| Language | Package |
|---|---|
| Dart | surrealdb (import spectron.dart) |
| Elixir | :surrealdb (SurrealDB.Spectron) |
| Go | spectron package in surrealdb.go |
| Haskell | surrealdb-spectron |
| JavaScript / TypeScript | @surrealdb/spectron |
| Kotlin | bundled in com.surrealdb:kotlin |
| Python | surrealdb (SurrealDB Agent Memory ships inside it) |
| Swift | Spectron product in surrealdb.swift |
→ Dart · Elixir · Go · Haskell · JavaScript & TypeScript · Kotlin · Python · Swift
AI SDKs
Drop-in memory for the popular TypeScript AI SDKs, with recall and storage wrapped around your model calls.
Cloudflare Workers AI: the client inside a Worker, alongside Workers AI models.
TanStack AI: the
@surrealdb/spectronclient in TanStack Start server routes.Vercel AI SDK:
@surrealdb/spectron-vercel-ai, viawrapLanguageModelmiddleware and a tool set.
→ Cloudflare Workers AI · TanStack AI · Vercel AI SDK
Agent frameworks
Harness adapters expose SurrealDB Agent Memory as agent tools and add automatic per-turn memory, without changing your prompts.
| Framework | Package | Language |
|---|---|---|
| CrewAI | spectron-crew-ai | Python |
| Eve | @surrealdb/spectron-eve | TypeScript |
| Google ADK | spectron-google-adk | Python |
| Hermes Agent | spectron-hermes | Python |
| LangChain / LangGraph | @surrealdb/langchain, @surrealdb/langgraph | TypeScript |
| Mastra | @surrealdb/mastra-ai | TypeScript |
| OpenAI Agents SDK | spectron-openai-agents-sdk | Python |
| OpenClaw | @surrealdb/spectron-openclaw | TypeScript |
| Pydantic AI | spectron-pydantic-ai | Python |
| Strands Agents | spectron-strands-agents | Python |
→ CrewAI · Eve · Google ADK · Hermes Agent · LangChain · Mastra · OpenAI Agents SDK · OpenClaw · Pydantic AI · Strands Agents
Frameworks without a dedicated package integrate directly through the SDK: Agno · AutoGen · Camel AI · LlamaIndex
Voice & realtime
Give voice agents memory that persists across calls.
→ ElevenLabs · LiveKit
Automation
n8n: the
@surrealdb/n8n-nodes-surrealdbcommunity node, plus SurrealDB Agent Memory over the REST API.Zo Computer: a Zo skill that calls the SurrealDB Agent Memory SDK for recall and storage.
→ n8n · Zo Computer
Observability
Run SurrealDB Agent Memory for memory while an observability platform traces and evaluates the agent.
REST API
Direct HTTP from any language. End-user routes: /api/v1/{context_id}/…. Management: /api/v1/contexts/….
→ REST integration guide · Full reference
Not shipped yet
Embedded in-process library: use REST or an SDK against a deployed instance (Embedded quickstart).