List all Foundry VTT worlds/clients connected to the relay, including their online status, system, and version info.

Search for Foundry entities by name. Returns UUID, documentType, subType, and package. This is the primary way to turn a name into a UUID for use with other tools. Use filter to narrow results, e.g. "Actor" or "documentType:Item,subType:weapon".

Retrieve a Foundry entity by UUID, or the currently selected token/actor. Returns the full document including system data and embedded items.

Create a new Foundry entity (Actor, Item, JournalEntry, etc.) with a raw Foundry document. Returns the new entity UUID and document.

Update an existing Foundry entity by UUID or current selection. Pass only the fields to change.

Permanently delete a Foundry entity by UUID or current selection. This action is irreversible.

Give/remove items, increase/decrease numeric attributes, or kill (set HP to 0) an actor. Use action to select the operation.

Build a dnd5e 5th-edition NPC actor from a friendly schema and create it in Foundry. Returns the new actor UUID and document. Only available when the connected world is dnd5e. ⚠️ Attack schema targets dnd5e v5.2.2 activities model — verify against a live NPC if attacks look wrong.

Create or delete a Foundry folder. After creating a folder, pass the returned uuid as the folder argument when creating entities. Limitation: finding existing folders requires structure:read (not in v1 scope) — only freshly-created folder UUIDs are known.