# LegendKeeper

> LegendKeeper is an open-source MCP server for games and play. Read and build LegendKeeper worldbuilding wikis, maps and timelines from an assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/chase-roohms/legendkeeper-mcp
- **MCP Registry name:** io.github.chase-roohms/legendkeeper-mcp
- **Categories:** games and play, knowledge and memory
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.

---
Source: https://ai-powered.com/mcp/legendkeeper
