
Ratary Memory MCP
io.github.ontorataPublished by GitHub account ontoratav1.1.1Updated Oct 25, 2026
Persistent coding memory for AI assistants. MCP stdio, hybrid search, graph, context.
The publisher's own server: Memory.fit
Overview
Ratary Memory MCP gives an AI assistant persistent, searchable memory backed by a Ratary server, so context survives across sessions and IDEs.
- What you can do
- Save, update and organize durable memories with summaries, codenames, favorites, archives and handoffs, plus version history with restore and merge (per the README's 28 tools). Search memories with hybrid retrieval across SQL, vectors, lexical index and graph, with optional precision modes. Assemble token-efficient context for prompts, separating browsing from injection. Link memories into structured knowledge and traverse relations as a graph. Scope work by workspace and agent so multiple clients share one memory layer.
- When to use it
- Useful when a coding assistant or agent should recall earlier decisions, project context and handoffs between sessions, or when several clients (Cursor, Claude Code, custom agents) should share one durable memory store instead of re-pasting background.
- Requirements
- Runs locally as a stdio process via the npm package @ratary/mcp-server (npx), so Node.js is needed. Requires a Ratary server to talk to: either self-hosted (Node.js 24 plus a SQL metadata store such as Postgres) or the hosted API. Set RATARY_API_KEY (an aic_ key) and optionally RATARY_BASE_URL, which defaults to the hosted endpoint.
Installation
In SourceWeft
- Open Ratary Memory MCP in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
Ratary
Build AI that remembers.
Ratary is the open-source AI Brain Platform — persistent memory,
structured knowledge, and intelligent retrieval for every model and agent you run.
Get started → · Star on GitHub · Website · Docs
[MIT License] [MCP native] [Self-host] [Node 24] [@ratary/sdk on npm] [@ratary/cli on npm] [@ratary/mcp-server on npm]
Ratary is where AI remembers. · Built by Ontorata
Quick start · Ecosystem · Architecture · How it works · Capabilities · Docs
The problem
Why does AI forget between sessions?
Every AI session starts from zero.
Your model forgets yesterday's architecture decisions. Your agent drops customer context between runs. Your coding assistant can't recall why you chose Postgres over DynamoDB. Teams paste the same background into Cursor, Claude, ChatGPT, and custom bots — and knowledge still drifts.
Vector databases store chunks. RAG pipelines retrieve documents. Agent frameworks orchestrate tools.
None of them give AI a durable brain.
Why Ratary exists
Why build a brain layer now?
AI models are getting cheaper. Context windows are getting larger. Agents are getting capable.
But AI still forgets.
The bottleneck is no longer reasoning. It's memory — durable, structured, retrievable, and owned by you.
Every serious application eventually needed a database. Every serious AI system will need a brain layer: persistent intelligence that sits between your models and your storage — independent of any single vendor, IDE, or agent framework.
AI should remember.
Developers should own that memory.
Ratary exists to be that layer. Applications bring models. Ratary brings the brain.
What Ratary is
What is Ratary?
Ratary is an AI Brain Platform — infrastructure that gives AI:
- Persistent memory — durable, owner-scoped, versioned
- Structured knowledge — metadata, relations, graph traversal
- Intelligent retrieval — hybrid search + bounded context assembly
- Protocol access — Ratary MCP, REST, optional gRPC
It sits between AI clients and storage. One brain, many surfaces — Cursor, Claude Code, custom agents, enterprise APIs, and remote MCP hosts.
The runnable deployment is Ratary Server — this repository. Ratary is the product; Ratary Server is what you clone and run.
Bring your model. Ratary brings the memory.
Quick start
How do I run Ratary Server locally?
Ratary is the product. Ratary Server is the open-source deployment you run — ontorata/ratary (this repository). @ratary/sdk, @ratary/cli, and Ratary MCP connect to it; sibling Ontorata products use the same source of truth.
Prerequisites: Node.js 24 · SQL metadata store (pick one — Postgres is the template default)
Path A — PostgreSQL (npm + local or Docker)
Or use Docker: docker compose --profile postgres up --build — see docs/DOCKER.md.
Path B — Cloudflare D1
Details: docs/GUIDE.md · docs/CONFIGURATION.md
→ API http://localhost:9876 · Swagger /docs
First REST call: bootstrap once to get an API key (aic_...) — see GUIDE — First REST API key.
Full guide: docs/GUIDE.md · SDK & MCP examples in docs/examples/
npm packages (@ratary)
Client libraries ship on npm under the @ratary scope — product name, published by Ontorata. No server clone required for SDK, CLI, or hosted MCP.
Set RATARY_BASE_URL and RATARY_API_KEY (aic_...). Details: packages/README.md · remote MCP install.
Ecosystem
Which repository owns what?
The Visual architecture diagram shows logical layers inside Ratary Server. This diagram shows repository and product relationships — what ships in this repo, what connects to it, and what lives in sibling Ontorata repositories. Both views describe the same platform from different angles.
Throughout this README, Ratary MCP means the official memory MCP implementation (stdio in this repo · npm @ratary/mcp-server for hosted REST). It is not the same as Ontorata MCP (ecosystem gateway — separate repo).
Infrastructure (ships from ontorata/ratary — server plus client packages):
Ecosystem products (separate repositories — connect to Ratary Server; not bundled here):
Ratary Server does not depend on ecosystem product repositories.
Ratary MCP vs Ontorata MCP
Which MCP should I install?
Use Ratary MCP for direct memory access. Use Ontorata MCP for one MCP entry point across the Ontorata stack. Both use Ratary Server as source of truth.
What Ratary is not
How is Ratary different from alternatives?
Ratary complements your stack — it does not replace pgvector, LangGraph, or your agent of choice. See the Capability matrix for a feature-level comparison.
Why not just pgvector, Mem0, Letta, LangGraph, or RAG?
Visual architecture
How is Ratary Server structured internally?
This diagram shows the logical internal architecture of Ratary — how memory, knowledge, retrieval, and storage layers compose inside the platform. It is not a repository or product map.
Search browses. Retrieval injects context. Embedding enriches asynchronously — never on the CRUD hot path.
Details: docs-ai → products/ratary/roadmap/ARCHITECTURE.md
For repository and product relationships (SDK, CLI, Ratary MCP, Ontorata ecosystem repos), see Ecosystem — a separate diagram, same platform, different perspective.
How Ratary works
What happens to a memory after you save it?
- Write — Persist memory through Ratary MCP or REST.
- Enrich — Summarize, embed, and relate — asynchronously.
- Retrieve — Assemble the smallest useful context slice.
- Learn — Optional signals and consolidation improve recall over time.
- Reuse — One brain across IDEs, agents, and APIs.
Core capabilities
What can Ratary Server do today?
Memory intelligence
Durable memories with summaries, codenames, favorites, archives, and handoffs. Version history with restore and merge — built for long-running work, not chat logs.
Knowledge
Semantic enrichment, relation linking, and graph traversal. Memory becomes navigable knowledge — not a flat pile of notes.
Retrieval
Hybrid search across SQL, vectors, lexical index, and graph. Separate browse from inject. Optional precision modes (hybrid, semantic, fulltext, title) when you need more control.
Reasoning support
Progressive retrieval, token budgets, and summary-first context assembly — typically ~85% fewer tokens than dumping full memory bodies into prompts.
Learning
Quality signals, consolidation, and compression — optional pipelines that improve the brain over time without retraining your model.
External agent support
Capability manifests, workspace scoping, and 28 Ratary MCP tools. External agents discover what the brain can do; Ratary never embeds agent reasoning — see What Ratary is not.
Platform
Pluggable adapters: choose SQL metadata (Postgres, Supabase, MariaDB/MySQL, D1, TiDB/Cockroach) plus optional pgvector, R2/S3/MinIO, Azure Blob, GCS, Meilisearch, OpenSearch, Neo4j, Redis, DuckDB, ClickHouse. Same application code for every backend.
Self-host stacks: docs/DOCKER.md — postgres or enterprise (MariaDB + MinIO + Redis) profiles.
Cloud & enterprise
Self-host, deploy to Vercel, or run a control plane with metering and federation. RBAC workspaces, audit trails, SSO, and policy hooks — opt-in when you need them.
Observability
OpenTelemetry, Prometheus metrics, SLO dashboards, and cost visibility for production brains.
Developer experience
OpenAPI, npm @ratary/[email protected] · @ratary/[email protected] · @ratary/[email protected] — and one-command IDE setup (npm run setup).
Knowledge fabric (opt-in)
Ingest from external systems of record — Notion (live on hosted prod), Confluence, Google Drive, SharePoint, and Teams connectors (code complete · enable per connector via env). Webhook HMAC, incremental sync, provenance on memories. Flags: KNOWLEDGE_FABRIC_ENABLED + CONNECTOR_SYNC_ENABLED. Guides: Knowledge fabric · Production enable · Phases 32–34 in docs-ai.
Use cases
Who is Ratary for?
Capability matrix
How does Ratary compare feature-by-feature?
For category positioning, see What Ratary is not.
Documentation
Where do I read next?
Engineering knowledge (internal)
Architecture, ADRs, roadmap, phases, design history, and reviews live in the Ontorata Knowledge OS:
https://github.com/ontorata/docs-ai → products/ratary/
Operator / developer guides (this repository)
Ratary Server (ontorata/ratary — this repository):
Canonical hosted API: https://ratary.ontorata.com (self-host uses your own base URL).
Ontorata ecosystem (separate repositories — not in this tree):
Roadmap
What is shipping when?
Canonical roadmap / phase history: ontorata/docs-ai → products/ratary/roadmap/ · products/ratary/phases/
Organized by direction — not sprints. Phases 1–31 are implemented in code (gates PASS); platform modules stay opt-in via env unless noted.
Ops status (2026-07-19): Notion + fabric/federation flags on Vercel ✅ · D1 db:migrate ✅ · SDK codegen CI ✅ (workflow) · Confluence/Drive/SharePoint/Teams creds ⏳ (owner secrets) · Keycloak IdP ⏳ (auth.ontorata.com → deploy Render; prod uses Smithery API-key mode until OAuth enabled) · MCP listings mostly Listed (directory-status.md). Verify: npm run ops:verify-production · OPS-PRODUCTION-VERIFY.md
Enterprise modules ship opt-in via environment flags on Ratary Server — defaults stay lean. See ENTERPRISE-MODULES.md and CONFIGURATION.md.
Vision
What is Ratary building toward?
Today every application has a database.
Tomorrow every AI will have a brain.
Ratary is building that layer — open, portable, self-hostable, and protocol-native. Not another chat wrapper. Not another vector dump. Infrastructure for persistent intelligence.
Knowledge should accumulate. Boundaries should be respected. Agents should stay coherent across time.
If you're building AI that lasts longer than a single prompt — build on Ratary.
Bring your model. Bring your agent. Ratary brings the brain.
Ratary · where AI remembers · Ontorata · MIT License
Contributing
How do I contribute?
Ratary Server (this repo): fork ontorata/ratary → branch → npm run lint && npm run build && npm test → PR to ontorata/ratary.
Standard PR gate:
Org-memory / recall changes (maintainers with .ai/ workspace): run the full gate before merge — see docs/RATARY-VALIDATION-RUNBOOK.md:
Production ops changes (Vercel env, connectors, OAuth): see docs/OPS-PRODUCTION-VERIFY.md:
Extended governance (.ai/ phases, ADRs) lives in the development mirror — optional for contributors; docs-only and standard PRs to ontorata/ratary are welcome without the mirror.
Ontorata MCP and Ontorata Studio accept contributions in their own repositories — not via this repo.
Questions: [email protected]
Source: README.md at commit 04f6a91
Tools
0Version history
1- v1.1.1LatestSep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Other Memory integrations

Memory.fit
fit.memoryOfficial publisher
Hosted Memory.fit server that lets an AI read your training, sleep, recovery and nutrition data and write back weekly plans, targets and meal plans.
pg.ddx.io: the PostgreSQL community's memory
io.ddx.pgOfficial publisher
pg.ddx.io: the PostgreSQL community's memory's hosted MCP server, published by pg.ddx.io; no sign-in required; Streamable HTTP; 29 tools.
var.gg Naming Memory
gg.varOfficial publisher
Remote MCP server that suggests and searches code identifier names from domain concepts in Korean, Japanese, Chinese, Vietnamese and English, and exposes ERD…

Counterparts
ai.counterparts
Local-first long-term memory for Claude Code and Claude Desktop: the assistant writes notes about you and your projects and recalls them in later sessions.

LAHZE - Persian AI Memory Platform
Published by GitHub account pedramgholizadeh
LAHZE - Persian AI Memory Platform's hosted MCP server; no sign-in required; Streamable HTTP; 13 tools.