Documentation

Get Started

Bardo Documentation

Start with local install, .bardo prep, client connection, and the local-first runtime surface.

Bardo is a TTRPG MCP for turning MCP-capable AI clients into grounded tabletop role-playing Game Masters.

Your workspace is the source of truth. .bardo/ is the only Bardo-managed local folder. Local MCP and CLI usage is free and open. Bardo Pro is the subscribed cloud connection layer for using Bardo from supported external AI platforms such as ChatGPT, Claude Web, and other supported places.

What Bardo CoversLink to what-bardo-covers

  • Prepare local campaign state from rules, sessions, characters, locations, and notes.
  • Expose grounded tools through a local stdio MCP server.
  • Keep corrections and continuity in .bardo/ artifacts.
  • Generate client configuration for supported local AI tools.
  • Push AI clients toward evidence-first play, explicit uncertainty, and correction-safe state changes.
  • Keep the local path separate from the subscribed cloud connection layer.

Recommended PathLink to recommended-path

  1. Put your campaign files in a workspace.
  2. Add a Markdown rulebook, such as RULEBOOK.md.
  3. Run bardo init --rulebook ./RULEBOOK.md.
  4. Run bardo validate.
  5. Run bardo connect --client <your-client>.
  6. Open your AI client in the same workspace.

Start the agent by asking it to check Bardo workspace status. If Bardo reports readiness gaps, add or update campaign notes before continuing play.