# Lunafic

> Lunafic is a free MCP server for games and play. Build Lunafic roleplay worlds and wiki entries by talking, and read back your stories. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://lunafic.ai/docs/agent-access
- **MCP Registry name:** ai.lunafic/lunafic
- **Categories:** games and play, events and entertainment
- **Listing updated:** 2026-11-16

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.lunafic.ai/api/mcp
```

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

```json
{
  "mcpServers": {
    "lunafic": {
      "url": "https://api.lunafic.ai/api/mcp"
    }
  }
}
```

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

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

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

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

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

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

## Tools

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

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

- [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.
- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Agent Bookability Index](https://ai-powered.com/mcp/agent-bookability-index): Agent Bookability Index is a free MCP server for events and entertainment.
- [Tap2Cal](https://ai-powered.com/mcp/tap2cal): Tap2Cal is a free MCP server for productivity.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.

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