Name: Kanka Worldbuilding MCP Tool
Author: Heartran

LABSCO SUMMARY

Complete coverage, at the cost of a large tool list.

Every entity type gets the same five operations, which makes the tool names predictable and means nothing in your campaign is out of reach. The trade is size: every one of those tool definitions rides along in every turn, so this is a server to enable while you are working on a campaign rather than one to leave on permanently. Note that the delete tools are real deletes against your live campaign — there is no dry run.

What it is

A local stdio MCP server for the Kanka worldbuilding API. It runs on your machine and talks to Kanka with your API token, exposing tools for every campaign entity type Kanka supports rather than a curated subset. Its source registers 77 tools: list_campaigns, search, and the same five operations — list, get, create, update, delete — on each of 15 entity types.

What you get

Your campaigns listed, and search across the entities inside one — list_campaigns, search
Full create, read, update and delete on each entity type — Character, Location, Family, Organization, Item, Note, Event, Calendar, Timeline, Creature, Race, Quest, Map, Journal and Ability — with the same five operations named the same way on every one, so the tool list is predictable once you have seen one type
A long tool list, which is what "the whole API surface" costs in context — worth knowing before you enable it alongside other servers

Requirements

A Kanka API token from kanka.io/en/settings/api, passed as KANKA_API_TOKEN. Node.js 20+. The npm package is kanka-mcp (2.1.1 in package.json) with a kanka-mcp binary; run it from a clone with npm install and point your client at index.js by absolute path, or install globally and call the binary. On Windows use forward slashes or escaped backslashes in the path, and restart the client after editing its config.

Setup effort

Build from source — git clone https://github.com/Heartran/Kanka-MCP-Server.git

See installation options

USE CASES

01

Writing session notes into the campaign instead of a document

Create journals and notes for what happened, and update the characters and locations the session touched.

02

Finding the entity you half-remember

Search within the campaign by name fragment, then pull the full record for the one you meant.

search

03

Building out a region in bulk

Create the locations, organizations and creatures for a new area in one pass rather than clicking through the web UI.

04

Picking the right campaign first

List your campaigns to get the one you mean, since every other call is scoped to a campaign.

list_campaigns

77 tools

Listed in project code.

`list_campaigns`

List all campaigns

BEFORE YOU INSTALL

What to know first

Tools you get

77 tools registered in the project's code. The README says 82 tools because its list includes an "Entity" type; the code has no Entity tools and registers 77.

Requires

Node.js 20+
KANKA_API_TOKEN in your environment

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/Heartran/Kanka-MCP-Server.git
cd Kanka-MCP-Server
npm install

MCP Clients

Any MCP client

ANY MCP CLIENT · JSON

{
  "mcpServers": {
    "kanka": {
      "command": "node",
      "args": [
        "<YOUR_ABSOLUTE_PATH_TO_REPO>/index.js"
      ],
      "env": {
        "KANKA_API_TOKEN": "<YOUR_KANKA_TOKEN>"
      }
    }
  }
}

Kanka Worldbuilding MCP Tool

Complete coverage, at the cost of a large tool list.

What it is

What you get

Requirements

Setup effort

Writing session notes into the campaign instead of a document

Finding the entity you half-remember

Building out a region in bulk

Picking the right campaign first

77 tools

list_campaigns

search

list_characters

get_character

create_character

update_character

delete_character

list_locations

get_location

create_location

update_location

delete_location

list_families

get_family

create_family

update_family

delete_family

list_organisations

get_organization

create_organization

update_organization

delete_organization

list_items

get_item

create_item

update_item

delete_item

list_notes

get_note

create_note

update_note

delete_note

list_events

get_event

create_event

update_event

delete_event

list_calendars

get_calendar

create_calendar

update_calendar

delete_calendar

list_timelines

get_timeline

create_timeline

update_timeline

delete_timeline

list_creatures

get_creature

create_creature

update_creature

delete_creature

list_races

get_race

create_race

update_race

delete_race

list_quests

get_quest

create_quest

update_quest

delete_quest

list_maps

get_map

create_map

update_map

delete_map

list_journals

get_journal

`list_campaigns`

`search`

`list_characters`

`get_character`

`create_character`

`update_character`

`delete_character`

`list_locations`

`get_location`

`create_location`

`update_location`

`delete_location`

`list_families`

`get_family`

`create_family`

`update_family`

`delete_family`

`list_organisations`

`get_organization`

`create_organization`

`update_organization`

`delete_organization`

`list_items`

`get_item`

`create_item`

`update_item`

`delete_item`

`list_notes`

`get_note`

`create_note`

`update_note`

`delete_note`

`list_events`

`get_event`

`create_event`

`update_event`

`delete_event`

`list_calendars`

`get_calendar`

`create_calendar`

`update_calendar`

`delete_calendar`

`list_timelines`

`get_timeline`

`create_timeline`

`update_timeline`

`delete_timeline`

`list_creatures`

`get_creature`

`create_creature`

`update_creature`

`delete_creature`

`list_races`

`get_race`

`create_race`

`update_race`

`delete_race`

`list_quests`

`get_quest`

`create_quest`

`update_quest`

`delete_quest`

`list_maps`

`get_map`

`create_map`

`update_map`

`delete_map`

`list_journals`

`get_journal`

`create_journal`

`update_journal`

`delete_journal`

`list_abilities`

`get_ability`

`create_ability`

`update_ability`

`delete_ability`