Skip to content
MCP server

Lunafic

Build Lunafic roleplay worlds and wiki entries by talking, and read back your stories

Install
Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
1.2.0
Listing updated
1 day ago

About Lunafic

Lunafic is a free MCP server for games and play. It runs as a hosted remote server, so there is nothing to install locally.

Lunafic is a roleplay story platform, and this server lets an assistant manage the world-building side of your account. Its 22 tools create and update worlds, publish or unpublish them, edit endings, starting choices and story secrets, and maintain the wiki of characters, locations, lore and other entry types, with panels that can be guarded. A brief import sets up many entries at once. A separate group reads your own stories, chapters and character status values, but the agent can never change a story.

The writing AI inside a story is separate, and the server does not write replies or chapters, change covers or touch billing. It acts as you, sees only your own worlds, records every write in an activity drawer where you can revert it and cannot write into someone else's guarded panels. Limits are 60 requests a minute and, per day, 3 new worlds, 50 wiki entries, 50 pictures and 300 changes.

All accounts have access, via a token that expires after 30 days by default or OAuth with Claude, ChatGPT and Gemini. World settings include a maturity level, so content depends on what each author builds.

Install

Run in a terminal

claude mcp add --transport http lunafic https://api.lunafic.ai/api/mcp

Add to Settings → Connectors → Add custom connector

https://api.lunafic.ai/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lunafic": {
      "url": "https://api.lunafic.ai/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "lunafic": {
      "type": "http",
      "url": "https://api.lunafic.ai/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "lunafic": {
      "serverUrl": "https://api.lunafic.ai/api/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "lunafic": {
      "type": "http",
      "url": "https://api.lunafic.ai/api/mcp"
    }
  }
}

Tools this server provides (22)

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

list_worlds
Lists your worlds.
get_world
Reads one world in full.
create_world
Creates a new draft world.
update_world
Changes world settings and publishing.
list_scenarios
Lists your projects.
get_world_bible
Reads every entry and panel of a world.
search_entries
Searches a world's entries by keyword.
create_entry
Creates a wiki entry.
update_entry
Updates a wiki entry.
delete_entry
Deletes an entry and its panels.
upsert_panel
Creates or updates a panel.
import_brief
Imports many entries and panels at once.
list_stories
Lists your own stories.
get_story
Shows a story and its chapters.
read_chapter
Reads a chapter page by page.
search_stories
Searches your stories for a word or phrase.
get_story_status
Reads status values in a story.
get_world_status
Reads a world's Status setup.
set_world_status
Sets up or changes Status values.
set_status_start
Gives a character a different starting status.
upload_image
Adds an image from a Google Drive link.
create_upload_url
Gives a one-picture upload link.

What it does

World management
Create, update, publish and unpublish worlds.
Wiki entries
Characters, locations, lore and other entry types.
Guarded panels
Protect panels from agent edits.
Brief import
Create many entries and panels at once.
Read-only stories
Read stories, chapters and status values, never edit.
Activity log
Every agent write is recorded and revertible.

Good for

  • Create a world and its cast by describing it
  • Fill a wiki with characters and lore
  • Search your stories for a phrase
  • Set up status values like trust or health

Pricing

Free

Agent access is open to every account

Prices change. Check lunafic.ai before you buy.

Lunafic FAQ

Who can use it?

Every Lunafic account.

Can the agent edit my stories?

No. It can only read stories you own.

Can I undo changes?

Yes, agent writes are recorded and can be reverted in the wiki.

What are the limits?

60 requests a minute, and daily caps on worlds, entries, pictures and changes.

Is Lunafic free?

Yes. Lunafic is free to use.

How do I add Lunafic to Claude Code?

Run this command in your terminal: claude mcp add --transport http lunafic https://api.lunafic.ai/api/mcp

What are the best alternatives to Lunafic?

The closest alternatives to Lunafic are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, MaineMCP and Haze City.

Alternatives to Lunafic

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. MaineMCP

    MCP server

    Search public Maine events, communities and startups, with links to the source listings

    • 4 tools
    • Remote
    • Free
    • Events and entertainment
  4. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  5. NYC-area event vendor prices, areas and booking options sourced from vendor sites

    • 9 tools
    • Remote
    • Free
    • Events and entertainment