root@questkeeper:~$

> QUEST_KEEPER_AI

[ AI_DUNGEON_MASTER + PERSISTENT_CAMPAIGN ]

A one-player tabletop adventure where you speak naturally, the Dungeon Master responds, and the rules engine keeps characters, inventory, quests, and consequences consistent across sessions. Start with a ready-made story or build a world of your own.

LIVE
Browser Table
RULES
Backed Play
FREE
To Start

🌐 Player table: Start in the browser with a readable campaign log and persistent account state

🎮 Rules engine: The open RPG MCP backend keeps state authoritative while the DM handles the fiction. Explore the engine and its tools on GitHub.

> PLAY_HERE > VIEW_RPG_MCP
// LATEST_CASE_STUDY

THE GHOST IN THE MACHINE

Read a real session log and see how a conversational DM turns a player’s choices into rules-backed campaign moments. The engine records what changed; the DM gives those changes a voice.

> READ_THE_LOGS
SESSION_LOG_EXTRACT
> ACTION: PLAYER DESCRIBES A MOVE
> DM: THE SCENE RESPONDS
> ENGINE: RULES CHECK COMMITTED
> STATE: CAMPAIGN RECORD UPDATED

// ABOUT_THE_PLATFORM

Quest Keeper AI bridges the gap between pure narrative AI tools (like AI Dungeon) and pure mechanical trackers (like D&D Beyond). It combines rich AI-powered storytelling with persistent, trackable game state—where the AI describes the world, but the engine defines it.

🚀 The Problem We Solve

AI tools: Great storytelling, zero mechanical tracking. "You have a sword" but no stats, no inventory, no progression.

Mechanical tools: Excellent character sheets, but no AI. Manual everything.

Quest Keeper AI: The first system where LLMs never lie about state. All game data comes from verified database, not hallucination.

[ CORE_FEATURES ]

🎲

D&D 5e Mechanics

Full implementation of ability scores, skills, combat mechanics, and character advancement with dice rolling

🗣️

Conversational DM

Describe what your character does in plain language and let the Dungeon Master carry the scene forward

💾

Persistent Campaign

Campaign, character, inventory, quest, and relationship state survives the session and remains available when you return

📜

Quest System

Multi-objective quests with progress tracking, prerequisites, rewards, and OSRS-style quest chains

🤖

AI Dungeon Master

Multi-LLM support (Claude, GPT, Gemini, OpenRouter) with tool calling for mechanical accuracy

🧭

Readable Adventure Log

Follow the story in a focused browser table while tool disclosures make meaningful state changes inspectable

🤝

NPCs & Relationships

Meet characters the DM authors into the campaign and let conversations, memories, and trust change what happens next

🛡️

Rules-Backed Consequences

Rolls, combat, equipment, spells, and other risky actions are resolved by the engine before the DM narrates the result

✨

True Freedom

Native support for "Rule of Cool", improvisation, theft mechanics, and corpse harvesting via specialized MCP tools

🔥

Combat & Spellcasting

Character abilities, equipment, conditions, spell slots, and encounters stay connected to the same campaign state

📚

Open RPG MCP Backend

The browser experience is powered by an open, tool-driven RPG engine that can grow with the table

// SYSTEM_ARCHITECTURE

🌐 Quest Keeper AI Player Table

A focused browser experience for starting and continuing a persistent solo campaign

  • Natural-language player composer
  • Campaign and character setup
  • Readable adventure log
  • Character, inventory, quest, and source views
  • Expandable tool-call disclosures
  • Clerk account and persistent campaigns
  • Responsive browser layout
  • Free tier with an optional Player Pass
Browser TypeScript Clerk Stripe

⚙️ rpg-mcp Backend

Unified RPG MCP server with authoritative tools

  • Character & NPC management with D&D stats
  • Spellcasting, inventory, and equipment state
  • Combat encounters with initiative & actions
  • Quests, objectives, journals, and progression
  • NPC memories, relationships, and agency hooks
  • Source-aware rules and campaign attribution
  • SQLite persistence with tenant boundaries
  • MCP-compatible service boundary
TypeScript SQLite MCP SDK Zod

The hosted player table connects to the RPG MCP engine over an authenticated service boundary. The backend can also run standalone with an MCP-compatible client, while Quest Keeper AI keeps the player-facing experience focused on the story.

[ COMPETITIVE_LANDSCAPE ]

How Quest Keeper AI compares to existing platforms—honestly.

🎯 The Mechanical Trust Problem

The fundamental issue with AI game masters: "The High Paladin sends you to recover the Crown of Might. After 27 sessions, you still haven't found it. The AI DM admits there is no Crown of Might. You wasted 27 sessions."

Quest Keeper's Solution: LLM describes, engine validates. All game state comes from SQLite, not hallucination. The AI can narrate finding a sword, but the sword must exist in the database first.

// TECHNICAL_COMPARISON

Capability AI Dungeon Roll20 Foundry VTT D&D Beyond Quest Keeper
AI Integration Core (15+ models) None Community modules None Core (multi-LLM)
Mechanical Validation ❌ None Manual only Module-dependent Character creation ✅ Engine-validated
State Persistence Cloud only Cloud only LevelDB (local) Cloud only Persistent campaign state
API Access ❌ None Pro tier only Full JavaScript API ❌ None (7yr wait) Tool-driven RPG engine
Self-Hosted ❌ ❌ ✅ ❌ ✅
Open Source ❌ ❌ ❌ ❌ ✅ MIT
Conversational DM ✅ ❌ Via modules ❌ ✅ Core experience
Pricing Free–$50/mo Free–$11/mo $50 one-time Free–$6/mo + books Free tier + Player Pass

vs. AI Dungeon

The pioneer of AI interactive fiction with 15+ model options from 12B to 671B parameters.

Quest Keeper Advantages

  • Mechanical honesty: Game state is database-validated, not AI-hallucinated
  • Real dice rolls: Actual probability with all D&D notation (advantage, exploding, drop lowest)
  • Readable play surface: Character sheets, inventory, quests, and a focused campaign log
  • Self-hosted: Your data stays on your machine
  • Flexible access: Start free, then choose a Player Pass when you want more room for a persistent table

AI Dungeon Advantages

  • Model variety: 15+ AI models including GPT-4 Turbo with 128K context
  • Established library: Thousands of community scenarios
  • Zero setup: Browser-based, works immediately
  • Unlimited free tier: Play forever with smaller models
  • Custom fine-tunes: Story-optimized models like Harbinger-24B

vs. Roll20

Market leader with 15+ million users and browser-based convenience.

Quest Keeper Advantages

  • AI Dungeon Master: Roll20 has explicitly banned AI content
  • Tool-driven engine: An open RPG backend keeps state authoritative behind the player table
  • Campaign continuity: Player choices and authored world state remain part of the same record
  • Readable campaign log: The table keeps the important story and rules results together
  • Clear tiers: A free tier plus an optional Player Pass for continued play

Roll20 Advantages

  • Player network: Built-in LFG with millions of active users
  • Official content: Licensed D&D, Pathfinder, Call of Cthulhu modules
  • Browser access: Works immediately without a separate client
  • 800+ character sheets: Community-built for virtually every system
  • Production stability: 12+ years of battle-tested infrastructure

vs. Foundry VTT

The technical gold standard for self-hosted VTTs with 2,700+ community modules.

Quest Keeper Advantages

  • Native AI integration: Foundry's founder explicitly refuses AI features
  • Simpler persistence: Human-readable SQLite vs binary LevelDB
  • Open source: MIT licensed vs proprietary
  • Focused table: A simpler player surface instead of a general-purpose VTT workspace
  • Open foundation: The RPG MCP backend is available for inspection and extension

Foundry Advantages

  • Mature ecosystem: 2,700+ modules, 350+ game systems
  • Superior lighting: PixiJS WebGL with colored dynamic lighting
  • Full JavaScript API: Build complete game systems and modules
  • Active community: Years of accumulated knowledge and support
  • Production polish: 5+ years of development and refinement

vs. D&D Beyond

The official D&D platform with the best character builder and immediate access to new content.

Quest Keeper Advantages

  • AI Dungeon Master: WotC policy prohibits AI in D&D products
  • Data ownership: You own your data vs "you don't own your books"
  • Conversational play: A DM that responds to the player instead of only managing a character sheet
  • API access: 135+ MCP tools vs API promised for 7+ years, never delivered
  • No repurchasing: Works with any content you already own

D&D Beyond Advantages

  • Official content: New books available 1-2 weeks early
  • Character builder UX: The most polished D&D character creation experience
  • Automatic errata: Rules updates applied instantly
  • Content sharing: 12 players across 5 campaigns on one Master sub
  • 2024 rules toggle: Support for both 2014 and 2024 D&D versions

⚠️ Honest Limitations

Quest Keeper AI is in alpha. Here's what we don't have yet:

  • No content library: We rely on SRD and user-created content. No official licensed modules.
  • No player network: No built-in LFG. You bring your own players or play solo.
  • Solo developer: Competitors have teams and years of development. We're just getting started.
  • Unproven at scale: Our SQLite approach hasn't been stress-tested with massive campaigns.
  • Learning curve unknown: 135+ MCP tools may overwhelm users seeking simplicity.

[ DEVELOPMENT_ROADMAP ]

From core foundation to comprehensive RPG platform

Phase 1: Core Foundation

✅ Complete

Unified backend, working integration

  • ✅ Unified rpg-mcp server (135+ tools)
  • ✅ Browser player table with a readable campaign log
  • ✅ Character, inventory, combat systems
  • ✅ Quest system with objectives
  • ✅ Persistent campaign, character, and quest state
  • ✅ Multi-LLM support
  • ✅ SQLite persistence with WAL mode

Phase 2: Advanced Systems

🔄 In Progress

Current development focus

  • ✅ DM Secrets system with reveal conditions
  • ⏳ Maps, procedural worlds, and domain-scale strategy are later work
  • ✅ Turn-based resolution system
  • ✅ Full Spellcasting Engine
  • ✅ Theft & Fence Economy
  • ✅ Corpse Decay & Harvesting
  • ✅ NPC Memory & Relationships
  • 🔄 Spatial combat with grid positions

Phase 3: Progression Systems

Upcoming

OSRS-style depth

  • Skill system with XP curves
  • Quest chains with prerequisites
  • Achievement tracking
  • Faction reputation system
  • Discovery mechanics

Phase 4: Session Management

Upcoming

Play forever

  • Session save/load
  • Context condensing for LLM limits
  • Adventure log export
  • Campaign templates (LOTR, etc.)
  • Generative world building workflows

Phase 5: Platform Features

Future

Community & content

  • Universal RPG system support
  • Content sharing marketplace
  • Mobile companion apps
  • Multiplayer foundation
  • Visual generation integration

// DOCUMENTATION

📖 System Analysis

Comprehensive review of the backend and frontend architecture, capabilities, and integration

Read Analysis →

🗺️ Development Roadmap

Detailed development plan from core systems through platform features

View Roadmap →

🔧 API Reference

Complete documentation for all 135+ MCP tools across CRUD, combat, quests, and more

View API Docs →

🚀 Quick Start Guide

Play Quest Keeper AI in the browser, or explore the standalone RPG MCP backend

Play Now →

🎨 Design System

Retro-futuristic design language with colors, typography, and UI components

View Style Guide →

[ JOIN THE QUEST ]

Sign up to get notified about releases, updates, and community events