Grimoire

Gerencie bancos de dados de campanhas de TTRPG, wiki e grafos de conhecimento.

Documentação

Grimoire MCP

Sua campanha como um banco de dados vivo que sua IA lê e escreve, não arquivos markdown que você mantém.


Endpoint	`https://api.ttrpg.bot/mcp`
Transporte	HTTP Streamable (especificação MCP 2025-06-18)
Autenticação	OAuth 2.1 com PKCE, fluxo de consentimento em um clique
Ferramentas	52 em 8 grupos (21 de leitura, 31 de escrita)
Registro	`bot.ttrpg/grimoire` no Registro MCP oficial
Aplicativo web	https://www.ttrpg.bot

O que é o Grimoire?

Grimoire é um gerenciador de campanhas para D&D e mestres de RPG de mesa que dá à sua IA o estado vivo da campanha em vez de arquivos markdown estáticos para manter em sincronia. Uma campanha no Grimoire é um banco de dados tipado, não uma pasta de anotações: NPCs, facções, locais, missões, sessões e lore, conectados por relacionamentos e grafos de conhecimento, com uma wiki colaborativa cujas páginas vinculam-se a esses registros. O servidor MCP hospedado permite que qualquer cliente conectado leia e escreva nesse banco de dados diretamente, então a IA responde com base no seu cânon atual e permanece consistente à medida que a campanha muda entre as sessões.

A diferença de uma pasta de arquivos de campanha é o que a IA recebe de volta. Uma busca em arquivos retorna prosa que pode estar desatualizada. O Grimoire retorna estado tipado: o líder atual de uma facção, os fios de enredo abertos e há quantas sessões eles estão pendentes, as páginas da wiki que mencionam um NPC, os fatos que a mesa marcou como cânon. Escritas voltam para a mesma estrutura, então nada que você arquivar a partir de um chat fica desatualizado.

Como usar o Grimoire?

Três cliques, nada para instalar:

Adicione o conector. No Claude.ai ou ChatGPT (ou qualquer cliente MCP que suporte conectores personalizados), abra Configurações, depois Conectores, depois Adicionar conector personalizado e cole https://api.ttrpg.bot/mcp.
Entre e escolha uma campanha. Seu cliente abre a tela de consentimento do Grimoire. Entre com a conta que possui a campanha, escolha qual campanha a IA deve ver, clique em Aprovar. O acesso é limitado a essa única campanha, aplicado no lado do servidor.
Pergunte algo sobre o seu mundo. "Quem sabe sobre o culto?" "Qual foi a reação da rainha na sessão 4?" "O que mudou desde a sessão 12?" O cliente lê ao vivo e responde com base nos seus dados.

Passo a passo completo de configuração com instruções específicas por cliente: https://www.ttrpg.bot/docs/mcp/

Para clientes configurados por arquivo JSON em vez de uma interface de conectores:

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

A autenticação é OAuth 2.1 com PKCE; o cliente abre um login no navegador na primeira conexão. Uma conta gratuita do Grimoire em https://www.ttrpg.bot fornece a campanha que o servidor lê.

Principais recursos do Grimoire

Estado tipado ao vivo, não arquivos planos. 52 ferramentas (21 de leitura, 31 de escrita) sobre um banco de dados de campanha tipado com 14 esquemas de entidades. Uma chamada de estado narrativo retorna sessões recentes, fios de enredo abertos, arcos ativos e fatos canônicos.
Leitura e escrita, para que o estado permaneça atual. Crie e atualize entidades, registre progressões de fios e escreva páginas da wiki, blocos e tabelas a partir da conversa, para que o cânon seja atualizado enquanto você prepara, em vez de ficar obsoleto em um arquivo.
A wiki faz parte do mundo. Busca de texto completo na wiki, páginas com trilhas de navegação e filhos, tabelas que fazem ida e volta como grades markdown, e links de entidades e páginas que resolvem para registros reais em vez de correspondências de string.
Consultas de grafo de conhecimento em projeções políticas, geográficas e de linha do tempo, com filtragem de visibilidade do GM aplicada no lado do servidor.
Segredos do GM aplicados no lado do servidor por meio de três níveis de visibilidade (conhecimento comum, conhecimento do jogador, segredo do GM), para que o que a IA pode exibir respeite o que os jogadores podem ver.
Hospedado, um clique OAuth, sem markup de token. HTTP remoto streamable com OAuth 2.1; nada para instalar ou auto-hospedar. O plano gratuito inclui acesso MCP completo, e o Grimoire nunca cobra por tokens de IA.

Casos de uso do Grimoire

Pergunte o que mudou desde a sessão 12 antes de escrever a sessão 13, respondido com base no estado rastreado em vez da sua memória das anotações.
Consultas no meio da sessão que resolvem a partir do cânon da campanha em vez do melhor palpite do modelo.
Transforme as anotações de preparação de hoje em NPCs, facções e fios de enredo tipados, em vez de colar o mesmo lore em cada novo chat.
Consulte o mundo por relacionamento: quais facções têm interesse nesta cidade e quais NPCs notariam o grupo.
Pesquise na wiki o handout que mencionou a abadia submersa, depois leia a página e as entidades às quais ela se vincula.
Redija um resumo da sessão e arquive-o como uma entidade estruturada que seus jogadores podem ler no portal, limitada ao nível de visibilidade deles.
Encadeie com outros servidores MCP: envie a última sessão para um servidor de slideshow ou narração, ou conecte um servidor de calendário para que o bot lembre você de preparar.

A caixa de ferramentas

52 ferramentas em oito 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. Cobre todos os 14 tipos de entidades: NPCs, Locais, Facções, Missões, Itens, Personagens dos Jogadores, Criaturas, Veículos, Entradas de Lore, Regras do Mundo, Forças Planares, Resumos de Sessão, Preparações de Sessão, Mecânicas Personalizadas. get_entity_schema relata os campos exatos que uma categoria aceita, colunas nativas, opções de seleção e os campos personalizados da campanha, para que as escritas caiam no lugar certo em vez de um saco genérico.

Relacionamentos (3): add_relationship, get_relationships, delete_relationship. Arestas tipadas entre quaisquer duas entidades.

Grafos de conhecimento (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. Projeções políticas, de linha do tempo e geográficas com filtragem de visibilidade.

Fundações do mundo (6): create_foundation_node, update_foundation_node, delete_foundation_node, create_foundation_edge, delete_foundation_edge, update_world_foundations. Ferramentas de escrita para a camada de fundação da campanha, que é sempre carregada. Nós de fundação são conceitos que definem o mundo (um cataclismo, um poder oculto, uma lei cosmológica) conectados por arestas rotuladas, e update_world_foundations define o documento estruturado de Fundações do Mundo (sistema de magia, hierarquia divina, leis fundamentais). Essas são as verdades mecânicas e cosmológicas do mundo, distintas de entidades de banco de dados como NPCs e locais.

Fios abertos (7): get_open_threads, create_open_thread, resolve_open_thread, unresolve_open_thread, update_open_thread, get_thread_progressions, add_thread_progression. Pontas soltas e como elas evoluem sessão após sessão.

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 baseadas em blocos que a IA lê e edita como você. search_wiki é texto completo sobre títulos de páginas e prosa de blocos (search_campaign cobre apenas entidades). Tabelas são lidas e escritas como grades markdown simples, e links de entidades (@[Name](entity://category/uuid)) e links de páginas (@[Title](page://uuid)) fazem ida e volta dentro de qualquer bloco, incluindo células de tabela, para que uma página escrita pela IA seja vinculada aos seus registros da mesma forma que uma que você digitou seria.

Metadados da campanha (5): current_campaign, get_campaign_context, get_narrative_state, get_campaign_bible, update_campaign_bible. get_narrative_state agrega sessões recentes, fios abertos, fatos canônicos e arcos ativos em uma única visão.

Observações de sessão (3): create_session_observation, update_session_observation, delete_session_observation. Anotações apenas para o GM que dão cor a uma sessão: um momento tipado e avaliado que vale a pena revisitar. Lê-las não requer uma ferramenta própria, porque get_narrative_state retorna as observações nas sessões que resume e get_knowledge_graph retorna as da linha do tempo que desenha.

O servidor também expõe um recurso MCP, campaign://wiki, que lista as páginas da wiki da campanha e sua hierarquia.

Uma habilidade para usá-lo bem

skills/grimoire-campaign-context/ é uma Skill do Claude (também utilizável como instruções simples em qualquer cliente) que ensina a um assistente a sequência de centralização no início da sessão, qual ferramenta de leitura usar, como escrever entidades tipadas sem despejar dados nos campos errados e receitas para analisar anotações de preparação, arquivar resumos e puxadas pré-sessão. Aponte seu cliente para ela ou cole-a nas instruções de um projeto.

Visibilidade e segurança

Tudo respeita o modelo de visibilidade do Grimoire: common-knowledge, player-knowledge, dm-secret e (apenas na wiki) system, com inherit resolvendo através do bloco que vincula uma página da wiki e depois sua cadeia de pais. A IA vê o que a função conectada tem permissão de ver e nada mais. Conexões de jogadores recebem visões filtradas, e uma página que um jogador não pode acessar não existe para essa conexão: busca, árvore e leituras de página respondem "não encontrado". Conexões de GM recebem o quadro completo.

A Bíblia da Campanha é Segredo do GM por padrão. Marque um bloco como common-knowledge quando os jogadores podem conhecê-lo (mecânicas do mundo, vida cotidiana); isso o registra como seguro para jogadores, mas a Bíblia não é retornada para conexões de jogadores hoje. A Bíblia não pode ser renomeada.

Os escopos OAuth são limitados à campanha. Conceder acesso a uma campanha não concede acesso às suas outras campanhas, e o acesso pode ser revogado a qualquer momento.

Preços

Gratuito de ponta a ponta para experimentar. O plano gratuito do Grimoire inclui acesso MCP completo e combina com os planos gratuitos do Claude.ai e ChatGPT, ambos com suporte a conectores MCP sem exigir cartão. O Pro desbloqueia campanhas e entidades ilimitadas, campos personalizados em todas as categorias e mais armazenamento.

Preços: https://www.ttrpg.bot/#pricing

FAQ do Grimoire

Onde está o código-fonte do Grimoire?

O servidor MCP é operado como um serviço hospedado e seu código-fonte não é público. Este repositório é a documentação pública e o artefato de registro: server.json aqui é o que é publicado em registry.modelcontextprotocol.io como bot.ttrpg/grimoire, lhm.plugin.json é o manifesto do LobeHub Marketplace e skills/ contém a Skill do Claude.

O Grimoire inclui uma configuração MCP padrão?

Sim. Use o bloco HTTP streamable acima ou pule a configuração completamente: clientes com suporte a conectores personalizados só precisam da URL https://api.ttrpg.bot/mcp.

É gratuito?

Sim, de ponta a ponta. O plano gratuito do Grimoire cobre acesso MCP completo, e os planos gratuitos do Claude.ai e ChatGPT suportam um conector personalizado sem exigir cartão.

Quais clientes funcionam?

Claude (web e desktop), ChatGPT (planos com suporte a conectores), Cursor e qualquer cliente compatível com MCP que possa falar com servidores HTTP remotos streamable.

Ele pode ler e escrever na minha wiki?

Sim. search_wiki encontra páginas e blocos por texto, get_wiki_page retorna uma página com seus blocos, trilha de navegação e filhos, e as ferramentas de escrita criam páginas, blocos e tabelas. Tabelas viajam como grades markdown, e links de entidades e páginas são preservados como tokens que o servidor resolve para registros reais.

Como isso é diferente de manter anotações de campanha em arquivos markdown?

Arquivos contêm prosa; a IA tem que adivinhar qual arquivo está atual e relê-lo a cada sessão. O Grimoire contém estado tipado: registros com campos e relacionamentos, fios com idades, fatos marcados como cânon, páginas vinculadas a registros. A IA consulta o que é verdade agora e escreve mudanças de volta na mesma estrutura, para que nada se desvie entre as sessões.

Conectar compartilha minha campanha com um fornecedor de IA?

Você traz seu próprio cliente. O Grimoire expõe a única campanha que você aprova para esse cliente e nada mais, os escopos são mostrados na tela de consentimento e o acesso pode ser revogado a qualquer momento.

Licença

MIT (para este repositório de documentação).