Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man xp-level

/xp-level

agentutility / rollforge / xp-level
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
rollforge
CATEGORY
uncategorized
STATUS
live
NAME
xp-level converts between xp and level using the d&d 5e experience table
SYNOPSIS
POST https://x402.agentutility.ai/xp-level
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

Converts between XP and level using the D&D 5e experience table. Give 'xp' to get the current level, XP to the next level, and progress; or give 'level' to get the XP needed to reach it. Returns proficiency bonus. SRD advancement table (OGL/CC). Use it as an XP to level calculator or level from XP lookup API.

INPUTrequest schema
propertytypedescriptionreq?
xpnumberTotal experience points; returns the level it maps to.optional
levelnumberLevel 1-20; returns the XP needed to reach it.optional
OUTPUTresponse shape
fieldtypedescription
xpstring
levelstring
proficiency_bonusstring
next_levelstring
xp_for_next_levelstring
xp_remainingstring
progress_to_nextstring
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/xp-level \
  -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 xp-level tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
rollforgexplevelxp-level
methods
POST
cluster
rollforge
price
$0.005 USDC per call
ADJACENTother endpoints in rollforge
endpointdescriptionprice
ability-checkResolves a d20 ability check, skill check, attack roll, or saving throw for tabletop RPGs.$0.005
background-genCharacter background generator API / personality trait, ideal, bond, flaw generator for tabletop RPGs.$0.005
character-genGenerates a complete D&D 5e-style character, from ability scores to a procedurally generated name.$0.005
dice-rollRolls dice from standard dice notation for tabletop RPGs.$0.005
dice-statsCalculates the probability distribution of a dice roll, anydice-style.$0.005
dungeon-roomGenerates a random dungeon room for game masters: shape, contents, a notable feature, a hazard, an occupant, and the number of exits.$0.005
encounter-builderEncounter builder / encounter difficulty calculator API for D&D 5e.$0.005
initiative-rollInitiative tracker / initiative order roller API for tabletop combat.$0.005
SEE ALSO
agentutility · rollforge · x402 · mcp · llms.txt · registry.json · bazaar.x402.org