get_users
list online users and their status
How to use it
get_users is exposed by the Foundryvtt MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the get_users tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Foundryvtt MCP
bunx foundryvtt-mcpOther tools in Foundryvtt MCP (30)
apply or remove a status condition (e.g. prone, stunned) on a token's actor
add an inline item to an actor
create a journal entry with one or more text pages
remove an item from an actor
analyze errors with troubleshooting suggestions
end (delete) the active combat encounter
create treasure appropriate for level
create random NPCs
detailed character information
recent chat history
combat state and initiative order
comprehensive health diagnostics
retrieve a specific journal entry
retrieve filtered FoundryVTT logs
current scene details
server performance and health metrics
overview of the current world state
game rules and spell descriptions
move a token to new x/y coordinates on its scene
advance the active combat to the next turn (wraps to the next round)
reload world data from FoundryVTT
roll dice with any formula
find characters, NPCs, monsters
find equipment, spells, consumables
search notes and handouts
search logs with regex patterns
full-text search across all game entities
set a combatant's initiative in the active combat
patch an actor's system attributes (HP, currency, spell slots, …)
apply a JSON merge patch to an actor's item