Connect an agent over MCP
althistory mcp is a stdio MCP server. Add it to Claude Desktop, Cursor or Claude Code, and the agent can create graphs, write events, ages and causal links, check them, and branch them for you. If the app is running, the server works through it, so what the agent writes appears as it goes; otherwise it works on the files directly.
The server also offers three prompts, one for each way of working described below. In Claude Code they appear as /althistory:worldbuild and so on: run one on its own, then describe your world or premise in your next message.
No extra API key needed. Claude writes the history itself through the tools. Only the drafting tools, generate_timeline and branch_timeline, call a model of their own, and only if the server has ANTHROPIC_API_KEY or OPENAI_API_KEY in its environment (env in the config, or -e on the command). Without one they return a generic skeleton marked "source": "template" for the agent to rewrite. With the app running they run inside it, as jobs you can watch fill in.
You never start althistory mcp yourself: your client runs it, and talks to it over stdin and stdout. If your client cannot find althistory, give the full path to bin/althistory in the clone; it needs node on the client’s PATH.