readmedbv0.4
MCP v0.4 · 16 tools · Open source

Stop re-explaining
your codebase.

readmedb gives your AI agents a persistent file store. They write conventions.md, todo.md — and read them back next session.

Free plan, no card30 second setupWorks with Cursor, Claude Code, Windsurf
Agentwrite →

Cursor writes

# wrapping up
write_file("conventions.md")
append_to_file("todo.md")
patch_file("architecture.md")
✓ 3 files saved · session ends
readmedb · default

Your memory

Click a file to preview →
← readPreview

conventions.md

# Conventions
— kebab-case routes
— PascalCase components
— Drizzle ORM, no raw SQL
— Tailwind, no CSS-in-JS
3 files saved · context preserved for next session
Works insideCursorClaude CodeWindsurfCodexAny MCP client
How it works

Three steps. Your agent never forgets again.

01

Connect once

Drop one config block into Cursor, Claude Code, or Windsurf. Restart your editor — your agent gains a filesystem.

# mcp.json
"readmedb": {
  "url": "app.readmedb.com/api/mcp",
  "auth": "Bearer rdb_…"
}
16 tools ready
02

Agent writes

As your agent works, it saves what matters — conventions, open tasks, architecture notes — into plain markdown files.

# Mon · session end
write_file("conventions.md")
append_to_file("todo.md")
patch_file("arch.md")
3 files saved
03

Reads next time

New session, new chat — your agent reads its own notes back, and picks up exactly where it left off.

# Tue · session start
read_files(["conventions.md",
  "todo.md", "arch.md"])
  ↳ 1.4 KB · 812 B · 3.1 KB
Context loaded
What it can do

Three jobs. Sixteen tools.
Zero ceremony.

Save things.

Your agent writes plain markdown files. Notes, decisions, conventions — anything it needs to remember next time.

writeappendpatchmovedelete

Find them again.

Full-text search, bulk reads, list-by-recency. Your agent finds what's relevant without re-reading the whole vault.

searchfetch for taskreadlistchanged since

Travel back in time.

Every file keeps its full version history. Diff, inspect, or restore an earlier version with one tool call.

historyread versiondiffrestore

Want the raw tool reference? See all 16 tools →

Not quite like the others

Your agent writes the memory.
Not an ML pipeline.

You're here

readmedb

  • Agent writes explicit .md files
  • Every memory readable and editable
  • Works across all MCP clients
  • Version history on every file
  • No embeddings, no black box

ML memory pipelines

  • ~Pipeline extracts memories
  • ~Embeddings you can't inspect
  • ~Works across sessions
  • You don't control what's saved
  • Not file-based

Long system prompt

  • ~You write it manually
  • ~You can read and edit it
  • Bloats every context window
  • Doesn't persist across machines
  • No versioning
Pricing

Free until you outgrow it.

Free

£0forever

No card required.

  • 3 API keys
  • 50 files per key
  • 5 MB storage
  • 30 day version history
Start free
Most popular

Pro

£5/ month

Most developers hit the free limit within a week.

  • Unlimited API keys
  • Unlimited files
  • 50 GB storage
  • Version history forever
Upgrade to Pro

Need more? Enterprise plans available — contact us.

One config line away from remembering everything.

Get started free

Free plan · No card required · Works in 30 seconds