Name: encounter-builder
Price: 0.005 USDC
Availability: InStock

$ man encounter-builder

agentutility / rollforge / encounter-builder

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

rollforge

CATEGORY

uncategorized

STATUS

● live

NAME

encounter-builder — encounter builder / encounter difficulty calculator api for d&d 5e

SYNOPSIS

POST https://x402.agentutility.ai/encounter-builder
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Encounter builder / encounter difficulty calculator API for D&D 5e. Give the party (levels, or size + level) to get easy/medium/hard/deadly XP thresholds; optionally give monster CRs to get the multiplier-adjusted XP and the resulting difficulty rating. SRD DMG tables (OGL 1.0a / CC-BY-4.0).

INPUT — request schema

property	type	description	req?
party_levels	array	Array of character levels, e.g. [3,3,4,2].	optional
party_size	number	Number of characters (use with party_level if levels are uniform).	optional
party_level	number	Shared character level (use with party_size).	optional
monster_crs	array	Optional monster challenge ratings, e.g. ["1","1/2","2"], to rate the encounter.	optional

OUTPUT — response shape

field	type	description
party_size	string	—
xp_thresholds	string	—
encounter	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/encounter-builder \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the encounter-builder tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: rollforgeencounterbuilderencounter-builder
methods: POST
cluster: rollforge
price: $0.005 USDC per call

ADJACENT — other endpoints in rollforge

endpoint	description	price
ability-check	Resolves a d20 ability check, skill check, attack roll, or saving throw for tabletop RPGs.	$0.005
background-gen	Character background generator API / personality trait, ideal, bond, flaw generator for tabletop RPGs.	$0.005
character-gen	Generates a complete D&D 5e-style character, from ability scores to a procedurally generated name.	$0.005
dice-roll	Rolls dice from standard dice notation for tabletop RPGs.	$0.005
dice-stats	Calculates the probability distribution of a dice roll, anydice-style.	$0.005
dungeon-room	Generates a random dungeon room for game masters: shape, contents, a notable feature, a hazard, an occupant, and the number of exits.	$0.005
initiative-roll	Initiative tracker / initiative order roller API for tabletop combat.	$0.005
loot-gen	Loot generator / treasure generator API for D&D 5e.	$0.005