mimir-dm

# Mimir Campaign Authoring

Create and manage D&D 5e campaigns using 21 MCP tools for campaign management, module creation, character management, and document writing.

## Getting Started

**Always start by selecting a campaign:**

1. `list_campaigns` - See available campaigns
2. `set_active_campaign(campaign_id)` - Set the working campaign

All subsequent tools operate within the active campaign context.

## Quick Reference

### Core Tools

| Category | Key Tools |
|----------|-----------|
| Campaign | `list_campaigns`, `set_active_campaign` |
| Modules | `create_module`, `list_modules`, `get_module_details` |
| Module Content | `add_monster_to_module`, `add_item_to_module` |
| Documents | `list_documents`, `read_document`, `edit_document`, `create_user_document` |
| Characters | `create_character`, `edit_character`, `list_characters`, `get_character` |
| NPCs | `assign_npc_to_module` |
| Inventory | `add_item_to_character`, `update_character_currency` |
| Catalog | `search_monsters`, `search_items`, `search_traps` |

See `references/tool-reference.md` for complete tool parameters and usage.

### Module Types

- `mystery` - Investigation-focused
- `dungeon` - Classic dungeon crawls
- `heist` - Stealth and planning
- `horror` - Dark, atmospheric
- `political` - Intrigue and social

See `references/module-types.md` for detailed guidance on each type.

### NPC Roles

`quest_giver`, `ally`, `antagonist`, `neutral`, `merchant`, `informant`

See `references/npc-roles.md` for role descriptions and usage.

## Common Workflows

### Create a Module
```
set_active_campaign(campaign_id)
create_module(name: "The Haunted Manor", module_type: "mystery")
list_documents(module_id: <new_module_id>)
edit_document(document_id, search, replace)
```

### Add Encounters
```
search_monsters(creature_type: "undead", max_cr: 5)
add_monster_to_module(module_id, monster_name: "Skeleton", monster_source: "MM", quantity: 3, encounter_tag: "entrance")
search_items(rarity: "uncommon")
add_item_to