Name: initiative-roll
Price: 0.005 USDC
Availability: InStock

$ man initiative-roll

agentutility / rollforge / initiative-roll

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

rollforge

CATEGORY

uncategorized

STATUS

● live

NAME

initiative-roll — initiative tracker / initiative order roller api for tabletop combat

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Initiative tracker / initiative order roller API for tabletop combat. Each combatant rolls 1d20 plus their initiative (DEX) modifier; returns the full turn order, ties broken by modifier then input order. Seedable.

INPUT — request schema

property	type	description	req?
combatants	array	Array of { name?, modifier? } — one per combatant (max 50).	required
seed	number	Optional integer seed for reproducible rolls.	optional

OUTPUT — response shape

field	type	description
count	string	—
order	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/initiative-roll \
  -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 initiative-roll tool from your MCP-aware agent.

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

METADATA

tags: rollforgeinitiativerollinitiative-roll
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
encounter-builder	Encounter builder / encounter difficulty calculator API for D&D 5e.	$0.005
loot-gen	Loot generator / treasure generator API for D&D 5e.	$0.005