---
title: "Generate a tabletop RPG encounter with CR-appropriate monsters, terrain, and loot (D&D 5e or Pathfinder 1e)"
method: POST
path: "/api/tools/oracle_encounter"
---

# Generate a tabletop RPG encounter with CR-appropriate monsters, terrain, and loot (D&D 5e or Pathfinder 1e)

`POST /api/tools/oracle_encounter`

## Request

- Base URL: `https://tools.moddable.games`
- URL: `https://tools.moddable.games/api/tools/oracle_encounter`
- Auth: none declared

## Request body

- object
  - `system` 'dnd-5e' | 'pathfinder-1e': Game system (default: dnd-5e)
  - `party_level` number: Average party level 1-20 (default: 5)
  - `party_size` number: Number of players 1-10 (default: 4)
  - `difficulty` 'easy' | 'medium' | 'hard' | 'deadly': Encounter difficulty (default: medium)
  - `monster_type` string: Filter by type (undead, dragon, beast, etc)
  - `terrain` string: Terrain type (omit for random)

## Response `200`

Tool result

---

[API](https://skmtc.dev/moddable/apis/moddable-games-tools.md) · [All operations](https://skmtc.dev/moddable/apis/moddable-games-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/moddable/apis/moddable-games-tools/revisions/637a0b62cb9a?raw)