Foundryvtt MCP

search_actors

find characters, NPCs, monsters

get_actor_details

detailed character information

search_items

find equipment, spells, consumables

get_scene_info

current scene details

search_journals

search notes and handouts

get_journal

retrieve a specific journal entry

get_combat_state

combat state and initiative order

get_chat_messages

recent chat history

start_combat

begin a new encounter, seeding combatants from tokens (does not check for an existing combat — calling it during an active one creates a second encounter)

next_turn

advance the active combat to the next turn (wraps to the next round)

end_combat

end (delete) the active combat encounter

set_initiative

set a combatant's initiative in the active combat, moving the turn marker with the acting combatant if the reorder shifts them

move_token

move a token to new x/y coordinates on its scene

apply_status_effect

apply or remove a status condition (e.g. prone, stunned) on a token's actor

update_actor_attributes

patch an actor's system attributes (HP, currency, spell slots, …)

create_actor_item

add an inline item to an actor

update_actor_item

apply a JSON merge patch to an actor's item

delete_actor_item

remove an item from an actor

create_journal_entry

create a journal entry with one or more text pages (GM-only by default; pass visibility to let players read it)

search_world

full-text search across all game entities

get_world_summary

overview of the current world state

refresh_world_data

reload world data from FoundryVTT; needed after a dropped connection, whose missed updates are never replayed into the cache

roll_dice

roll dice; dice terms (NdS) and whole numbers joined by +/-, with unsupported notation (4d6kh3, 1d20r1, *) rejected rather than dropped.

lookup_rule

stub: returns a templated placeholder, consults no rules source

generate_npc

generate NPC text (not written to the world)

generate_loot

generate treasure text for a level (not written to the world)

get_recent_logs

retrieve filtered FoundryVTT logs

search_logs

search logs by pattern, listing the matching entries

get_system_health

server health status with versions, user/module counts, memory and log error counts (no CPU or disk metrics)

diagnose_errors

stub: returns a fixed "no errors detected" summary

get_health_status

comprehensive health diagnostics; flags the world snapshot when the cache has stopped following live changes