// MCP TOOL REFERENCE

FOUNDRYVTT MCP SERVER TOOLS

25 tools from the FoundryVTT MCP Server MCP Server, categorised by risk level.

// ALL 25 FOUNDRYVTT MCP SERVER TOOLS

READ 19 tools

Read diagnose_errors Stub: returns raw logs without analysis. Full diagnostic logic is tracked in #133 and not yet implemented. Read get_actor_details Get detailed information about a specific actor Read get_chat_messages Get recent chat messages from the game Read get_combat_state Get the current active combat state including initiative order, HP, and AC Read get_health_status Get comprehensive health status of FoundryVTT server Read get_journal Get a specific journal entry with its pages Read get_recent_logs Get recent log entries from FoundryVTT Read get_scene_info Get information about the current or specified scene Read get_system_health Get system health and performance metrics Read get_users Get the list of users with their online status and roles Read get_world_summary Get world metadata and collection counts Read lookup_rule Look up game rules and mechanics Read refresh_world_data Force re-fetch of world data from the FoundryVTT server Read search_actors Search for actors (characters, NPCs) in FoundryVTT Read search_compendium Search FoundryVTT compendium packs by name and metadata. Searches all enabled compendiums by default; the c... Read search_items Search for items in FoundryVTT Read search_journals Search journal entries by name or content Read search_logs Search through FoundryVTT logs Read search_world Search across all collections (actors, items, scenes, journals) by name

WRITE 4 tools

Write create_actor_item Create an item on an actor from an inline item document (requires FOUNDRY_WRITE_ENABLED + active Socket.IO ... Write generate_loot Generate random loot for encounters Write generate_npc Generate a random NPC with stats and background Write update_actor_attributes Update attributes on an actor

DESTRUCTIVE 1 tools

Destructive delete_actor_item Delete an item owned by an actor (requires FOUNDRY_WRITE_ENABLED + active Socket.IO connection). Canonical ...

EXECUTE 1 tools

Execute roll_dice Roll dice using standard RPG notation (e.g., 1d20, 3d6+4)

// FAQ

How many tools does the FoundryVTT MCP Server MCP server have? +

The FoundryVTT MCP Server MCP server exposes 25 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on FoundryVTT MCP Server tools? +

Route the FoundryVTT MCP Server server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do FoundryVTT MCP Server tools fall into? +

FoundryVTT MCP Server tools are categorised as Read (19), Write (4), Destructive (1), Execute (1). Each category has a recommended default policy.

Enforce policy on every FoundryVTT MCP Server tool call.

Start from FoundryVTT MCP Server, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.