Skip to main content
Glama

Event Book MCP server

Lets your AI agent model in Event Book: chapters, commands, events, read models and automations, with Given/When/Then scenarios for each slice. You watch the board grow live in your browser while the agent works.

It runs on your own machine. Your models stay in ~/.eventpad-mcp/store.json (set EVENTPAD_MCP_HOME to move them). You don't need an account to model.

What you need

  • Node 22 or newer

  • An agent that speaks MCP: Claude Code, Claude Desktop, Cursor, or similar

Related MCP server: framery

Set it up

Clone this repo, then add it to your agent. In Claude Code:

git clone https://github.com/jocelynenglund/event-book-mcp.git ~/event-book-mcp
claude mcp add --scope user event-book -- node ~/event-book-mcp/bin/event-book-mcp.mjs

For other agents, add an MCP server with the command node and the argument <path>/bin/event-book-mcp.mjs (stdio). It has no dependencies, so there is no npm install.

Then ask your agent something like "Model a library loan system in Event Book and open the live view".

What works where

Needs

Modelling: new_model, add_steps, add_scenarios, outline, edit_slice, renames, moves, comments

Nothing: all on your machine

live_view: Event Book on http://localhost:7979/?live, following the model as it's built

Nothing: served from this repo

export_file, then ☰ → Import in Event Book

Nothing: Event Book keeps books in your browser

import_file: bring in a test export or a docs/slices.json plan from your repo

Nothing

share_link: a link that opens a copy of the model, on any device

Uploads the model (without history) to Event Book's share service

connect_library, keep_model, editing a ☁ book, press_queue, start_building, finish_building

An Event Book account (invite only for now)

generate_specs: failing Given/When/Then specs in your repo

The specs use the itsybit-gwt (JS) or ItsyBIT.EventStore.Testing (.NET) harness

Settings

Variable

What it changes

EVENTPAD_MCP_HOME

Where models are kept (default ~/.eventpad-mcp)

EVENTPAD_LIVE_PORT

The live view's port (default 7979; the next free one is used)

EVENTPAD_AUTHOR

The name comments and drafts are signed with

This repo is generated from Event Book's own source on each release, so the server runs the same commands as the app. Please report issues there rather than editing the copy here.

Licence

MIT: build whatever you like with it.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to automate browsers locally through validated declarative scripts that perform Playwright actions, extraction, and assertions, while optional bounded decisions use configured inference providers without exposing page state or secrets.
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables coding agents to build and edit a local-first design board of HTML screens, flows, components, design-system pages, and plan tables, then review it in a browser with undo/restore, rendering, and export tools.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents and MCP hosts to drive a persistent headless Chromium browser through Playwright, navigating pages, mapping visible fields and actions, clicking, typing, scrolling, and capturing screenshots via stdio tool calls. It also powers a local AI Test Studio dashboard that generates and runs structured end-to-end test plans with assertions, per-step timing, and screenshot evidence.
      4
      1
      MIT