# foundry-mcp-com Tier Free API

**Canonical:** https://apis.io/apis/foundry-mcp-com/foundry-mcp-com-tier-free-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 Free 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-free. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Available to free Patreon subscribers and above (`free`, `adventurer`, `dm`).

## Operations (57)

| Method | Path | Summary |
|---|---|---|
| GET | `/actors` | List / search actors |
| POST | `/actors` | Create a new actor |
| DELETE | `/actors/{id}` | Delete an actor |
| GET | `/actors/{id}` | Get actor by id |
| PATCH | `/actors/{id}` | Partially update an actor |
| GET | `/chat/export` | Export the chat log |
| DELETE | `/chat/messages` | Clear ALL chat messages (destructive) |
| GET | `/chat/messages` | List chat messages |
| POST | `/chat/messages` | Send a chat message |
| DELETE | `/chat/messages/{id}` | Delete a chat message |
| PATCH | `/chat/messages/{id}` | Edit a chat message |
| POST | `/dice/roll` | Roll a dice formula |
| GET | `/dnd5e/actors` | Search actors with D&D 5e filters |
| POST | `/dnd5e/dice/roll-all-initiative` | Roll initiative for every combatant in a combat |
| POST | `/dnd5e/dice/roll-attack` | Roll a weapon-bound attack |
| POST | `/dnd5e/dice/roll-attribute` | Roll an actor-bound ability check |
| POST | `/dnd5e/dice/roll-damage` | Roll weapon damage |
| POST | `/dnd5e/dice/roll-initiative` | Roll initiative for specific combatants |
| POST | `/dnd5e/dice/roll-saving` | Roll an actor-bound saving throw |
| POST | `/dnd5e/dice/roll-skill` | Roll an actor-bound skill check |
| GET | `/dnd5e/items` | Search items with D&D 5e filters |
| GET | `/folders` | List folders (optionally filtered by type) |
| POST | `/folders` | Create a folder |
| DELETE | `/folders/{id}` | Delete a folder, optionally cascading subfolders/contents |
| GET | `/folders/{id}` | Get a folder, optionally with sub-tree and contents |
| PATCH | `/folders/{id}` | Update a folder |
| GET | `/items` | Filter / list world items |
| POST | `/items` | Create a world-level item |
| DELETE | `/items/{id}` | Delete a world item |
| GET | `/items/{id}` | Get a world item with full system data |
| PATCH | `/items/{id}` | Update a world item |
| GET | `/macros` | List macros (optionally filtered by type) |
| GET | `/macros/{id}` | Get a macro with its command text |
| POST | `/pf2e/conditions/decrease` | Decrease a Pathfinder 2e condition |
| POST | `/pf2e/conditions/get` | List a Pathfinder 2e actor's conditions |
| POST | `/pf2e/conditions/increase` | Increase a Pathfinder 2e condition |
| POST | `/pf2e/conditions/remove` | Remove a Pathfinder 2e condition |
| POST | `/pf2e/conditions/set` | Set a Pathfinder 2e condition |
| POST | `/pf2e/items/cast-spell` | Cast a Pathfinder 2e spell |
| POST | `/pf2e/items/post` | Post a Pathfinder 2e item to chat |
| POST | `/pf2e/items/use-consumable` | Use a Pathfinder 2e consumable |
| POST | `/pf2e/roll-perception` | Roll a Pathfinder 2e perception check |
| POST | `/pf2e/roll-save` | Roll a Pathfinder 2e saving throw |
| POST | `/pf2e/roll-skill` | Roll a Pathfinder 2e skill check |
| POST | `/pf2e/strikes/list` | List a Pathfinder 2e actor's Strikes |
| POST | `/pf2e/strikes/roll` | Roll a Pathfinder 2e Strike attack |
| POST | `/pf2e/strikes/roll-damage` | Roll Pathfinder 2e Strike damage |
| GET | `/swade/actors/{id}/summary` | Get a Savage Worlds actor's sheet summary |
| POST | `/swade/bennies` | Spend, give or refresh bennies |
| POST | `/swade/damage/apply` | Apply damage to a Savage Worlds actor |
| POST | `/swade/damage/soak` | Soak Wounds with a benny |
| POST | `/swade/roll/attack` | Roll a Savage Worlds weapon attack |
| POST | `/swade/roll/attribute` | Roll a Savage Worlds attribute |
| POST | `/swade/roll/damage` | Roll a Savage Worlds weapon's damage |
| POST | `/swade/roll/skill` | Roll a Savage Worlds skill |
| POST | `/swade/status` | Set or clear a Savage Worlds status |
| GET | `/swade/tokens/{id}/summary` | Get a Savage Worlds token's sheet summary |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/foundry-mcp-com/openapi/foundry-mcp-com-tier-free-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 Dm API](https://apis.io/apis/foundry-mcp-com/foundry-mcp-com-tier-dm-api/)
- [foundry-mcp-com Tier Guest API](https://apis.io/apis/foundry-mcp-com/foundry-mcp-com-tier-guest-api/)

## Tags

tier-free

---

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