LegendKeeper
Read and build LegendKeeper worldbuilding wikis, maps and timelines from an assistant
- 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-mcpAdd 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.RequiredLEGENDKEEPER_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.RequiredLEGENDKEEPER_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

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media