Prerequisites

Node 22+. That's it.

Install

# Interactive: walks you through DB path, port, MCP wiring, key minting.
npx -y ledric init

# Or skip the prompts — same flow, all defaults:
npx -y ledric init --yes

init writes a ledric.config.json, patches your project's .mcp.json so Claude Code picks up the server, mints admin + reader API keys, drops them into .env.local, and adds the usual entries to .gitignore.

Run

npx ledric serve            # MCP stdio only — perfect for Claude Desktop
npx ledric serve --gui      # also: HTTP API + admin GUI at http://127.0.0.1:3000/admin

A ./ledric.db file appears next to you. The admin GUI is at http://127.0.0.1:3000/admin — paste the admin key from .env.local to get in.

Verify

From Claude Code in this directory:

What MCP tools do you have access to right now?

Claude should list the 20 ledric tools. If it doesn't, restart Claude Code (MCP discovery happens at session start) or check that .mcp.json exists in this directory.

From curl:

curl http://localhost:3000/types
# the full content model — empty types[] on a fresh install

Next

  • Concepts — type / entry / slug / version / ref in five minutes.
  • Build with an agent — end-to-end walkthrough where Claude designs a schema, drafts content, and builds the consumer site.
  • Build with an agent — PHP — same flow against a PHP consumer.
  • Schema — the field-type catalogue if you'd rather code your model than chat your way there.