Name: ability-check
Price: 0.005 USDC
Availability: InStock

$ man ability-check

agentutility / rollforge / ability-check

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

rollforge

CATEGORY

uncategorized

STATUS

● live

NAME

ability-check — resolves a d20 ability check, skill check, attack roll, or saving throw for tabletop rpgs

SYNOPSIS

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

     { ... }

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

DESCRIPTION

Resolves a d20 ability check, skill check, attack roll, or saving throw for tabletop RPGs. Rolls a d20 with an optional modifier and advantage/disadvantage, compares to a DC, and reports total, success/failure, and natural-20 / natural-1. Seedable. Use it as a d20 check resolver API for any RPG.

INPUT — request schema

property	type	description	req?
dc	number	Difficulty class to beat. Omit to just get the roll.	optional
modifier	number	Total bonus/penalty added to the d20 (-20..40). Default 0.	optional
advantage	boolean	Roll twice, take the higher.	optional
disadvantage	boolean	Roll twice, take the lower.	optional
seed	number	Optional integer seed for a reproducible roll.	optional

OUTPUT — response shape

field	type	description
d20_rolls	string	—
natural_roll	string	—
modifier	string	—
total	string	—
mode	string	—
dc	string	—
success	string	—
critical_success	string	—
critical_failure	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

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

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

METADATA

tags: rollforgeabilitycheckability-check
methods: POST
cluster: rollforge
price: $0.005 USDC per call

ADJACENT — other endpoints in rollforge

endpoint	description	price
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
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