find_entitiesLABSCO SUMMARY
A campaign wiki your assistant can keep tidy.
Kanka holds the canon; this lets an assistant read and write it directly, so session notes, new NPCs and location edits land in the campaign instead of a chat log. The Markdown conversion means what you dictate arrives formatted the way Kanka expects.
What it is
An MCP server for the Kanka campaign wiki API. It creates, reads, updates and deletes Kanka entities — characters, creatures, locations, organizations, races, notes and journals — manages the posts attached to them, and converts between Markdown and Kanka's HTML with entity mentions preserved.
What you get
- Entities created, read, updated and deleted across Kanka's campaign types
- Search by name with partial matching, plus filtering by type, tag and date
- Batch operations, so several entities move in one request
- Posts — the notes attached to an entity — created, updated and deleted
- Markdown in, Kanka HTML out, with entity mentions surviving the round trip
- Client-side filtering that goes beyond what the Kanka API alone supports
- created_at and updated_at on every entity, and Kanka's own lastSync for incremental syncing
Requirements
Python 3.10 or higher, plus a Kanka API token and campaign ID supplied as KANKA_TOKEN and KANKA_CAMPAIGN_ID. Installed from PyPI as mcp-kanka, or from source with uv or pip.
Setup effort
One command plus a key — pip install mcp-kanka, then supply credentials
USE CASES
01
Looking up a character mid-session
Search by name with partial matching, so a half-remembered NPC still resolves without opening the campaign site.
02
Writing up a session afterwards
Dictate the notes in Markdown and let them land as posts on the entities involved, converted to Kanka's HTML with mentions intact.
03
Adding a batch of NPCs at once
A batch request creates several entities in a single call instead of one round trip per character.
04
Syncing only what changed
Filter by date, or lean on Kanka's lastSync, so a sync reads the recent edits rather than the whole campaign.
9 tools
Listed in project docs. Your client may show a different list.
create_entitiesupdate_entitiesget_entitiesdelete_entitiescheck_entity_updatescreate_postsupdate_postsdelete_postsBEFORE YOU INSTALL
What to know first
Tools you get
9 tools named in the project's documentation.
Requires
- Python 3.10 or later
- KANKA_TOKEN in your environment
- KANKA_CAMPAIGN_ID in your environment
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install mcp-kankaMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"kanka": {
"command": "python",
"args": [
"-m",
"mcp_kanka"
],
"env": {
"KANKA_TOKEN": "<YOUR_KANKA_TOKEN>",
"KANKA_CAMPAIGN_ID": "<YOUR_KANKA_CAMPAIGN_ID>"
}
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add kanka \
-e KANKA_TOKEN="<YOUR_KANKA_TOKEN>" \
-e KANKA_CAMPAIGN_ID="<YOUR_KANKA_CAMPAIGN_ID>" \
-- python -m mcp_kanka
