instantiate_worldLABSCO SUMMARY
Entries create their own stubs, so the world grows sideways as you write.
After an entry is written, the stub tools read it for entities that deserve their own page and create placeholders for them — which is how one character description turns into a linked set of locations and factions instead of a dead end. Order matters: world first, taxonomies second, entries third.
What it is
A worldbuilding pipeline over MCP: it creates a world project on disk, generates taxonomy guidelines, writes entries that reference their taxonomy, stubs out entities they mention, and builds a static website from the result.
What you get
- instantiate_world — a complete world project structure in its own uniquely named folder
- generate_taxonomy_guidelines and create_taxonomy_folders — custom taxonomies such as characters, locations and artifacts
- create_world_entry — entries that automatically reference the taxonomy overview they belong to
- identify_stub_candidates and create_stub_entries — placeholder pages for entities your writing mentions
- generate_image_from_markdown_file — an image per entry, with a style and an aspect ratio from 1:1, 16:9, 9:16, 3:4 or 4:3
- build_static_site — a navigable website with image galleries
- File helpers: save_world_content, read_world_content, list_world_files
Requirements
pip install -e . and npm install in the cloned repository, then run vibe_worldbuilding_server.py from your client. Image generation is the only part that needs credentials — a FAL API key in FAL_KEY; everything else works without one.
Setup effort
Build from source — git clone https://github.com/jasnonaz/vibe-worldbuilding-mcp.git
USE CASES
01
Starting a world from a one-line idea
Create the project structure, then the taxonomies you want to fill.
02
Writing an entry and getting its connections for free
Write the character; the entities it mentions become stub pages automatically.
03
Illustrating what you just wrote
Generate an image from the entry's own markdown, at the aspect ratio you want.
04
Publishing the world so other people can read it
Build a static site with navigation and galleries from the files on disk.
11 tools
Listed in project docs. Your client may show a different list.
generate_taxonomy_guidelinescreate_taxonomy_folderscreate_world_entryidentify_stub_candidatescreate_stub_entriesgenerate_image_from_markdown_filebuild_static_sitesave_world_contentread_world_contentlist_world_filesBEFORE YOU INSTALL
What to know first
Tools you get
11 tools named in the project's documentation.
Requires
- Python 3.8+ with pip
- Node.js and npm
- A FAL API key (FAL_KEY) — only for image generation
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/jasnonaz/vibe-worldbuilding-mcp.git
cd vibe-worldbuilding-mcp
pip install -e .
npm installMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"vibe-worldbuilding": {
"command": "python",
"args": [
"<YOUR_PATH_TO_VIBE_WORLDBUILDER>/vibe_worldbuilding_server.py"
],
"env": {
"FAL_KEY": "<YOUR_FAL_KEY>"
}
}
}
}<YOUR_PATH_TO_VIBE_WORLDBUILDER>/ is the full path of your vibe-worldbuilding-mcp clone, and <YOUR_FAL_KEY> is your FAL API key — or drop the env block to worldbuild without image generation.
