Grimoire

Gestiona bases de datos de campañas TTRPG, wiki y grafos de conocimiento

GitHub
1
Prueba este MCPPatrocinado

Documentación

Grimoire MCP

Tu campaña como una base de datos viva que tu IA lee y escribe, no archivos markdown que mantienes.

Endpointhttps://api.ttrpg.bot/mcp
TransporteHTTP Streamable (especificación MCP 2025-06-18)
AutenticaciónOAuth 2.1 con PKCE, flujo de consentimiento de un clic
Herramientas52 en 8 grupos (21 de lectura, 31 de escritura)
Registrobot.ttrpg/grimoire en el Registro oficial de MCP
Aplicación webhttps://www.ttrpg.bot

¿Qué es Grimoire?

Grimoire es un gestor de campañas para D&D y juegos de rol de mesa que le da a tu IA un estado de campaña en vivo en lugar de archivos markdown planos que mantener sincronizados. Una campaña en Grimoire es una base de datos tipada, no una carpeta de notas: PNJs, facciones, ubicaciones, misiones, sesiones y tradición, conectados por relaciones y grafos de conocimiento, con una wiki colaborativa cuyas páginas enlazan a esos registros. El servidor MCP alojado permite que cualquier cliente conectado lea y escriba esa base de datos directamente, para que la IA responda desde tu canon actual y se mantenga coherente a medida que la campaña cambia entre sesiones.

La diferencia con una carpeta de archivos de campaña es lo que la IA recibe. Una búsqueda de archivos devuelve prosa que puede estar desactualizada. Grimoire devuelve estado tipado: el líder actual de una facción, los hilos argumentales abiertos y cuántas sesiones llevan colgando, las páginas de wiki que mencionan a un PNJ, los hechos que la mesa ha marcado como canon. Las escrituras vuelven a la misma estructura, para que nada de lo que archives desde un chat quede desactualizado.

¿Cómo usar Grimoire?

Tres clics, nada que instalar:

  1. Añade el conector. En Claude.ai o ChatGPT (o cualquier cliente MCP que admita conectores personalizados), abre Configuración, luego Conectores, luego Añadir conector personalizado, y pega https://api.ttrpg.bot/mcp.
  2. Inicia sesión y elige una campaña. Tu cliente abre la pantalla de consentimiento de Grimoire. Inicia sesión con la cuenta que posee la campaña, elige qué campaña debe ver la IA, haz clic en Aprobar. El acceso está limitado a esa única campaña, aplicado en el servidor.
  3. Pregúntale algo sobre tu mundo. "¿Quién sabe sobre el culto?" "¿Cuál fue la reacción de la reina en la sesión 4?" "¿Qué cambió desde la sesión 12?" El cliente lee en vivo y responde desde tus datos.

Guía completa de configuración con instrucciones específicas por cliente: https://www.ttrpg.bot/docs/mcp/

Para clientes configurados mediante archivo JSON en lugar de una interfaz de conectores:

{
  "mcpServers": {
    "grimoire": {
      "type": "streamable-http",
      "url": "https://api.ttrpg.bot/mcp"
    }
  }
}

La autenticación es OAuth 2.1 con PKCE; el cliente abre un inicio de sesión en el navegador en la primera conexión. Una cuenta gratuita de Grimoire en https://www.ttrpg.bot proporciona la campaña que el servidor lee.

Características clave de Grimoire

  • Estado tipado en vivo, no archivos planos. 52 herramientas (21 de lectura, 31 de escritura) sobre una base de datos de campaña tipada con 14 esquemas de entidades. Una llamada de estado narrativo devuelve sesiones recientes, hilos argumentales abiertos, arcos activos y hechos canónicos.
  • Lectura y escritura, para que el estado se mantenga actualizado. Crea y actualiza entidades, registra progresiones de hilos y escribe páginas de wiki, bloques y tablas desde la conversación, para que el canon se actualice mientras preparas en lugar de quedar obsoleto en un archivo.
  • La wiki es parte del mundo. Búsqueda de texto completo en la wiki, páginas con migas de pan e hijas, tablas que viajan como cuadrículas markdown, y enlaces de entidades y páginas que resuelven a registros reales en lugar de coincidencias de texto.
  • Consultas de grafo de conocimiento en proyecciones políticas, geográficas y de línea temporal, con filtrado de visibilidad del máster aplicado en el servidor.
  • Secretos del máster aplicados en el servidor mediante tres niveles de visibilidad (conocimiento común, conocimiento de jugadores, secreto del máster), para que lo que la IA puede mostrar respete lo que los jugadores pueden ver.
  • Alojado, un clic OAuth, sin marcado de tokens. HTTP streamable remoto con OAuth 2.1; nada que instalar o autoalojar. El plan gratuito incluye acceso MCP completo, y Grimoire nunca cobra por tokens de IA.

Casos de uso de Grimoire

  • Pregunta qué cambió desde la sesión 12 antes de escribir la sesión 13, respondido desde el estado rastreado en lugar de tu memoria de las notas.
  • Consultas a mitad de sesión que se resuelven desde el canon de la campaña en lugar de la mejor suposición del modelo.
  • Analiza las notas de preparación de esta noche en PNJs, facciones y hilos argumentales tipados, en lugar de pegar la misma tradición en cada nuevo chat.
  • Consulta el mundo por relaciones: qué facciones tienen interés en esta ciudad, y qué PNJs notarían al grupo.
  • Busca en la wiki el folleto que mencionaba la abadía sumergida, luego lee la página y las entidades a las que enlaza.
  • Redacta un resumen de sesión y archívalo como una entidad estructurada que tus jugadores puedan leer en el portal, limitada a su nivel de visibilidad.
  • Encadénalo con otros servidores MCP: pasa la última sesión a un servidor de diapositivas o voz en off, o conecta un servidor de calendario para que el bot te recuerde preparar.

La caja de herramientas

52 herramientas en ocho grupos.

Entidades (10): search_campaign, get_entity, list_entities, get_field_options, get_tag_options, get_entity_schema, create_entity, update_entity, delete_entity, batch_create_entities. Cubre los 14 tipos de entidades: PNJs, Ubicaciones, Facciones, Misiones, Objetos, Personajes de Jugador, Criaturas, Vehículos, Entradas de Tradición, Reglas del Mundo, Fuerzas Planares, Resúmenes de Sesión, Preparaciones de Sesión, Mecánicas Personalizadas. get_entity_schema informa los campos exactos que acepta una categoría, columnas nativas, opciones de selección y los campos personalizados de la campaña, para que las escrituras aterricen en el lugar correcto en lugar de una bolsa genérica.

Relaciones (3): add_relationship, get_relationships, delete_relationship. Aristas tipadas entre dos entidades cualesquiera.

Grafos de conocimiento (8): get_constitution, get_entity_catalog, get_knowledge_graph, list_entity_graphs, get_entity_graph, add_to_entity_graph, create_entity_graph_edge, toggle_graph_attention. Proyecciones políticas, de línea temporal y geográficas con filtrado de visibilidad.

Fundamentos del mundo (6): create_foundation_node, update_foundation_node, delete_foundation_node, create_foundation_edge, delete_foundation_edge, update_world_foundations. Herramientas de escritura para la capa de fundamentos de la campaña, que siempre está cargada. Los nodos de fundamentos son conceptos que definen el mundo (un cataclismo, un poder oculto, una ley cosmológica) conectados por aristas etiquetadas, y update_world_foundations establece el documento estructurado de Fundamentos del Mundo (sistema de magia, jerarquía divina, leyes fundamentales). Son las verdades mecánicas y cosmológicas del mundo, distintas de entidades de base de datos como PNJs y ubicaciones.

Hilos abiertos (7): get_open_threads, create_open_thread, resolve_open_thread, unresolve_open_thread, update_open_thread, get_thread_progressions, add_thread_progression. Cabos sueltos y cómo evolucionan sesión tras sesión.

Wiki (10): get_wiki_tree, get_wiki_page, search_wiki, create_wiki_page, create_wiki_block, update_wiki_block, move_wiki_block, delete_wiki_block, batch_create_wiki_blocks, batch_reorder_wiki_blocks. Páginas colaborativas basadas en bloques que la IA lee y edita como tú. search_wiki es texto completo sobre títulos de páginas y prosa de bloques (search_campaign cubre solo entidades). Las tablas se leen y escriben como cuadrículas markdown planas, y los enlaces de entidades (@[Name](entity://category/uuid)) y enlaces de páginas (@[Title](page://uuid)) viajan dentro de cualquier bloque, incluidas las celdas de tabla, para que una página que la IA escribe esté enlazada a tus registros igual que una que tú escribirías.

Meta de campaña (5): current_campaign, get_campaign_context, get_narrative_state, get_campaign_bible, update_campaign_bible. get_narrative_state agrega sesiones recientes, hilos abiertos, hechos canónicos y arcos activos en una sola vista.

Observaciones de sesión (3): create_session_observation, update_session_observation, delete_session_observation. Notas solo para el máster que colorean una sesión: un momento tipado y valorado que merece la pena retomar. Leerlas no necesita una herramienta propia, porque get_narrative_state devuelve las observaciones de las sesiones que resume y get_knowledge_graph devuelve las de la línea temporal que dibuja.

El servidor también expone un recurso MCP, campaign://wiki, que lista las páginas de wiki de la campaña y su jerarquía.

Una habilidad para manejarlo bien

skills/grimoire-campaign-context/ es una Habilidad de Claude (también usable como instrucciones simples en cualquier cliente) que enseña a un asistente la secuencia de centrado al inicio de sesión, qué herramienta de lectura usar, cómo escribir entidades tipadas sin volcar datos en campos incorrectos, y recetas para analizar notas de preparación, archivar resúmenes y extracciones pre-sesión. Apunta tu cliente a ella, o pégala en las instrucciones de un proyecto.

Visibilidad y seguridad

Todo respeta el modelo de visibilidad de Grimoire: common-knowledge, player-knowledge, dm-secret y (solo wiki) system, con inherit resolviendo a través del bloque que enlaza una página de wiki y luego su cadena de padres. La IA ve lo que el rol conectado puede ver y nada más. Las conexiones de jugadores obtienen vistas filtradas, y una página que un jugador no puede alcanzar no existe para esa conexión: búsqueda, árbol y lecturas de página responden no encontrado. Las conexiones del máster obtienen la imagen completa.

La Biblia de Campaña es Secreto del Máster por defecto. Marca un bloque common-knowledge cuando los jugadores puedan conocerlo (mecánicas del mundo, vida cotidiana); eso lo registra como seguro para jugadores, pero la Biblia no se devuelve a conexiones de jugadores hoy. La Biblia no puede renombrarse.

Los alcances de OAuth están limitados a la campaña. Conceder acceso a una campaña no concede acceso a tus otras campañas, y el acceso es revocable en cualquier momento.

Precios

Gratis de extremo a extremo para probar. El plan gratuito de Grimoire incluye acceso MCP completo y se combina con los planes gratuitos de Claude.ai y ChatGPT, ambos compatibles con conectores MCP sin necesidad de tarjeta. Pro desbloquea campañas y entidades ilimitadas, campos personalizados en cada categoría y más almacenamiento.

Precios: https://www.ttrpg.bot/#pricing

FAQ de Grimoire

¿Dónde está el código fuente de Grimoire?

El servidor MCP se opera como un servicio alojado y su fuente no es pública. Este repositorio es la documentación pública y el artefacto de registro: server.json aquí es lo que se publica en registry.modelcontextprotocol.io como bot.ttrpg/grimoire, lhm.plugin.json es el manifiesto de LobeHub Marketplace, y skills/ contiene la Habilidad de Claude.

¿Grimoire incluye una configuración MCP estándar?

Sí. Usa el bloque HTTP streamable de arriba, o salta la configuración por completo: los clientes con soporte de conectores personalizados solo necesitan la URL https://api.ttrpg.bot/mcp.

¿Es gratis?

Sí, de extremo a extremo. El plan gratuito de Grimoire cubre acceso MCP completo, y los planes gratuitos de Claude.ai y ChatGPT admiten un conector personalizado sin necesidad de tarjeta.

¿Qué clientes funcionan?

Claude (web y escritorio), ChatGPT (planes con soporte de conectores), Cursor y cualquier cliente compatible con MCP que pueda hablar con servidores HTTP streamable remotos.

¿Puede leer y escribir mi wiki?

Sí. search_wiki encuentra páginas y bloques por texto, get_wiki_page devuelve una página con sus bloques, migas de pan e hijas, y las herramientas de escritura crean páginas, bloques y tablas. Las tablas viajan como cuadrículas markdown, y los enlaces de entidades y páginas se conservan como tokens que el servidor resuelve a registros reales.

¿En qué se diferencia de mantener notas de campaña en archivos markdown?

Los archivos contienen prosa; la IA tiene que adivinar qué archivo está actualizado y releerlo cada sesión. Grimoire contiene estado tipado: registros con campos y relaciones, hilos con edades, hechos marcados como canon, páginas enlazadas a registros. La IA consulta lo que es verdad ahora y escribe los cambios de vuelta en la misma estructura, para que nada se desvíe entre sesiones.

¿Conectar comparte mi campaña con un proveedor de IA?

Tú traes tu propio cliente. Grimoire expone la única campaña que apruebas a ese cliente y nada más, los alcances se muestran en la pantalla de consentimiento y el acceso es revocable en cualquier momento.

Enlaces

Licencia

MIT (para este repositorio de documentación).