Skip to main content
Glama

Server Details

Connect any AI to your Foundry VTT world: actors, combat, dice, journals, tokens, compendiums.

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A3.8/5.0

Scored across 109 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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 tools
actor-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-deleteA
Destructive
Inspect

Delete an actor from the world. This action cannot be undone!

Inputs: actorId (required).

actor-getA
Read-onlyIdempotent
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-panA
Idempotent
Inspect

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-clearA
Destructive
Inspect

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-deleteA
Destructive
Inspect

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-exportA
Read-onlyIdempotent
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-deleteA
Destructive
Inspect

Delete combat encounter immediately without confirmation. Use when combat is over or cancelled.

Inputs: combatId.

combat-getA
Read-onlyIdempotent
Inspect

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-defeatedA
Idempotent
Inspect

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-initiativeA
Idempotent
Inspect

Manually set initiative value. Use for readied actions, special circumstances, or fixing rolls.

Inputs: initiative (required), combatantId (required), combatId.

combat-set-turnA
Idempotent
Inspect

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-browseA
Read-onlyIdempotent
Inspect

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-getA
Read-onlyIdempotent
Inspect

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-rawA
Read-onlyIdempotent
Inspect

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-listA
Read-onlyIdempotent
Inspect

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.

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-deleteA
Destructive
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-deleteA
Destructive
Inspect

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-getA
Read-onlyIdempotent
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-pauseA
Idempotent
Inspect

Pause the game for all connected clients (freezes the session pause indicator). Use game-resume to unpause.

Inputs: no named parameters.

game-pause-getA
Read-onlyIdempotent
Inspect

Check whether the game is currently paused (game.paused). Returns paused: true/false.

Inputs: no named parameters.

game-resumeA
Idempotent
Inspect

Resume (unpause) the game for all connected clients.

Inputs: no named parameters.

handout-template-getA
Read-onlyIdempotent
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-deleteA
Destructive
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-deleteA
Destructive
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-getA
Read-onlyIdempotent
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-deleteA
Destructive
Inspect

Delete a specific page from a journal. This action cannot be undone!

Inputs: pageId (required), journalId (required).

journal-page-getA
Read-onlyIdempotent
Inspect

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-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-deleteA
Destructive
Inspect

Permanently delete a macro.

Inputs: macroId (required).

macro-executeA
Destructive
Inspect

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-getA
Read-onlyIdempotent
Inspect

Get one macro with its command text: a chat command for type chat, JavaScript source for type script.

Inputs: macroId (required).

macro-listA
Read-onlyIdempotent
Inspect

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-deleteA
Destructive
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-deleteA
Destructive
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-deleteA
Destructive
Inspect

Delete a roll table. This action cannot be undone!

Inputs: tableId (required).

roll-table-getA
Read-onlyIdempotent
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-resetA
Idempotent
Inspect

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-activateA
Idempotent
Inspect

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-deleteA
Destructive
Inspect

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-getA
Read-onlyIdempotent
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-stateA
Idempotent
Inspect

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-deleteA
Destructive
Inspect

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-listA
Read-onlyIdempotent
Inspect

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-resolveA
Read-onlyIdempotent
Inspect

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-infoA
Read-onlyIdempotent
Inspect

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-deleteA
Destructive
Inspect

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-getA
Read-onlyIdempotent
Inspect

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-getA
Read-onlyIdempotent
Inspect

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-setA
Idempotent
Inspect

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

    Related MCP Servers

    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources