[EXTERNAL_INTEGRATION]

MCP Server

Connect your AI agents directly to the World Building Toolkit using the Model Context Protocol.

Native Integration

Directly expose toolkit capabilities to Claude, ChatGPT, and other LLMs.

Real-time Context

Allow AI to read and write directly to your game world bible and designs.

Tool Suite

Exposes specialized tools for terrain sculpting, lore writing, and market analysis.

Secure Access

Fine-grained permissions for tools and resources via API keys.

Available Tools

Entities

Complete
list_entities
List game entities with filtering by type/domain.
get_entity
Get a single entity by ID.
create_entity
Create a new game entity.
update_entity
Update an existing entity.
delete_entity
Delete an entity.

Storyteller

Complete
list_characters
List all characters in a project.
get_character
Get character by ID with psychology metrics.
create_character
Create a new character with MBTI and voice signature.
update_character
Update character attributes.
delete_character
Delete a character.
list_episodes
List all episodes in a project.
list_beats
Get narrative beats for an episode.
get_series_bible
Retrieve the series bible (lore, world rules).
storyteller_chat
Chat with the Writers Room LangGraph agents.

Generation

Complete
generate_tile
Generate a world tile with AI (Trigger.dev task).
upscale_tile
Upscale tile with Midjourney.
generate_3d_model
Generate 3D model from text.
remesh_3d_model
Remesh/optimize a 3D model.
generate_portrait
Generate a character portrait.

Trigger.dev

Complete
get_run_status
Check status of async generation tasks.
cancel_run
Cancel a running task.
wait_for_run
Wait for task completion with timeout.

Loop Creator

Coming Soon
get_loops
Retrieve all game retention loops.
run_loop_planner
Invoke the loop planner agent.
get_market_analysis
Get AI market analysis for a loop.

Interior Designer

Coming Soon
list_designs
List interior design layouts.
generate_text_to_3d
Generate 3D room from description.

World Building

Coming Soon
get_tiles
Read world grid data.
get_world_lore
Access world lore and rules.

Connection Details

Transport
STDIOStandard Input/Output (launched on demand)
Claude Desktop / Cursor Configuration
{
  "mcpServers": {
    "world-building-kit": {
      "command": "npx",
      "args": ["tsx", "/path/to/tilemap/src/mcp/server.ts"],
      "env": {
        "MCP_API_KEY": "your-api-key",
        "NEXT_PUBLIC_SUPABASE_URL": "...",
        "SUPABASE_SERVICE_ROLE_KEY": "..."
      }
    }
  }
}
Development Mode
# Use dev-test-key for local development
export MCP_API_KEY=dev-test-key
export DEV_USER_ID="your-supabase-user-uuid"

# Run the server
npx tsx src/mcp/server.ts

LangSmith Tracing

All MCP tool calls are automatically traced in LangSmith with rich metadata including API key, tool name, and execution context.

tool:name
key:name
source:mcp
domain:tag
/kur/ Build Worlds