Foundry MCP
Server Details
Connect any AI to your Foundry VTT world: actors, combat, dice, journals, tokens, compendiums.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 109 tools
Descriptions go out of their way to disambiguate: actor-list vs actor-filter, item-list vs world-item-filter, compendium-search vs compendium-page-search, chat-send vs ui-notify, token-update vs token-move. The remaining overlaps — six read paths into compendiums (compendium-browse, compendium-document-get, compendium-document-get-raw, compendium-search, compendium-page-search, uuid-resolve) and scene-get vs token-list vs placeable-list — are real but documented with explicit 'use X instead' guidance.
Strong, predictable resource-prefixed kebab-case throughout (actor-create/get/list/update/delete, journal-page-*, roll-table-*, world-time-*). Only a handful deviate from the prefix+verb shape: world-info, uuid-resolve, ui-notify, handout-template-get, and the awkward game-pause-get.
109 tools is far past any practical ceiling for agent selection, even though nearly every one maps to a real Foundry operation. The surface spans actors, tokens, scenes, placeables, journals, macros, playlists, time, audio and chat with no way to scope down, so a wrong-tool pick is likely on every turn.
Coverage is unusually thorough: full CRUD for actors, items, world items, journals/pages, folders, scenes, tokens, macros, roll tables, playlists and effects, plus combat lifecycle and time control. The notable gap is that many tools the descriptions point to are absent from this set — actor-filter, the whole dnd5e-* and pf2e-* suites, compendium filter tools — creating documented dead ends an agent will follow and fail on.
Available Tools
109 toolsactor-createAInspect
Create an actor from scratch (custom NPCs, characters, creatures). type must fit the game system — dnd5e: character, npc, vehicle, group; pf2e: character, npc, hazard, loot, familiar, party, vehicle, army. A compendium monster: actor-create-from-compendium. system is deep-merged over the defaults.
Inputs: name (required), type (required), img, folder, +1 more.
actor-create-from-compendiumAInspect
Import an actor (monster, NPC) from a compendium pack into the world. Pass either uuid — the "Compendium...Actor." value returned by dnd5e-compendium-filter-actors, pf2e-compendium-filter-actors and compendium-search — or packId + actorId from compendium-browse.
Inputs: name, uuid, folder, packId, +1 more.
actor-deleteADestructiveInspect
Delete an actor from the world. This action cannot be undone!
Inputs: actorId (required).
actor-getARead-onlyIdempotentInspect
Get full actor details: HP, AC, abilities, skills, speed, proficiency, inventory with item IDs. Item IDs from here are needed for dnd5e-roll-attack, dnd5e-roll-damage, dnd5e-item-use. The statblock layout follows the dnd5e data model; in other systems sections such as skills or currency stay empty — use uuid-resolve with "Actor." for the raw document.
Inputs: actorId (required).
actor-listARead-onlyIdempotentInspect
List actors in the world (name, type, ID), at most 200 rows. For anything beyond a plain listing — by name, CR, creature type, size, folder, HP, AC — use actor-filter, which also paginates.
Inputs: type.
actor-updateAInspect
Update an actor's name, image, folder, or system data (HP, XP, abilities...), or ONE token's actor via tokenId. system is DEEP-MERGED: pass only the paths you change, e.g. {"attributes": {"hp": {"value": 25}}} sets current HP and leaves the rest intact; arrays are replaced whole. Common dnd5e paths: attributes.hp.value, details.xp.value. For HP after damage prefer dnd5e-apply-damage (resistances, temp HP).
Inputs: img, name, folder, system, +3 more.
canvas-panAIdempotentInspect
Pan and/or zoom the canvas (canvas.animatePan) for everyone's view, in scene pixels, not grid squares. All fields optional: omit x/y to keep the centre, scale to keep the zoom. journalId pans to that journal's map note instead (bridge module 8.19.0+). canvas-ping draws attention to a spot instead.
Inputs: x, y, scale, duration, +1 more.
canvas-pingAInspect
Drop a ping marker on the canvas at scene-pixel coordinates (canvas.ping), visible to all clients. Use to draw players' attention to a spot. x and y are REQUIRED (scene pixels, not grid squares).
Inputs: x (required), y (required), color, style, +1 more.
chat-clearADestructiveInspect
Delete ALL chat messages. This action is IRREVERSIBLE. Use ONLY when the user explicitly asks to clear the entire chat log.
Inputs: no named parameters.
chat-deleteADestructiveInspect
Delete a specific chat message by ID. Use to remove erroneous messages or clean up chat. Use chat-list FIRST to find the message ID.
Inputs: messageId (required).
chat-exportARead-onlyIdempotentInspect
Export the full chat log as text or JSON (session summaries, recaps, archives). Text format: "[Speaker] Content" per line. JSON format: array of message objects with id, timestamp, author, speaker, content, flavor, isRoll.
Inputs: format.
chat-listARead-onlyIdempotentInspect
Read recent chat messages (plain text, HTML stripped) in chronological order: what players discuss, roll results, combat narration. since = a message ID to poll for newer messages.
Inputs: type, limit, since, before, +4 more.
chat-sendAInspect
Send a message to the Foundry chat log: narration, NPC dialogue, combat descriptions, out-of-character talk — players watching Foundry only see what is posted here. HTML is supported. actorId speaks as an NPC (portrait); flavor is a subtitle ("Narration", "The Tavern"). Document links: @UUID[Actor.actorId]{Name}, @UUID[Item.itemId]{Sword}, @UUID[JournalEntry.journalId]{Quest}.
Inputs: content (required), type, flavor, actorId, +2 more.
chat-updateAInspect
Edit content or flavor of an existing chat message. Use to fix typos in DM narration or update descriptions. Use chat-list FIRST to find the message ID. At least one of content or flavor must be provided.
Inputs: messageId (required), flavor, content.
combat-add-combatantAInspect
Add actor to combat. Use actor-list or actor-filter FIRST to find actorId. After adding all combatants, use combat-roll-all-initiative before combat-start.
Inputs: actorId (required), hidden, tokenId, combatId, +1 more.
combat-createAInspect
Create new combat encounter. First step in combat workflow. After creating: use combat-add-combatant to add actors, then combat-roll-all-initiative, then combat-start.
Inputs: sceneId, activate.
combat-deleteADestructiveInspect
Delete combat encounter immediately without confirmation. Use when combat is over or cancelled.
Inputs: combatId.
combat-getARead-onlyIdempotentInspect
Get combat state: combatants, round, turn, whose turn it is. Returns combatant IDs needed for combat-roll-initiative, combat-set-combatant-defeated, etc. combatId selects a specific encounter; omit it for the active combat.
Inputs: combatId.
combat-next-turnAInspect
Advance to next combatant's turn. Auto-advances round when all have acted. includeContext (default true) appends the tactical context: current combatant position, nearby enemies with distances and line of sight, ASCII map; set false on routine turns to save context.
Inputs: combatId, includeContext.
combat-previous-turnAInspect
Go back to previous combatant's turn. Use to undo an accidental combat-next-turn.
Inputs: combatId.
combat-remove-combatantAInspect
Remove combatant from combat. Use combat-get to find combatantId (not same as actorId). Use when creature flees or is removed from encounter.
Inputs: combatantId (required), combatId.
combat-roll-all-initiativeAInspect
Roll initiative for all combatants at once. Call AFTER combat-add-combatant, BEFORE combat-start. Use npcsOnly=true to let players roll their own.
Inputs: formula, combatId, npcsOnly.
combat-roll-initiativeAInspect
Roll initiative for specific combatants. Use combat-get to find combatantIds. For rolling all at once, use combat-roll-all-initiative instead.
Inputs: combatantIds (required), formula, combatId.
combat-set-combatant-defeatedAIdempotentInspect
Mark combatant as defeated (shows skull icon, skips their turn). Use when creature reaches 0 HP or is otherwise eliminated.
Inputs: defeated (required), combatantId (required), combatId.
combat-set-initiativeAIdempotentInspect
Manually set initiative value. Use for readied actions, special circumstances, or fixing rolls.
Inputs: initiative (required), combatantId (required), combatId.
combat-set-turnAIdempotentInspect
Jump to a specific combatant's turn without cycling the intermediate turns or incrementing the round — unlike repeated combat-next-turn, no round-based effects fire (Rage expiry, concentration, durations). Combatant IDs from combat-get; includeContext (default true) appends the tactical context.
Inputs: combatantId (required), combatId, includeContext.
combat-startAInspect
Begin combat (round 1, turn 0). Call AFTER adding combatants and rolling initiative. Returns the combat state; includeContext (default true) appends the tactical context (as combat-next-turn).
Inputs: combatId, includeContext.
combat-toggle-combatant-visibilityAInspect
Set or toggle a combatant's visibility to players (hidden enemies, invisible creatures, surprise). Pass hidden to set the state explicitly; omit it to flip the current state.
Inputs: combatantId (required), hidden, combatId.
compendium-browseARead-onlyIdempotentInspect
Browse the contents of a compendium pack (monsters, items, spells…); compendium-list gives the packId. types selects subtypes (["spell"]); ids BATCH-fetches specific documents in one call — every item a class grants, from uuid-resolve output — instead of N compendium-document-get calls; types+ids combine with AND. For stat filters (CR, level, rarity, traits, price) use dnd5e-compendium-filter-* / pf2e-compendium-filter-*.
Inputs: packId (required), ids, limit, types, +2 more.
compendium-document-getARead-onlyIdempotentInspect
Get a compendium document as a readable summary: actors as a statblock (HP, AC, abilities, attacks), other types as core fields plus system data. Raw JSON: compendium-document-get-raw; a UUID in hand: uuid-resolve. compendium-browse gives the document IDs.
Inputs: packId (required), documentId (required).
compendium-document-get-rawARead-onlyIdempotentInspect
Get the complete raw JSON data of a compendium document including all system fields. Use this when you need the full statblock data for calculations or detailed information.
Inputs: packId (required), documentId (required).
compendium-listARead-onlyIdempotentInspect
List all available compendium packs. Compendiums contain pre-made content like monsters, items, spells, etc. Use this to discover what compendiums are available, then use compendium-browse to see their contents.
Inputs: type.
compendium-page-searchARead-onlyIdempotentInspect
Full-text search inside JournalEntry compendium packs — page NAMES and page CONTENT. The tool for rules/lore text ("what does grappled say?" → query "grappled", pageTypes ["rule"]; class write-ups, spell lists): compendium-search sees only document names. Requires bridge module 8.11.0+.
Each match carries the PAGE uuid — pass it to uuid-resolve for the full text. matchedIn tells what matched: name matches win (content not scanned, snippet null); content matches carry a ~200-char snippet. Query is a case-insensitive substring; packs are scanned in order until limit, results unsorted.
Inputs: query (required), limit, packIds, pageTypes, +1 more.
compendium-searchARead-onlyIdempotentInspect
Search for documents across ALL compendiums by name — when you do not know which pack holds a monster, item or spell. Name matching only: structured filters are dnd5e-compendium-filter-* / pf2e-compendium-filter-*, rules/lore TEXT in journal packs is compendium-page-search, a UUID in hand is uuid-resolve.
Inputs: query (required), type, limit, system.
effect-createAInspect
Add a custom active effect (buff, debuff, custom condition) to an actor, or to ONE token via tokenId. Each change targets a data path with a mode; values are strings. EXAMPLE changes: [{"key": "system.attributes.ac.bonus", "value": "2", "mode": 2}] adds +2 AC. Paths are dnd5e; other systems differ.
Inputs: name (required), img, origin, actorId, +6 more.
effect-deleteADestructiveInspect
Remove an active effect from an actor, or from ONE token via tokenId. Use effect-list first to find effect IDs.
Inputs: effectId (required), actorId, sceneId, tokenId.
effect-listARead-onlyIdempotentInspect
List the active effects on an actor, or on ONE token via tokenId (conditions, buffs, debuffs, custom effects).
Inputs: actorId, sceneId, tokenId.
effect-toggle-statusAInspect
Toggle a status condition on an actor, or on ONE token via tokenId (any game system; PF2e conditions with values use pf2e-set-condition / pf2e-remove-condition instead). Several copies of one actor: tokenId makes only that goblin prone.
Status IDs are the game system's. dnd5e: blinded, charmed, deafened, exhaustion, frightened, grappled, incapacitated, invisible, paralyzed, petrified, poisoned, prone, restrained, stunned, unconscious. swade: shaken, stunned, distracted, vulnerable, prone, …
Inputs: statusId (required), active, actorId, overlay, +2 more.
effect-updateAInspect
Update an existing active effect on an actor, or on ONE token via tokenId: name, icon, disabled state, changes, duration.
Inputs: effectId (required), img, name, actorId, +5 more.
file-listARead-onlyIdempotentInspect
List the directories and files of a folder in the Foundry data (read-only) — to find image, map and audio paths for scene-set, placeable-set and playlist-set. Paths are relative to the data root, e.g. "worlds/my-world/maps". Requires bridge module 8.19.0+.
Inputs: path, bucket, source, extensions.
folder-createAInspect
Create a folder of the given document type. Foundry keeps a separate folder tree per type (Actor folders only hold Actors, etc.). parentId nests it inside another folder; omit for root level.
Inputs: name (required), type (required), sort, color, +2 more.
folder-deleteADestructiveInspect
Permanently delete a folder. deleteSubfolders: true also deletes child folders, deleteContents: true the documents inside; both default false, so sub-folders and documents move to the parent (or root). Both true on a populated tree wipes a lot of data — confirm with the user first.
Inputs: folderId (required), deleteContents, deleteSubfolders.
folder-getARead-onlyIdempotentInspect
Get a single folder. includeSubfolders=true returns the full subfolder tree; includeContents=true lists the ids of documents directly inside this folder (not inside subfolders: fetch each subfolder for its own contents). Both default false.
Inputs: folderId (required), includeContents, includeSubfolders.
folder-listARead-onlyIdempotentInspect
List folders in the world (id, name, type, parent), optionally one document type. No tree or contents: for subfolders and contents use folder-get.
Inputs: type.
folder-updateAInspect
Update a folder: name, parent, color, description, sort. Parent is TRI-STATE: omit parentId and clearParent = unchanged; parentId string = new parent; parentId null or clearParent: true = move to root (a string together with clearParent: true is rejected).
Inputs: folderId (required), name, sort, color, +3 more.
game-pauseAIdempotentInspect
Pause the game for all connected clients (freezes the session pause indicator). Use game-resume to unpause.
Inputs: no named parameters.
game-pause-getARead-onlyIdempotentInspect
Check whether the game is currently paused (game.paused). Returns paused: true/false.
Inputs: no named parameters.
game-resumeAIdempotentInspect
Resume (unpause) the game for all connected clients.
Inputs: no named parameters.
handout-template-getARead-onlyIdempotentInspect
Get the full HTML of a handout template: a STYLE REFERENCE, not a text to copy. Write a unique variation with inline style="" attributes (Foundry strips tags) and save it with journal-page-create, type "text".
Inputs: templateId (required).
handout-template-listARead-onlyIdempotentInspect
List available handout templates (wanted posters, letters, scrolls, etc.). Returns template IDs and descriptions; handout-template-get reads the full HTML.
Inputs: category.
item-createAInspect
Create a new item directly in an actor's inventory: custom items, loot, simple gear. SRD content: item-create-from-compendium; the world Items Directory instead of an actor: world-item-create.
Inputs: name (required), type (required), actorId (required), img, +1 more.
item-create-from-compendiumAInspect
Add an item (weapon, spell, feat, gear) from a compendium pack to an actor's inventory with its full data: uuid ("Compendium...Item." from dnd5e-compendium-filter-items, pf2e-compendium-filter-items, compendium-search) or packId + itemId from compendium-browse.
Inputs: actorId (required), name, uuid, itemId, +2 more.
item-deleteADestructiveInspect
Remove an item from actor's inventory permanently. Use item-list FIRST to find itemId. Cannot be undone! An item that is already gone counts as deleted (success), so retries are safe.
Inputs: itemId (required), actorId (required).
item-listARead-onlyIdempotentInspect
List an ACTOR's inventory (weapons, gear, spells, feats, class features) with descriptions, damage and range — not the world Items Directory (world-item-filter). Filter by type, equipped, hasActivities. The item IDs feed dnd5e-item-use, dnd5e-item-activate, dnd5e-roll-attack.
Inputs: actorId (required), type, equipped, hasActivities.
item-updateAInspect
Update an item in an actor's inventory. system is DEEP-MERGED into the existing data: pass only the fields you change, e.g. {"quantity": 3} or {"uses": {"value": 0}}; arrays are replaced whole.
Inputs: itemId (required), actorId (required), img, name, +1 more.
journal-createAInspect
Create a new journal entry, optionally with a first page. content is HTML (see journal-page-create for the HTML rules). folder takes a folder ID; a unique folder NAME is resolved to its ID.
Inputs: name (required), folder, content, pageType.
journal-deleteADestructiveInspect
Delete a journal entry and all its pages — or, with categoryId, only that page category (its pages stay, uncategorized; bridge module 8.19.0+, Foundry 13+). This action cannot be undone!
Inputs: journalId (required), categoryId.
journal-folder-listARead-onlyIdempotentInspect
List journal folders by name with entry and page counts — a quick overview of journal organization. journal-list takes the folder name. Folder IDs (for journal-create / journal-update / folder-get) come from folder-list with type "JournalEntry".
Inputs: no named parameters.
journal-getARead-onlyIdempotentInspect
Get a journal entry by ID with all its pages as plain text (default) or as raw JSON with HTML and page metadata (formatAsText=false). For one page of a long journal use journal-page-get.
Inputs: journalId (required), formatAsText.
journal-listARead-onlyIdempotentInspect
List journal entries with IDs, grouped by folder. Omit folder to list ALL journals. Returns IDs needed for journal-get. Use journal-search if you know the name.
Inputs: folder.
journal-page-createAInspect
Add a page to an existing journal entry. Text pages take HTML content: style with inline style="" attributes (Foundry strips and ), link documents with @UUID[Actor.]{Label}. handout-template-list offers ready-made layouts.
Inputs: name (required), journalId (required), src, type, +2 more.
journal-page-deleteADestructiveInspect
Delete a specific page from a journal. This action cannot be undone!
Inputs: pageId (required), journalId (required).
journal-page-getARead-onlyIdempotentInspect
Get a specific page from a journal. Useful when you only need one page from a multi-page journal. Returns plain text content by default.
Inputs: pageId (required), journalId (required), formatAsText.
journal-page-updateAInspect
Update a journal page. content REPLACES the whole page text (no append): read it with journal-page-get, edit, and send the full HTML back. Same HTML rules as journal-page-create.
Inputs: pageId (required), journalId (required), src, name, +2 more.
journal-searchARead-onlyIdempotentInspect
Search journals across all folders by journal name AND page name (case-insensitive substring). Faster than listing all journals when you know the name. Returns journal IDs for journal-get and page IDs for journal-page-get.
Inputs: query (required).
journal-showAInspect
Show a journal entry or one page on the players' screens. force=true reveals it even without permission (a one-off popup; permissions unchanged). users = Foundry user IDs (authorId from chat-list); omit for everyone.
Inputs: journalId (required), force, users, pageId.
journal-updateAInspect
Rename a journal entry or move it to another folder (metadata only; pages are edited with journal-page-update). folder takes a folder ID; a unique folder NAME is resolved to its ID. addCategories / updateCategories manage its page categories (bridge module 8.19.0+, Foundry 13+); a page joins one through journal-page-update categoryId.
Inputs: journalId (required), name, folder, addCategories, +1 more.
macro-createAInspect
Create a macro without running it (macro-execute runs it). type chat holds a chat command such as "/roll 1d20"; type script holds JavaScript that runs with GM rights and is accepted only while the module setting Allow Script Macros is on (off by default; the user turns it on in Foundry).
Inputs: name (required), type (required), command (required), img, +2 more.
macro-deleteADestructiveInspect
Permanently delete a macro.
Inputs: macroId (required).
macro-executeADestructiveInspect
Run a macro the way its hotbar button does: a chat macro posts its command, a script macro runs its JavaScript with GM rights (needs the module setting Allow Script Macros, off by default). args reaches a script macro as args / scope.args and the macro's return value comes back as result — bridge module 8.18.0+; older modules take no args and answer no result (the effect shows in chat-list or the world).
Inputs: macroId (required), args, actorId, tokenId.
macro-getARead-onlyIdempotentInspect
Get one macro with its command text: a chat command for type chat, JavaScript source for type script.
Inputs: macroId (required).
macro-listARead-onlyIdempotentInspect
List the world's macros (id, name, type, scope, folder, author); no command text: macro-get returns one macro's source.
Inputs: type.
macro-updateAInspect
Update a macro; omitted fields stay unchanged. Script macros, and a change to type script, need the module setting Allow Script Macros. Folder is TRI-STATE: omit = unchanged, folder ID = move, null or clearFolder: true = root.
Inputs: macroId (required), img, name, type, +4 more.
placeable-deleteADestructiveInspect
Delete one scene object by kind and id (from placeable-list): wall, note, light, sound, tile, drawing, region, or a region behavior (with regionId). Cannot be undone. Requires bridge module 8.19.0+.
Inputs: id (required), kind (required), sceneId, regionId.
placeable-listARead-onlyIdempotentInspect
List one kind of object on a scene with ids and positions (scene pixels): wall, note, light, sound (ambient sound), tile, drawing, region. For a region id: its behaviors with config, or tokens: true for the tokens inside it, or point to test whether a spot is inside. kind door-sound lists the door sounds a wall can use. scene-get gives a summary of everything at once. Requires bridge module 8.19.0+.
Inputs: kind (required), id, point, tokens, +1 more.
placeable-setAInspect
Create (no id) or update (id) one scene object; data holds its fields — on update only the ones to change. x, y in scene pixels, top-left; radii in scene distance units (feet); paths from file-list. Creating needs: wall c [x1,y1,x2,y2]; note x, y; light x, y; sound x, y, radius, path; tile x, y, width, height, texture.src; drawing x, y, shape; region name; behavior regionId, type. Fields — wall: door none|door|secret, doorState closed|open|locked, move/sense/sound/light none|normal|limited, dir, doorSound. note: entryId (journal), pageId, text, iconSrc, iconSize, textAnchor, global. light: dim, bright, angle, color "#rrggbb", alpha, coloration, luminosity, animation {type, speed, intensity}, darkness {min, max}, walls, vision, hidden. sound: volume 0-1, repeat, walls, easing, hidden, darkness. tile: texture {src, tint, scaleX, scaleY, fit}, rotation, alpha, elevation, hidden, occlusion {modes, alpha}. drawing: shape {type rectangle|ellipse, width, height} or {type polygon, points [x,y,…]}, fill {type none|solid, color, alpha}, stroke {width, color}, text {content, fontSize, color}, hidden. region: shapes [{type rectangle, x, y, width, height} | {type circle, x, y, radius} | {type polygon, points [{x,y}]}], color, elevation {bottom, top}, visibility, hidden. behavior: type (adjustDarknessLevel, displayScrollingText, executeMacro, pauseGame, teleportToken, toggleBehavior, …), name, disabled, config. Requires bridge module 8.19.0+. EXAMPLE: {"kind":"light","data":{"x":1200,"y":800,"dim":30,"bright":15,"color":"#ff9900","animation":{"type":"torch"}}}
Inputs: data (required), kind (required), id, sceneId, +1 more.
playlist-deleteADestructiveInspect
Delete a playlist, or only one of its sounds when soundId is given. Cannot be undone. Requires bridge module 8.19.0+.
Inputs: playlistId (required), soundId.
playlist-listARead-onlyIdempotentInspect
List the world's playlists (mode, channel, sound count, what is playing), or one playlist with its sounds when playlistId is given. Requires bridge module 8.19.0+.
Inputs: playlistId.
playlist-playAInspect
Control audio for every connected client: play or stop a playlist or one of its sounds, step to the next / previous track, or play a one-off audio file (src) — everywhere, or heard around a point on the scene when x, y and radius are given. action preload with src loads a file on every client ahead of time. Requires bridge module 8.19.0+. EXAMPLES: {"playlistId":"p1"} · {"action":"stop","playlistId":"p1"} · {"src":"sounds/thunder.ogg","volume":0.8}
Inputs: x, y, src, loop, +6 more.
playlist-setAInspect
Create a playlist (no playlistId; name required) or change one, and add, import or change its sounds in the same call. importPaths adds files named after themselves; find paths with file-list. Removing: playlist-delete. Requires bridge module 8.19.0+.
Inputs: fade, mode, name, channel, +6 more.
roll-diceAInspect
Roll arbitrary dice for custom checks, random tables or DM-specified rolls; D&D 5e mechanics have their own tools (dnd5e-roll-skill, dnd5e-roll-save, dnd5e-roll-attack, dnd5e-roll-damage, dnd5e-item-use). isCritical / isFumble follow the KEPT d20: plain 1d20, advantage 2d20kh1, disadvantage 2d20kl1 (a 20 on the discarded die does not count). Module v8.5.0+.
Inputs: formula (required).
roll-table-createAInspect
Create a roll table: a dice formula plus result entries with ranges, e.g. formula "1d6" with six results [1,1] … [6,6].
Inputs: name (required), img, folder, formula, +4 more.
roll-table-deleteADestructiveInspect
Delete a roll table. This action cannot be undone!
Inputs: tableId (required).
roll-table-getARead-onlyIdempotentInspect
Get full details of a roll table including all results with ranges and weights. Use roll-table-list FIRST to find the table ID.
Inputs: tableId (required).
roll-table-listARead-onlyIdempotentInspect
List all roll tables in the world. Roll tables provide random outcomes: encounters, loot, weather, NPC traits. Use roll-table-get to see full details, roll-table-roll to draw a result.
Inputs: no named parameters.
roll-table-resetAIdempotentInspect
Reset all drawn results on a roll table, making all entries available again. Only relevant for tables with replacement=false.
Inputs: tableId (required).
roll-table-rollAInspect
Roll on a table and get random result. Uses table.draw() — marks result as drawn (for no-replacement tables) and shows in Foundry chat. Use roll-table-list to find the table ID.
Inputs: tableId (required), displayChat.
roll-table-updateAInspect
Update a roll table's properties (name, formula, replacement mode, etc.). Does not modify individual results.
Inputs: tableId (required), img, name, formula, +3 more.
scene-activateAIdempotentInspect
Switch the active scene in Foundry VTT: all players see it (only one is active). Other actions (bridge module 8.19.0+): view shows it on the GM's canvas only; pull moves players (userIds, default all) to it without activating; preload loads its textures on every client.
Inputs: sceneId (required), action, levelId, userIds.
scene-deleteADestructiveInspect
Delete a scene with everything on it, or only one of its levels when levelId is given (Foundry 14+). Cannot be undone. Requires bridge module 8.19.0+.
Inputs: sceneId (required), levelId.
scene-getARead-onlyIdempotentInspect
Get full scene details: tokens (HP, AC, conditions, grid positions), walls, lights, notes, regions. includeMap (default true) appends an ASCII tactical map — walls, doors, numbered tokens with a legend — for spatial reasoning; false when you only need the lists. includeScreenshot=true adds a canvas screenshot (~100-500KB) for terrain, art and ambiance the map cannot convey — first view, not every turn. levels lists the scene's levels (Foundry 14+), weatherEffects the weather ids scene-set accepts (bridge module 8.19.0+). sceneId omitted = the active scene (scene-list has the IDs).
Inputs: levels, sceneId, includeMap, weatherEffects, +1 more.
scene-listARead-onlyIdempotentInspect
List all scenes in the world with id, name, active status, and background image path. Use to find scene IDs for scene-get or scene-activate. The active scene is where tokens and combat currently happen.
Inputs: no named parameters.
scene-setAInspect
Create a scene (no sceneId; name required), copy one (cloneFrom), or change one: size, background image, grid, darkness, weather, global light, fog, token vision, initial view, linked playlist and journal. resetFog clears explored fog, regenerateThumbnail re-renders the thumbnail; level creates (name) or changes (levelId) a scene level (Foundry 14+). Paths from file-list, weather ids from scene-get weatherEffects. Removing: scene-delete; showing to players: scene-activate. Requires bridge module 8.19.0+. EXAMPLE: {"sceneId":"s1","darkness":0.8,"weather":"rain","globalLight":{"enabled":false}}
Inputs: grid, name, level, width, +22 more.
scene-set-door-stateAIdempotentInspect
Open, close, or lock a door. Wall IDs: scene-get → walls[] with door=1 (normal) or door=2 (secret). States: 0=closed, 1=open, 2=locked. A locked door: scene-set-door-state(wallId, 0), then token-move with canOpenDoors=true; secret doors never open through token-move — set their state here.
Inputs: state (required), wallId (required), sceneId.
token-createAInspect
Place a token on the scene for an actor. Coordinates are pixels (top-left corner of the grid cell): pixel = gridCoord * gridSize; scene-get gives gridSize, actor-list or actor-filter the actorId.
Inputs: x (required), y (required), actorId (required), scale, +5 more.
token-deleteADestructiveInspect
Remove a token from the scene. Use token-list to find tokenId. This removes the token from the map, not the actor from the world.
Inputs: tokenId (required), sceneId.
token-listARead-onlyIdempotentInspect
List all tokens on a scene with positions, HP, AC, conditions, disposition and actorLink. HP is read from the token (not the master Actor) — correct for unlinked tokens after damage. warning unlinked_character_token = a player character placed as an unlinked copy; fix it with token-update actorLink true, not by editing the actor (module 8.14+). Omit sceneId for the active scene. Returns the token IDs for token-move, token-update, token-delete.
Inputs: sceneId.
token-moveAInspect
Move a token to pixel coordinates (top-left corner; pixel = gridCoord * gridSize); token-list gives tokenId. Pathfinding routes around walls and closed doors; pathCost (cells) reports a detour — pathCost * gridDistance > speed means more than one turn; Large+ tokens need wide corridors. Closed doors count as walls unless the user asks to open them (canOpenDoors=true; doorsOpened[] lists the walls). Locked (ds=2) and secret (door=2) doors are impassable: scene-set-door-state first.
Inputs: x (required), y (required), tokenId (required), animate, +1 more.
token-updateAInspect
Update token properties: visibility, elevation, rotation, actorLink. Use token-list to find tokenId. Position is NOT changed here — use token-move (pathfinding, door handling) to relocate a token.
Inputs: tokenId (required), hidden, rotation, actorLink, +1 more.
ui-notifyAInspect
Show a toast notification in the Foundry UI of every connected client (ui.notifications): a transient banner, not a chat message (use chat-send for chat). type controls the colour/severity (default info). permanent keeps it on screen until dismissed.
Inputs: message (required), type, permanent.
uuid-resolveARead-onlyIdempotentInspect
Resolve any ABSOLUTE Foundry UUID to its full document: world ("Actor."), compendium ("Compendium....") and embedded ("Actor..Item.", journal pages). Returns core fields plus the raw document data. Requires bridge module 8.11.0+.
UUIDs are NOT guessed: take them from the uuid fields of compendium-browse, compendium-page-search, the compendium filter tools, or from reference fields inside a resolved document (a class item's system.advancement[].configuration.items[].uuid), one hop per call: class → granted features → their effects. Relative UUIDs (starting with ".") are not supported.
Inputs: uuid (required).
world-infoARead-onlyIdempotentInspect
Get world overview: game system, content counts, compendium list. Call FIRST when starting a session to understand available content. Then use actor-list, journal-list, compendium-list to explore specific content.
Inputs: no named parameters.
world-item-createAInspect
Create an item in the world's Items Directory (game.items) — not an actor's inventory (item-create): shared loot, master copies, items independent of any actor. folder is a folder ID (folder-list); responses return the folder NAME. type for D&D 5e: weapon, equipment, consumable, tool, container, loot, spell, feat, background, race, class, subclass, feature — other systems differ, unknown types are rejected. system is the dnd5e blob; world-item-get shows the shape.
Inputs: name (required), type (required), img, folder, +1 more.
world-item-deleteADestructiveInspect
Permanently delete a world item from the Items Directory. Cannot be undone — Foundry has no item undo. Use world-item-filter or world-item-get FIRST to confirm the right id.
Inputs: itemId (required).
world-item-getARead-onlyIdempotentInspect
Get full ItemData for a single world item — id, uuid, name, type, image, folder NAME (read-side), and the complete system blob with rarity, weight, price, identified, attunement, damage, range, etc.
Inputs: itemId (required).
world-item-updateAInspect
Update a world item: name, image, folder, system data. folder is TRI-STATE: omit = unchanged, a string = new folder, EXPLICIT null (or clearFolder: true when the client cannot send null) = move to root. system is deep-merged — pass only the paths you change.
Inputs: itemId (required), img, name, folder, +2 more.
world-time-advanceAInspect
Advance the in-world clock by a number of seconds (game.time.advance). Use NEGATIVE seconds to rewind. Common deltas: 6 (one combat round), 60 (a minute), 3600 (an hour), 86400 (a day). Affects time-based effects/durations for all clients. Returns the new world time.
Inputs: seconds (required).
world-time-getARead-onlyIdempotentInspect
Get the current in-world time (game.time.worldTime) as whole seconds since the world epoch, plus the same value broken down into days / hours / minutes / seconds so no conversion is needed.
Inputs: no named parameters.
world-time-setAIdempotentInspect
Set the in-world clock to an ABSOLUTE value in seconds since the world epoch (game.time.set). Must be >= 0. To make a relative change use world-time-advance instead. Affects all connected clients.
Inputs: worldTime (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Roll RPG NPCs (Foundry VTT & SillyTavern V2), import stylized art, MP3 barks & talking MP4s.
Your tabletop campaign's journal, wiki, map, character sheets and combat tracker.
D&D and TTRPG campaign manager for GMs: your AI reads and writes a live, typed campaign database.
Create AI Characters and generate their DM and comment replies from any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to act as co-GMs and GM assistants within Foundry Virtual Tabletop, providing tools for game mechanics, actors, tokens, combat, canvas placeables, scenes, and world management.243 npmMIT
- AlicenseBqualityBmaintenanceLets AI assistants work inside a Foundry VTT world as a separate Assistant GM user, enabling live document and scene management, compendium imports, chat inspection, and controlled scripting through Foundry's own permissions and validation.17MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to interact with Foundry Virtual Tabletop, supporting reading world data, managing combat, rolling dice, and updating actor attributes via a sidecar architecture.ISC
- AlicenseAqualityBmaintenanceEnables AI-powered image generation and curation for Foundry VTT tabletop art, letting users create portraits, tokens, handouts, and scene backgrounds from prompts via a local headless ComfyUI workflow.4MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.