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

/npc-gen

PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
rollforge
CATEGORY
uncategorized
STATUS
live
NAME
npc-gen generates a quick npc for game masters: name, race, occupation, personality trait, distinctive appearance, mannerism, and a hidden secret…
SYNOPSIS
POST https://x402.agentutility.ai/npc-gen
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

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

Generates a quick NPC for game masters: name, race, occupation, personality trait, distinctive appearance, mannerism, and a hidden secret/plot hook. Pin race or occupation, or omit to randomize. Seedable. Use it as an NPC generator API, random D&D NPC, or tabletop character generator for GMs.

INPUTrequest schema
propertytypedescriptionreq?
racestringOptional race: Human, Elf, Dwarf, Halfling, Dragonborn, Gnome, Half-Elf, Half-Orc, Tiefling.optional
occupationstringOptional occupation to pin (e.g. blacksmith). Omit to randomize.optional
seednumberOptional integer seed for a reproducible NPC.optional
OUTPUTresponse shape
fieldtypedescription
namestring
racestring
occupationstring
personalitystring
appearancestring
mannerismstring
secretstring
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/npc-gen \
  -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 npc-gen tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
rollforgenpcgennpc-gen
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