@agentutility/mcp-rollforge

@agentutility/mcp-rollforge

The whole tabletop toolkit, one call at a time.

Dice, characters, NPCs, encounters, loot, and the full 5e SRD reference — monsters, spells, equipment, classes, races, conditions, magic items. Build a character, stat an encounter, resolve the rolls, and look up every rule without leaving the cluster.

Pricing: pay-per-call in USDC on Base. No subscriptions, no API keys. See per-tool prices below.

Install — Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "agentutility-rollforge": {
      "command": "npx",
      "args": ["-y", "@agentutility/mcp-rollforge"],
      "env": { "X402_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY_HEX" }
    }
  }
}

Restart Claude Desktop. 26 tools appear in the tool palette.

Install — Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "agentutility-rollforge": {
      "command": "npx",
      "args": ["-y", "@agentutility/mcp-rollforge"],
      "env": { "X402_PRIVATE_KEY": "0x..." }
    }
  }
}

Funding

Send any amount of USDC on Base mainnet to the address derived from your X402_PRIVATE_KEY. The MCP server uses it to pay for tool calls automatically.

USDC on Base contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Tools (26)

Tool	Description
ability-check	(0.001 USDC/call) D20 ability check / skill check / attack roll / saving throw resolver API 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. Pure deterministic compute, no upstream API.
background-gen	(0.001 USDC/call) Character background generator API / personality trait, ideal, bond, flaw generator for tabletop RPGs. Rolls the four roleplaying hooks for a character sheet — a personality trait, an ideal, a bond, and a flaw. Seedable. Pure compute, no upstream. Original generic-fantasy phrasing.
character-gen	(0.002 USDC/call) Tabletop character generator API / D&D 5e character builder / RPG character creator / random fantasy character. Generates a complete 5e-style character: ability scores (4d6-keep-highest-3, 3d6, or standard array) assigned by class priority, race / class / background / alignment, racial ability bonuses, derived hit points, ability modifiers, proficiency bonus, saving-throw proficiencies, and a procedurally generated name. Pin any field (race, class, level 1-20, method, name) or omit to randomize; pass 'seed' for a reproducible character. Pure deterministic compute, no upstream API. Uses only 5e SRD content (OGL 1.0a / CC-BY-4.0).
character-portrait	(0.08 USDC/call) Character portrait generator API / RPG character art / D&D character image / fantasy avatar generator. Builds a portrait from structured inputs — race, class, gender, a free-text description, and an art style (fantasy-art, realistic, anime, oil-painting, ink-sketch, watercolor, pixel-art, comic-book) — and renders it to a hosted PNG URL. Pairs with character-gen: generate the character, then its portrait. Text-to-image via Venice, output hosted on fal.
class-lookup	(0.003 USDC/call) D&D 5e class lookup API / SRD class reference / class proficiencies and hit dice. Look up a class by name for hit dice, armor/weapon/tool/skill proficiencies, saving throws, spellcasting ability, and starting equipment, or list all SRD classes. SRD content only (OGL 1.0a / CC-BY-4.0) via Open5e.
condition-lookup	(0.003 USDC/call) D&D 5e condition lookup API / SRD conditions reference (blinded, grappled, prone, stunned, etc.). Look up a condition by name for its full rules text, or list all SRD conditions. SRD content only (OGL 1.0a / CC-BY-4.0) via Open5e.
dice-roll	(0.001 USDC/call) Dice roller API / dice notation evaluator / RPG dice / tabletop random roll engine. Evaluates standard dice notation — XdY, flat modifiers (+/-), and keep-highest / keep-lowest (4d6kh3 for stat rolls, 2d20kh1 / 2d20kl1 for advantage/disadvantage). Returns each individual die, which were kept vs dropped, the per-roll total, and the grand total; roll the whole expression up to 100 times with 'rolls'. Pass 'seed' for reproducible output. Pure deterministic compute, no upstream API.
dice-stats	(0.002 USDC/call) Dice probability calculator API / anydice-style dice statistics / odds of a dice roll. For plain XdY+mod returns the EXACT distribution (mean, stdev, min, max, and P(>= target)); for keep-highest/lowest (4d6kh3, 2d20kl1) estimates via seeded Monte Carlo. For sizing DCs, damage, and stat rolls. Pure compute, no upstream.
dungeon-room	(0.001 USDC/call) Dungeon room generator API / random dungeon generator / D&D room description for GMs. Generates a room: shape, contents, a notable feature, a hazard, an occupant, and the number of exits. Pass 'rooms' for a small batch. Seedable. Pure compute, no upstream.
encounter-builder	(0.002 USDC/call) 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). Pure compute, no upstream.
equipment-lookup	(0.003 USDC/call) D&D 5e equipment lookup API / SRD weapons and armor / gear stats. Look up a weapon or piece of armor by name (weapon damage dice/type/properties/cost, or armor class/cost/weight/stealth), or list items by type ('weapon' or 'armor'). SRD content only (OGL 1.0a / CC-BY-4.0) via Open5e.
initiative-roll	(0.001 USDC/call) 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. Pure deterministic compute, no upstream API.
loot-gen	(0.002 USDC/call) Loot generator / treasure generator API for D&D 5e. Rolls coins (and, for hoards, gems/art objects and a magic-item slot) scaled by a challenge-rating band. SRD-style treasure math (OGL 1.0a / CC-BY-4.0). Seedable. Pure compute, no upstream.
magic-item-lookup	(0.003 USDC/call) D&D 5e magic item lookup API / SRD magic items / wondrous item reference. Look up a magic item by name for its type, rarity, attunement, and full description, or list items filtered by rarity and/or type. SRD content only (OGL 1.0a / CC-BY-4.0) via Open5e.
monster-lookup	(0.003 USDC/call) D&D 5e monster lookup API / SRD monster stat block / bestiary search. Look up a monster by name for a compact stat block (size, type, alignment, AC, HP, hit dice, speed, ability scores, challenge rating, and actions), or list monsters filtered by challenge rating and/or type. SRD content only (OGL 1.0a / CC-BY-4.0) via Open5e.
name-gen	(0.001 USDC/call) Fantasy name generator API / RPG name generator / D&D character & NPC names / random fantasy names by race. Generates original syllable-built names, optionally flavored by race (Dwarf, Elf, Half-Orc, etc.). Batch up to 50 at once with 'count'; pass 'seed' for reproducible output. Pure deterministic compute, no upstream API.
npc-gen	(0.001 USDC/call) NPC generator API / random D&D NPC / tabletop character generator for GMs. Generates a quick non-player character: name, race, occupation, personality trait, distinctive appearance, mannerism, and a hidden secret/plot hook. Pin race or occupation, or omit to randomize. Seedable. Pure compute, no upstream.
quest-gen	(0.001 USDC/call) Quest generator API / random plot hook / D&D adventure seed generator. Generates a quest hook: giver, objective, location, complication, and reward, plus a one-line ready-to-read hook. Seedable. Pure compute, no upstream. Original generic-fantasy content.
race-lookup	(0.003 USDC/call) D&D 5e race lookup API / SRD race reference / racial traits and ability score increases. Look up a race by name for ability score increases, speed, size, languages, vision, and racial traits, or list all SRD races. SRD content only (OGL 1.0a / CC-BY-4.0) via Open5e.
random-table	(0.001 USDC/call) Random table roller API / weighted random picker / loot & rumor table roller. Roll on a caller-provided table — weighted entries ([{value, weight?}]) or classic die-range rows ([{min,max,result}] with a 'die') — any number of times, with or without replacement. Seedable. A generic random-selection utility for any custom table. Pure compute, no upstream.
settlement-gen	(0.001 USDC/call) Settlement generator API / random town generator / D&D village & city generator. Generates a settlement: name, size category with a plausible population, government, primary trade, a notable feature, and a current problem the party could engage with. Pin 'size' (hamlet/village/town/city) or randomize. Seedable. Pure compute, no upstream.
spell-lookup	(0.003 USDC/call) D&D 5e spell lookup API / SRD spell search / spell card details. Look up a spell by name for full details (level, school, casting time, range, components, duration, concentration, ritual, classes, description, higher-level scaling), or list spells filtered by level and/or school. SRD content only (OGL 1.0a / CC-BY-4.0) via Open5e.
spell-slots	(0.001 USDC/call) Spell slots by class and level API / D&D 5e spellcasting slot table / pact magic lookup. Returns the level 1-9 spell-slot array for any 5e class at a given level (full casters, half-casters like Paladin/Ranger, Warlock pact magic, and non-casters), plus proficiency bonus. SRD spellcasting tables (OGL 1.0a / CC-BY-4.0). Pure compute, no upstream.
tavern-gen	(0.001 USDC/call) Tavern generator API / random fantasy inn / D&D tavern name & details. Generates a tavern: name, proprietor, the house drink and meal, a notable patron, and a rumor overheard inside. Seedable. Pure compute, no upstream. Original generic-fantasy content.
weather-gen	(0.001 USDC/call) Fantasy weather generator API / random RPG weather / tabletop campaign weather forecast. Rolls a day's weather for a climate (temperate, arid, cold, tropical) with conditions and wind. Pass 'days' for a short forecast. Seedable. Pure compute, no upstream.
xp-level	(0.001 USDC/call) XP to level calculator / D&D 5e experience table / level from XP lookup API. 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). Pure compute, no upstream.

How it works

• Agent calls a tool (e.g. ability-check).
• MCP server POSTs to https://x402.agentutility.ai/ability-check.
• The endpoint responds HTTP 402 with payment instructions.
• The MCP server signs an EIP-3009 USDC transfer authorization with X402_PRIVATE_KEY and retries.
• CDP facilitator settles on Base.
• The endpoint returns the actual response.

The agent never sees the payment flow — it just gets the result.

Links

• Cluster overview: https://agentutility.ai/rollforge/
• All MCP packages: https://mcp.agentutility.ai/
• Source: https://github.com/rooz21/x402/tree/main/packages/mcp-rollforge

Version: 0.1.0 · License: MIT