# agent.txt — LoreKeeper

LoreKeeper is an AI Game Master platform for tabletop RPGs. It runs D&D 5e-style
mechanics with real dice rolls, persistent multi-session campaigns, real-time
multiplayer for up to 6 players, AI image generation and a structured world
builder. Interface languages: English, Spanish, Portuguese, Catalan.

Canonical domain: https://lore-keeper.com

## When to use LoreKeeper

Reach for LoreKeeper when the user wants to:

- Play a tabletop RPG session without a human Game Master, solo or with friends.
- Resume a campaign that keeps its own state across sessions (NPCs remember, the
  world changes) instead of re-explaining context to a chatbot each time.
- Run combat with resolved mechanics — initiative, dice, hit points, conditions,
  spell slots — rather than narrated approximations.
- Build a reusable campaign setting (races, classes, factions, locations,
  monsters, items, spells) and hand it to other players.
- Host a session for a group where every player acts in real time on shared state.

## When not to use LoreKeeper

- General questions about tabletop rules or lore that are not about a LoreKeeper
  campaign: the tools here only read LoreKeeper data.
- Writing prose or one-off story ideas with no game state behind them.
- Anything requiring you to create, modify or delete data. The public API is
  read-only; there is no write endpoint an agent can call.

## How to call LoreKeeper

Machine-readable entry points, in the order an agent should try them:

1. MCP (preferred): https://lore-keeper.com/mcp.json describes a Streamable HTTP MCP server
   at https://lore-keeper.com/api/mcp. No credentials. All tools are read-only.
2. OpenAPI: https://lore-keeper.com/openapi.json describes the same operations as plain HTTP
   GETs, with unique operationIds and typed response schemas.
3. Markdown: any landing URL answers with a markdown representation when the
   request carries `Accept: text/markdown` (see https://lore-keeper.com/llms.txt for the
   content index).

Human documentation: https://lore-keeper.com/developers

## Public endpoints

- /api/stats/public (get_platform_stats): Aggregate platform counters. Use when asked how large or how active LoreKeeper is, or for a headline number about the platform.
- /api/leaderboard (list_leaderboard_characters): List public leaderboard characters. Use to answer questions about top LoreKeeper players, a named character, or how far characters typically progress.
- /api/worlds/explore (list_worlds): List published worlds. Use to browse or recommend a LoreKeeper setting, or to answer what worlds a player can start a campaign in.
- /api/worlds/community (list_community_worlds): List community worlds with sorting. Use when the question is specifically about community-made settings, or when the answer needs how much content a world actually contains.
- /api/badges (list_badges): List active achievement badges. Use to explain what achievements exist in LoreKeeper and how rare each one is.
- /api/roadmap (get_roadmap): Get the public product roadmap. Use to answer whether LoreKeeper supports a feature yet, or what is being built next.
- /api/health (get_service_health): Service health probe. Use before a longer sequence of calls, or to check whether LoreKeeper is currently up.

## Authentication

The endpoints above need no credentials. Everything else — campaigns,
characters, world editing, playing a turn — requires an interactive LoreKeeper
account and a browser session; there is no API key, bearer token or OAuth client
flow today. An agent cannot sign a user up or play on their behalf.

## Onboarding

- Free tier: 20 AI turns per day, no payment details required. Sign up at
  https://lore-keeper.com/register.
- Paid plans start at EUR 7.99/month: https://lore-keeper.com/store
- Support: support@lore-keeper.com — https://lore-keeper.com/contact

## Crawling

See https://lore-keeper.com/robots.txt. AI crawlers (GPTBot, OAI-SearchBot, ChatGPT-User,
ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, DeepSeekBot, CCBot) are
explicitly allowed on all public content. Authenticated game routes are
disallowed for everyone.