# foundry-mcp-com Tier Dm API

**Canonical:** https://apis.io/apis/foundry-mcp-com/foundry-mcp-com-tier-dm-api/  
**Provider:** foundry-mcp-com — https://apis.io/providers/foundry-mcp-com/  
**Base URL:** https://api.foundry-mcp.com/v1  
**Documentation:** https://api.foundry-mcp.com/docs

foundry-mcp-com Tier Dm API is one of 5 APIs that [foundry-mcp-com](https://apis.io/providers/foundry-mcp-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include tier-dm. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Available to Dungeon Master Patreon subscribers only — the highest tier.

## Operations (48)

| Method | Path | Summary |
|---|---|---|
| DELETE | `/combat` | Delete a combat (irreversible) |
| GET | `/combat` | Get current combat state |
| POST | `/combat` | Create a new combat encounter |
| POST | `/combat/combatants` | Add an actor to combat |
| DELETE | `/combat/combatants/{id}` | Remove a combatant from the encounter |
| PATCH | `/combat/combatants/{id}` | Patch a combatant |
| POST | `/combat/combatants/{id}/defeated` | Mark / unmark a combatant defeated |
| POST | `/combat/combatants/{id}/toggle-visibility` | Toggle combatant visibility (hidden flag) |
| POST | `/combat/end` | End a combat (preserve document) |
| POST | `/combat/next-turn` | Advance to the next combatant's turn |
| POST | `/combat/previous-turn` | Step back to the previous combatant's turn |
| POST | `/combat/set-turn` | Jump to a specific combatant's turn |
| POST | `/combat/start` | Start a combat (begin round 1) |
| GET | `/combat/turn-context` | Tactical context for the current combatant's turn |
| GET | `/compendiums` | List all compendium packs |
| GET | `/compendiums/{packId}/documents/{docId}` | Get a single full document from a compendium |
| POST | `/compendiums/{packId}/documents/{docId}/import` | Import a compendium document into the world |
| GET | `/compendiums/{packId}/index` | Get a compendium pack's lightweight index |
| POST | `/compendiums/{packId}/search` | Server-side search inside a compendium pack |
| POST | `/macros/{id}/execute` | Execute a macro |
| GET | `/scenes` | List all scenes in the world |
| POST | `/scenes` | Create a scene |
| DELETE | `/scenes/{id}` | Delete a scene |
| GET | `/scenes/{id}` | Get a scene with all placed content |
| PATCH | `/scenes/{id}` | Update a scene (metadata) |
| POST | `/scenes/{id}/activate` | Set a scene as the world's active scene |
| POST | `/scenes/{id}/clone` | Clone a scene |
| POST | `/scenes/{id}/view` | Open a scene in the GM's canvas view |
| GET | `/scenes/{scene_id}/notes` | List map-pinned notes on a scene |
| POST | `/scenes/{scene_id}/notes` | Pin a note on a scene |
| DELETE | `/scenes/{scene_id}/notes/{id}` | Delete a pinned note |
| PATCH | `/scenes/{scene_id}/notes/{id}` | Update a pinned note |
| GET | `/scenes/{scene_id}/walls` | List walls on a scene |
| POST | `/scenes/{scene_id}/walls` | Create a wall segment on a scene |
| DELETE | `/scenes/{scene_id}/walls/{id}` | Delete a wall |
| PATCH | `/scenes/{scene_id}/walls/{id}` | Update a wall |
| POST | `/scenes/{scene_id}/walls/{id}/door` | Open / close / lock a door |
| GET | `/swade/combat/action-cards` | List the dealt action cards of a Savage Worlds combat |
| GET | `/tokens` | List tokens placed on a scene |
| POST | `/tokens` | Place a token on a scene |
| GET | `/tokens/by-actor/{actor_id}` | Find the first token on a scene bound to an actor |
| POST | `/tokens/clear-targets` | Clear all of the GM's targeted tokens |
| GET | `/tokens/in-range` | List tokens within range of a pixel origin |
| DELETE | `/tokens/{id}` | Remove a token from a scene |
| GET | `/tokens/{id}` | Get a single token by id |
| PATCH | `/tokens/{id}` | Update a token's metadata |
| POST | `/tokens/{id}/move` | Move a token (with optional A* pathfinding + door-opening) |
| POST | `/tokens/{id}/target` | Target or untarget a token (GM's local target set) |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/foundry-mcp-com/openapi/foundry-mcp-com-tier-dm-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/foundry-mcp-com/json-schema/foundry-mcp-com-roll-skill-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundry-mcp-com/json-schema/foundry-mcp-com-roll-attack-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundry-mcp-com/json-schema/foundry-mcp-com-update-scene-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundry-mcp-com/json-schema/foundry-mcp-com-send-chat-message-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundry-mcp-com/json-schema/foundry-mcp-com-update-macro-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/foundry-mcp-com/json-schema/foundry-mcp-com-roll-damage-request-schema.json

## Other foundry-mcp-com APIs (4)

- [foundry-mcp-com Public API](https://apis.io/apis/foundry-mcp-com/foundry-mcp-com-public-api/)
- [foundry-mcp-com Tier Adventurer API](https://apis.io/apis/foundry-mcp-com/foundry-mcp-com-tier-adventurer-api/)
- [foundry-mcp-com Tier Free API](https://apis.io/apis/foundry-mcp-com/foundry-mcp-com-tier-free-api/)
- [foundry-mcp-com Tier Guest API](https://apis.io/apis/foundry-mcp-com/foundry-mcp-com-tier-guest-api/)

## Tags

tier-dm

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/foundry-mcp-com/foundry-mcp-com-tier-dm-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/foundry-mcp-com/.