AI-powered MCP server for writing webnovels — xianxia, LitRPG, romance, and all serial fiction.
webnovel-author turns any AI agent into a webnovel writing specialist. It manages your entire serial fiction project: characters, chapters, world-building, foreshadowing, timelines, LitRPG stats, romance arcs, and more — all stored in a local SQLite database. The free tier gives you 24 tools to scaffold and write your novel. Upgrade to Pro for knowledge graphs, semantic search, AI-powered continuity checks, and writing rules. Works with Claude Desktop, Claude Code, Windsurf, Cursor, VS Code Copilot, Cline, and any MCP-compatible client. Offline-first, zero-config, runs via npx.
This is a comprehensive MCP server for webnovel writing with appropriate permissions for its content management purpose. It includes SQLite database storage, local embeddings, and file I/O operations that align with its stated functionality. While there are some code quality concerns around error handling and input validation, the server follows good security practices with proper environment variable usage and no hardcoded credentials. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity).
4 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: MCP_LICENSE_KEY
Purchase above for keyEnvironment variable: WEBNOVEL_PROJECT_DIR
Add this to your MCP configuration file:
{
"mcpServers": {
"webnovel-author": {
"env": {
"MCP_LICENSE_KEY": "your-mcp-license-key-here",
"WEBNOVEL_PROJECT_DIR": "your-webnovel-project-dir-here"
},
"args": [
"-y",
"webnovel-author"
],
"command": "npx"
}
}
}Once installed, try these example prompts and explore these capabilities:
From the project's GitHub README.
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.
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.
Add to claude_desktop_config.json:
{
"mcpServers": {
"webnovel-author": {
"command": "npx",
"args": ["-y", "webnovel-author"],
"env": {
"MCP_LICENSE_KEY": "mcp_live_..."
}
}
}
}
Remove the
envblock to use the free tier.
Add to .mcp.json in your project root:
{
"mcpServers": {
"webnovel-author": {
"command": "npx",
"args": ["-y", "webnovel-author"],
"env": {
"MCP_LICENSE_KEY": "mcp_live_..."
}
}
}
}
{
"mcpServers": {
"webnovel-author": {
"command": "npx",
"args": ["-y", "webnovel-author"],
"env": {
"MCP_LICENSE_KEY": "mcp_live_..."
}
}
}
}
Add to .vscode/mcp.json:
{
"servers": {
"webnovel-author": {
"command": "npx",
"args": ["-y", "webnovel-author"],
"env": {
"MCP_LICENSE_KEY": "mcp_live_..."
}
}
}
}
| Variable | Description | Default |
|---|---|---|
MCP_LICENSE_KEY | Pro license key from MCP Marketplace | (none — free tier) |
WEBNOVEL_PROJECT_DIR | Override project root directory | Current working directory |
WEBNOVEL_DB_PATH | Override SQLite database path | .webnovel/webnovel.db |
| Tool | Description |
|---|---|
init_project | Initialize a new webnovel project with folder structure and config |
get_project_status | Get current project stats (chapters, words, arc progress) |
create_character | Create a new character sheet from template |
get_character | Read a character sheet by name |
list_characters | List all characters with their roles |
update_character | Update character attributes with changelog tracking |
create_chapter_outline | Create a structured chapter outline from template |
save_chapter | Save a written chapter and update project stats |
get_chapter | Read a chapter by number |
list_chapters | List all chapters with word counts |
create_world_entry | Create a world-building entry (location, faction, magic system, etc.) |
get_world_entry | Read a world-building entry by name |
list_world_entries | List all world-building entries |
get_style_guide | Get the webnovel writing style guide |
track_foreshadowing | Add or update a foreshadowing element |
get_foreshadowing_report | Report on foreshadowing status and due payoffs |
track_timeline | Add a timeline entry for story chronology |
get_timeline | Get full story timeline |
create_litrpg_stats | Create a LitRPG stat block (level, stats, skills, inventory) |
update_litrpg_stats | Update stats after level-ups, equipment changes, skill gains |
create_romance_tracker | Create a romance arc tracker for a character pairing |
update_romance_tracker | Update romance progression (stages, moments, notes) |
export_project_summary | Export comprehensive project summary |
migrate_project | Import flat-file project into SQLite database |
MCP_LICENSE_KEY| Tool | Description |
|---|---|
run_continuity_check | Scan for 7+ types of continuity issues across your novel |
add_relationship | Add a relationship between entities in the knowledge graph |
get_entity_connections | Get all relationships for an entity |
query_graph | Query the knowledge graph by type, relationship, or entities |
get_relationship_changes | Get relationship history between two entities |
search_project | Semantic search across the entire project by meaning |
get_writing_context | Auto-assemble writing context with token budget |
find_similar_scenes | Find scenes similar to a description |
check_consistency | Semantic consistency check against your project |
reindex_project | Rebuild all semantic embeddings |
export_to_files | Export database to flat files (markdown + JSON) |
sync_from_files | Sync external file edits back into the database |
set_project_rule | Add a project-wide writing rule |
get_project_rules | Get all writing rules, optionally by category |
delete_project_rule | Delete a writing rule |
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://xianxia · genre://litrpg · genre://progression-fantasy · genre://romance · genre://isekai · genre://fanfiction
platform://royalroad · platform://webnovel · platform://scribblehub · platform://wattpad · platform://ao3
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
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
webnovel-author://embedding-config
write-chapter · write-opening · write-climax · write-fight-scene · write-romance-scene · write-training-arc · write-dialogue-heavy
brainstorm-story · plan-arc · plan-series · plan-subplot · plan-power-system · plan-twist
create-character · create-antagonist · create-supporting-cast · evolve-character · character-voice-test
build-world · build-faction · build-magic-system · build-history · build-culture
review-continuity · review-arc · review-character-arcs · update-series-bible
skill-start-novel · skill-write-next-chapter · skill-continuity-deep-dive · skill-character-audit
brainstorm-story prompt to develop your conceptinit_project to create the project structureplan-arc to structure your first arccreate-character prompt + create_character toolcreate_world_entry for locations, factions, magic systemswrite-chapter prompt → save_chapter toolrun_continuity_check to catch issues across your novelsearch_project to find relevant context by meaningexport_to_files for git-friendly backupsThe 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:
Get your license key: mcp-marketplace.io/server/webnovel-author
@modelcontextprotocol/sdkbetter-sqlite3 + drizzle-orm (15+ tables, WAL mode)fastembed (BGE-small-en-v1.5, 384 dims, ONNX)sqlite-vec@mcp_marketplace/licensetsup, test with vitestMIT
Be the first to review this server!
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
by Taylorwilsdon · Productivity
Control Gmail, Calendar, Docs, Sheets, Drive, and more from your AI