webnovel-author MCP Server

MCP server that turns any AI agent into a webnovel writing specialist.

Supports xianxia, LitRPG, progression fantasy, romance, isekai, fanfiction, and all serial fiction. 39 tools, 44 resources, 31 prompts. Offline-first, zero-config, runs via npx.

---

Quick Start

npx webnovel-author

No API keys, no accounts, no configuration. Add the server to your AI agent and start writing. The free tier includes 24 tools, all 44 resources, and all 31 prompts — enough to write an entire novel.

Need knowledge graphs, semantic search, and continuity checks? Upgrade to Pro for 15 additional power tools.

---

Features

Free Tier (24 tools)

• Project scaffolding — Initialize a complete novel project with SQLite-backed persistence
• Character management — Create, update, and track character sheets with changelogs
• Chapter management — Outline, write, save, and organize chapters
• World-building — Locations, factions, magic systems, cultures, species, items
• Foreshadowing tracker — Plant seeds, track hints, schedule payoffs across hundreds of chapters
• Timeline tracking — Story chronology with in-world dates and events
• LitRPG stat blocks — Full RPG character stats, skills, inventory, equipment, quests
• Romance arc tracker — Relationship stages, romantic moments, slow-burn pacing
• Project export — Comprehensive project summary for backup or sharing
• Migration — Import existing flat-file projects into SQLite

Pro Tier (15 additional tools)

• Knowledge graph — Map all entity relationships and track how they evolve over chapters
• Semantic search — Search your entire project by meaning, not just keywords (local ONNX embeddings)
• AI writing context — Auto-assemble relevant context with token budget for optimal chapter writing
• Similar scene finder — Avoid repetition by finding thematic callbacks and duplicate scenes
• 7-type continuity checker — Overdue foreshadowing, stale characters, chapter gaps, orphaned entities, dead-end plots, relationship inconsistencies, timeline contradictions
• Writing rules — Project-wide naming conventions, banned tropes, tone guidelines
• Bulk file sync — Export DB to flat files and sync back for external editing

All Tiers

• 44 resources — 10 writing craft guides, 6 genre guides, 5 platform guides, 12 templates, 10 dynamic project resources, 1 embedding config
• 31 prompts — Writing (7), planning (6), characters (5), worldbuilding (5), maintenance (4), skill workflows (4)
• Genre guides — Xianxia, LitRPG, progression fantasy, romance, isekai, fanfiction
• Platform guides — Royal Road, Webnovel, ScribbleHub, Wattpad, AO3

---

Agent Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "webnovel-author": {
      "command": "npx",
      "args": ["-y", "webnovel-author"],
      "env": {
        "MCP_LICENSE_KEY": "mcp_live_..."
      }
    }
  }
}

Remove the env block to use the free tier.

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "webnovel-author": {
      "command": "npx",
      "args": ["-y", "webnovel-author"],
      "env": {
        "MCP_LICENSE_KEY": "mcp_live_..."
      }
    }
  }
}

Windsurf / Cursor / Cline / Roo Code

{
  "mcpServers": {
    "webnovel-author": {
      "command": "npx",
      "args": ["-y", "webnovel-author"],
      "env": {
        "MCP_LICENSE_KEY": "mcp_live_..."
      }
    }
  }
}

VS Code / GitHub Copilot

Add to .vscode/mcp.json:

{
  "servers": {
    "webnovel-author": {
      "command": "npx",
      "args": ["-y", "webnovel-author"],
      "env": {
        "MCP_LICENSE_KEY": "mcp_live_..."
      }
    }
  }
}

---

Environment Variables

---

Tools Reference (39 total)

Free Tools (24)

Pro Tools (15) — requires MCP_LICENSE_KEY

---

Resources (44)

Writing Craft Guides (10)

guide://pacing · guide://cliffhangers · guide://show-dont-tell · guide://dialogue · guide://fight-scenes · guide://power-systems · guide://cultivation-tiers · guide://serial-structure · guide://romance-pacing · guide://worldbuilding-checklist

Genre Guides (6)

genre://xianxia · genre://litrpg · genre://progression-fantasy · genre://romance · genre://isekai · genre://fanfiction

Platform Guides (5)

platform://royalroad · platform://webnovel · platform://scribblehub · platform://wattpad · platform://ao3

Templates (12)

template://novel-config · template://litconfig · template://character-sheet · template://chapter-structure · template://world-state · template://style-guide · template://character-sheet-xianxia · template://character-sheet-litrpg · template://arc-outline · template://magic-system · template://faction-sheet · template://series-bible

Dynamic Project Resources (10)

project://status · project://character/{name} · project://chapter/{number} · project://world/{name} · project://foreshadowing/active · project://foreshadowing/overdue · project://timeline · project://graph/{entity} · project://rules · project://continuity-report

System (1)

webnovel-author://embedding-config

---

Prompts (31)

Writing (7)

write-chapter · write-opening · write-climax · write-fight-scene · write-romance-scene · write-training-arc · write-dialogue-heavy

Planning (6)

brainstorm-story · plan-arc · plan-series · plan-subplot · plan-power-system · plan-twist

Characters (5)

create-character · create-antagonist · create-supporting-cast · evolve-character · character-voice-test

Worldbuilding (5)

build-world · build-faction · build-magic-system · build-history · build-culture

Maintenance (4)

review-continuity · review-arc · review-character-arcs · update-series-bible

Skill Workflows (4)

skill-start-novel · skill-write-next-chapter · skill-continuity-deep-dive · skill-character-audit

---

Typical Workflow

1. Brainstorm — Use brainstorm-story prompt to develop your concept
2. Initialize — init_project to create the project structure
3. Plan — plan-arc to structure your first arc
4. Create characters — create-character prompt + create_character tool
5. Build world — create_world_entry for locations, factions, magic systems
6. Write — write-chapter prompt → save_chapter tool
7. Track — Update characters, foreshadowing, timeline after each chapter
8. Check — [Pro] run_continuity_check to catch issues across your novel
9. Search — [Pro] search_project to find relevant context by meaning
10. Export — [Pro] export_to_files for git-friendly backups

---

Pro Upgrade

The free tier is genuinely useful — you can write an entire novel with it. Pro unlocks the power tools that become essential once your project grows past 20+ chapters:

• Knowledge graph tracks how every character, location, and faction connects
• Semantic search finds relevant context by meaning across hundreds of chapters
• Continuity checker catches plot holes before your readers do
• Writing rules keep your AI assistant consistent with your style

Get your license key: mcp-marketplace.io/server/webnovel-author

---

Tech Stack

• TypeScript + @modelcontextprotocol/sdk
• SQLite via better-sqlite3 + drizzle-orm (15+ tables, WAL mode)
• Local embeddings via fastembed (BGE-small-en-v1.5, 384 dims, ONNX)
• Vector search via sqlite-vec
• License verification via @mcp_marketplace/license
• Build with tsup, test with vitest

License

MIT