dmcp

Create an ability template or character-owned ability

Get an ability by ID

Update an ability's details

Delete an ability

List abilities with optional filters

Copy a template ability to a character

Use an ability (checks cooldown, sets new cooldown)

Reduce all ability cooldowns (call at end of round)

Check if a character meets an ability's requirements

Store an audio file for an entity. Provide either a URL to fetch from or a local file path. Useful for TTS-generated narration, character dialogue, or voice reference clips for voice cloning.

Get audio file metadata by ID

Get the full local file path for an audio file. Useful when you need to pass the audio file to another tool (like TTS voice cloning).

Get audio with base64 data included (for playback or processing)

List all audio files for an entity

List all audio files in a game

List voice reference clips for voice cloning. These are audio samples that can be used as reference audio for TTS engines that support voice cloning (like Chatterbox, XTTS, CosyVoice).

Get all voice reference clips for a specific character, along with character info. Returns file paths ready to use with voice cloning TTS engines.

Delete a stored audio file (removes file and database record)

Set an audio file as the primary audio for its entity

Update metadata for an audio file (label, description, voice reference info)

Create multiple NPCs at once. Use this when populating a location with several characters. Returns all created characters.

Complete combat setup in one call: creates enemy NPCs and starts combat with all participants (enemies + players at location). Returns the ready-to-play combat state.

Complete scene transition in one call: moves specified characters to a new location and logs a narrative event. Perfect for moving between scenes.

Get comprehensive character context in one call: character details, inventory, and current location info. Reduces multiple tool calls to one.

Get comprehensive location context in one call: location details, present characters, and items here. Reduces multiple tool calls to one.

Create a new character (PC or NPC). IMPORTANT: Call this IMMEDIATELY when introducing any named NPC in narrative, BEFORE continuing the scene. Every named character mentioned in dialogue or description should exist in the database.

Get character details

Update character attributes, skills, status, or voice

List characters in a game. Use verbosity to control response size: 'minimal' for quick lookups (id/name only), 'standard' for common fields, 'full' for all details.

Move a character to a different location

Modify a character's health. Use mode 'damage' to reduce health, or 'heal' to restore health.

Add and/or remove conditions from a character in a single call. More efficient than separate add/remove calls.

Look up a character by name within a game. Supports exact, partial, and fuzzy matching. Returns the best match or an error if no reasonable match found.

List characters with quick-identification summaries. Use this to help identify characters by appearance before looking up their full details. More efficient than loading full character data when you just need to identify who's who.

Delete a character permanently. This is IRREVERSIBLE and will remove the character and all associated data.

Roll dice using standard notation

Perform a skill or ability check

Opposed check between two characters

Initialize a combat encounter

Get current combat state

Get the active combat for a game

Advance to the next combatant's turn

Add an entry to the combat log

Remove a character from combat (defeated, fled, etc.)

End a combat encounter

CALL THIS FIRST when player wants to play. Returns existing games (most recent first) or instructs to start new game if none exist.

Create a new game with a setting and style

Load an existing game by ID

List all saved games

Get full current state overview for a game

Delete a game and all its data. This is IRREVERSIBLE and removes all characters, locations, quests, and history.

Update a game's name, setting, or style

Set or remove the title image for a game

Set or remove the favicon image for a game. This image will be displayed as the browser favicon when viewing this game in the web UI. Should be a square image (ideally 32x32 or larger).

Get the full game setup interview template with all questions. Use this to guide players through game creation.

Save the player's game preferences after the interview

Get the saved game preferences for a game

List all image generation presets for a game. Presets allow different configurations for different use cases (character portraits, location art, items with text, etc.)

Get a specific image generation preset by ID, including full configuration details

Get the default image generation preset for a game

Create a new image generation preset. Use different presets for different purposes: character portraits, location art, items with text, etc. Each preset can have its own tool, model, style, and workflow configuration.

Update an existing image generation preset. Only specified fields are updated; others are preserved.

Delete an image generation preset. This is IRREVERSIBLE.

Set which image generation preset should be used by default

Store a rule system for the game

Get the current rule system for a game

Partially update the rule system

Get the current display configuration for the web viewer (colors, fonts, visibility options)

Set display configuration for the web viewer. Can set any subset of options.

Reset display configuration to defaults

Apply a predefined theme preset globally. Available presets include genre-specific themes with appropriate colors, fonts, and styles.

List all available theme presets with their colors and styles

Get the display configuration for a specific game

Set display configuration for a specific game. Each game can have its own visual theme.

Apply a predefined theme preset to a specific game. This allows different games to have completely different visual themes.

Remove a game's custom theme, reverting to the global theme

Automatically apply an appropriate theme to a game based on its genre and setting. Call this when creating a new game to set up the visual style.

Create a new faction/organization

Get a faction by ID

Update a faction's details

Delete a faction

List factions in a game

Update a faction resource value. Use mode 'delta' to add/subtract, or 'set' to set an absolute value.

Add and/or complete faction goals in a single call. More efficient than separate add/complete calls.

Add and/or remove faction traits in a single call. More efficient than separate add/remove calls.

Store an image for an entity. Provide a URL and the image will be downloaded and stored locally.

Get image metadata by ID

Get image with base64 data included (for displaying or processing). Supports format conversion, resizing, and quality control.

List all images for an entity

List all entities in a game that don't have a primary image. Useful for batch image generation workflows. Returns entities grouped by type with counts.

Delete a stored image (removes file and database record)

Set an image as the primary image for its entity

Update label, description, or entity association of an image

Build an image generation prompt from an entity's structured imageGen data. If a template exists for the entity type (or a specific templateId is provided), uses template-based building. Otherwise combines imageGen schema, notes/description, and preset defaults.

List all image prompt templates for a game. Templates allow configurable prompt building from entity data using placeholder syntax.

Get full details of an image prompt template including the template strings.

Create a new image prompt template for building prompts from entity data. Templates use placeholder syntax: - {{field.path}} - simple value substitution - {{field.path|"default"}} - value with default if missing - {{field.path|}} - value or empty string if missing Available fields include: name, no…

Update an existing image prompt template. Only specified fields are updated.

Delete an image prompt template. This is IRREVERSIBLE.

Create a new item. IMPORTANT: Call this IMMEDIATELY when introducing any item in narrative - whether found, given, purchased, or mentioned. Items must exist in the database before being referenced in dialogue or description.