Skip to content
MCP server

LegendKeeper

Read and build LegendKeeper worldbuilding wikis, maps and timelines from an assistant

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.1.2
Listing updated
1 day ago

About LegendKeeper

LegendKeeper is an open-source MCP server for games and play. It runs locally on your machine and is started by your AI client.

LegendKeeper is a worldbuilding wiki popular with game masters and writers, and this unofficial server connects an assistant to its v3 REST API using your own project key. The project owner must be on a paid LegendKeeper plan, because the API rejects trials. A sample request has Claude create a tavern, fill its infobox, drop a pin on the city map and link it from another page.

The README counts 31 curated tools plus an api_request escape hatch for other endpoints. Pages are edited as Markdown, with [[Wiki Links]] turned into real mentions, and blocks Markdown cannot express, such as infoboxes and embeds, are kept verbatim on rewrite. Edits can target one heading's section, and every write is version-checked so changes made in the app are not overwritten. Other features cover map pins, regions and paths, timeline events with human dates, templates, batch creation of up to 100 linked resources and image uploads.

One server can handle several worlds with a key per world, and a read-only mode exposes only reading tools. It runs over stdio via uvx, pip or Docker, or as a bearer-protected HTTP container. Member keys read and write content; Admin keys also reach hidden resources and GM secrets.

Install

Run in a terminal

claude mcp add legendkeeper-mcp --env LEGENDKEEPER_API_KEY='<LEGENDKEEPER_API_KEY>' -- uvx legendkeeper-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "legendkeeper-mcp": {
      "command": "uvx",
      "args": [
        "legendkeeper-mcp"
      ],
      "env": {
        "LEGENDKEEPER_API_KEY": "<LEGENDKEEPER_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "legendkeeper-mcp": {
      "command": "uvx",
      "args": [
        "legendkeeper-mcp"
      ],
      "env": {
        "LEGENDKEEPER_API_KEY": "<LEGENDKEEPER_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "legendkeeper-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "legendkeeper-mcp"
      ],
      "env": {
        "LEGENDKEEPER_API_KEY": "<LEGENDKEEPER_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "legendkeeper-mcp": {
      "command": "uvx",
      "args": [
        "legendkeeper-mcp"
      ],
      "env": {
        "LEGENDKEEPER_API_KEY": "<LEGENDKEEPER_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "legendkeeper-mcp": {
      "command": "uvx",
      "args": [
        "legendkeeper-mcp"
      ],
      "env": {
        "LEGENDKEEPER_API_KEY": "<LEGENDKEEPER_API_KEY>"
      }
    }
  }
}

Configuration

  • LEGENDKEEPER_API_KEYLegendKeeper project API key (Project Settings → Developers → API Keys). The project owner needs a paid plan.Required
  • LEGENDKEEPER_READ_ONLYSet to true to expose only reading tools.
  • LEGENDKEEPER_API_KEYLegendKeeper project API key (Project Settings → Developers → API Keys). The project owner needs a paid plan.Required
  • LEGENDKEEPER_READ_ONLYSet to true to expose only reading tools.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

search
Search a world for resources by name
create_resource
Create a wiki resource
set_facts
Set infobox and sidebar facts
create_map_feature
Create a map pin, region or path
write_page
Write or edit a page as Markdown
list_tags
List tags in the project
upload_image
Upload an image from disk or URL
api_request
Call any other LegendKeeper v3 API endpoint

What it does

Markdown pages
Edit wiki pages as Markdown with real mentions.
Section-level edits
Append, prepend or replace one heading's section.
Maps and timelines
Create pins, regions, paths and dated events.
Version-checked writes
Edits never silently overwrite app changes.
Multiple worlds
One server with a key per world, plus read-only mode.
Batch creation
Create up to 100 linked resources at once.

Good for

  • Draft a new location with its infobox and map pin
  • Add dated events to a campaign timeline
  • Summarise a world's wiki pages for session prep
  • Tag and link NPC pages in bulk

Pricing

Open source

Open source and unofficial; requires a LegendKeeper project on a paid plan

LegendKeeper FAQ

Do I need a paid LegendKeeper plan?

Yes. The project owner must be on a paid plan; trials do not count.

Is it official?

No. The README says it is not made or endorsed by LegendKeeper.

Can it be read-only?

Yes, set LEGENDKEEPER_READ_ONLY to true.

How do I run it?

Use uvx legendkeeper-mcp, pip or the Docker image, with LEGENDKEEPER_API_KEY set.

Is LegendKeeper free?

Yes. LegendKeeper is open source, so you can use and self-host it for free.

How do I add LegendKeeper to Claude Code?

Run this command in your terminal: claude mcp add legendkeeper-mcp --env LEGENDKEEPER_API_KEY='<LEGENDKEEPER_API_KEY>' -- uvx legendkeeper-mcp

What are the best alternatives to LegendKeeper?

The closest alternatives to LegendKeeper are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

Alternatives to LegendKeeper

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity