Getting Started

There are two ways to use LoreKit: connect Claude via MCP (recommended for power users), or use the web app directly.

Claude Code#

Connect to the MCP endpoint on your running backend. No separate process needed.

bash

claude mcp add --transport http lorekit http://localhost:8001/mcp/mcp

Requires the backend running at localhost:8001.

Claude Desktop#

Add to your Claude Desktop config at ~/.claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "lorekit": {
      "type": "streamable-http",
      "url": "http://localhost:8001/mcp/mcp"
    }
  }
}

Cloud (Hosted)#

If using the hosted cloud version, connect via the cloud MCP endpoint. You'll be prompted to log in via your browser automatically.

bash

claude mcp add --transport http lorekit https://api.lorekit.app/mcp/mcp

Claude will open your browser for login when it first connects. No manual token needed.

Web App#

Or skip MCP entirely and use the visual interface. Go to /app/universe to create universes, add characters, generate stories, and render videos from the browser.

Typical Workflow#

Whether you use MCP or the web app, the workflow is the same:

Create a universe

Your story world with a name, description, and visual style.

Add characters

With rich descriptions that guide visual generation.

Add source items

Quotes, hooks, and truths that become story material.

Generate a story

The AI creates a scene-by-scene breakdown (creates a project).

Build workflow

Add keyframe and clip nodes to the canvas. Connect them. Execute the pipeline.

Render

Assemble clips with audio, transitions, and color grading into the final video.