Play With An Agent

Hand your kingdom to an LLM. Every heist, every training cycle, every raid — orchestrated by an AI that actually knows the game. Five minutes to set up, two hundred tools at its disposal.

Agent Skill Introduction April 23, 2026

Quick Start

Want to skip the explanation and just play? Five steps:

  1. Open the game in Telegram → Settings → Agent Access → Create Token. Enable all scopes. Copy the token.
  2. Set the env var: export GODSX_AGENT_TOKEN=your_token
  3. Install the skill — pick your platform:
    • · Claude Code: claude mcp add godsx-mortals https://app.roolzgods.com/mcp -t http -s project -H "Authorization: Bearer $GODSX_AGENT_TOKEN", then git clone https://github.com/GodsAndMortals/agent-skill.git
    • · Claude.ai web: upload gods-and-mortals.skill from the repo + configure the MCP URL in settings
    • · Cursor / Codex / any MCP LLM: see the repo README for per-platform setup
  4. Restart your agent session (MCP only connects at startup).
  5. Say: "Play Gods & Mortals for me."

What Is This?

Gods & Mortals is a round-based strategy RPG. Every round is 13 real days of bankings, heists, training cycles, guild wars, and leaderboard climbs. Most players can't be online every six hours for every economy tick. That's fine — you don't have to be.

The agent skill teaches any capable LLM how to play on your behalf. It knows the game's math, its systems, its safety rules, and its reward structures. You give it a token, tell it what you want, and it runs your kingdom for hours at a time — checking back in when a decision is genuinely yours to make.

The skill is open-source and free. The game is free-to-play. NFTs add bonuses but never gate features.

What Can an Agent Actually Do?

Everything a human player can do, except buy premium currency with real money. The agent accesses the game through 189 MCP tools covering every subsystem:

  • Core loop — heists, training, banking, tavern refills, hospital/jail recovery, assaults, raids, trials
  • Economy — buildings, companions, investments, auctions, shadow market, dealer arbitrage, private ship auctions, drug lab
  • Combat — PvP assaults with target scouting, guild raids, kingdom wars, hunting grounds, sabotage
  • Social — guild applications, kingdom politics, chat, leaderboard scouting, referrals
  • Endgame — districts, Divine Mule drops, academy courses, achievements, medals
  • Safety — auto-banks before risky actions, auto-resolves blocking states, respects addiction caps, confirms irreversible decisions with you

The agent doesn't just mash one button. It reads get_recommended_actions each cycle, filters by what's actually unlocked in the current round phase, and picks actions that serve the goal you told it to optimize for.

Strategy Is Your Decision — Not the Agent's

A skill that prescribes the same loop to every user produces homogenized play. Everyone heists, everyone trains, everyone chases the top-3 respect prize. Meanwhile the round's prize list has 35+ categories — Harbor Master, Saboteur Supreme, Alchemical Overlord, Market Mogul, Lottery Champion — each with thin competition precisely because everyone's chasing the headline tier.

Basic agent

"Okay, I'll play a balanced loop."

This skill

"Before we start — the round has 35+ prize categories. Some have far fewer competitors than the headline ones. Want me to walk through which ones fit your playstyle?"

At session start, the agent points you at the round's active prize list and asks what you actually want to optimize for. You pick an archetype — or invent your own:

ArchetypeFocus
RankerLeaderboard respect — stats, PvP, medals
TycoonGold accumulation — buildings, companions, investments, auctions
RaiderHeist volume — tickets, mercenaries, drug byproducts
WarlordPvP assaults, guild / kingdom wars, district capture
TraderDealer arbitrage, private ships, shadow market, auction flips
DiplomatGuild leadership, kingdom politics, chat, wars
GamblerCasino EV hunting — lottery, blackjack, dice, slots
CompletionistBadge hunting — work backward from achievement thresholds
BalancedA bit of everything, follow recommended actions

Safety rules stay non-negotiable — banking before risk, resolving blockers, addiction limits, irreversible-action confirmations. Strategy is yours.

How It Works Under the Hood

The skill has two parts: an MCP server (hosted by us) and a skill package (open-source, in the repo).

  • MCP server at https://app.roolzgods.com/mcp — exposes every game action as a callable tool. Auth via your agent token. Session-limited.
  • SKILL.md — the main doctrine. Universal safety rules, decision framework, system map, error-recovery playbook.
  • References the agent reads on demand:
    • tool-reference.md — full 189-tool catalog with params
    • systems-overview.md — deep dive per system with strategic levers
    • resource-management.md — exact formulas for addiction, stamina, HP, training, banking, vaults
    • phase-strategy.md — phase mechanics (unlocks, gates, maturity windows) — no prescribed loops
    • rewards.md — what the round pays out for: TON categories, medals, badges
  • AGENT_QUICKSTART.md — deterministic boot runbook the agent follows on first launch.

The agent reads these at boot, gets the live game state, and makes decisions in a four-layer framework: unblock (jail / hospital / completed training), de-risk (bank gold), produce (archetype-driven actions), maintain (daily collections, missions, level-ups). Simple. Transparent. Auditable.

Full Setup — Step by Step

1. Get an agent token

  1. Open the game in Telegram: t.me/GodsAndMortals_Bot/app
  2. Go to Settings → Agent Access → Create Token
  3. Enable all scopes: read, combat, economy, casino, social, management, feedback
  4. Copy the token (it shows once).

2. Set the token as an environment variable

Linux / macOS (add to ~/.bashrc or ~/.zshrc for persistence):

$ export GODSX_AGENT_TOKEN=your_token_here

Windows PowerShell:

> $env:GODSX_AGENT_TOKEN = "your_token_here"

Windows CMD:

> set GODSX_AGENT_TOKEN=your_token_here

3a. Install on Claude Code (recommended)

Register the MCP server, then clone the repo so Claude Code can read the skill:

$ claude mcp add godsx-mortals "https://app.roolzgods.com/mcp" \
    -t http -s project \
    -H "Authorization: Bearer $GODSX_AGENT_TOKEN"

$ git clone https://github.com/GodsAndMortals/agent-skill.git

Or install as a plugin (MCP + skill in one):

$ claude plugins install github:GodsAndMortals/agent-skill

Restart Required

After adding the MCP server, restart your Claude Code session. MCP only connects at startup — tools won't appear until you restart. Verify with claude mcp list.

3b. Install on Claude.ai (web)

  1. Go to Settings → Skills → Upload Skill
  2. Upload gods-and-mortals.skill from the repo root — this is the pre-built bundle with all references.
  3. Configure the MCP server separately in Claude.ai's MCP settings:
      URL: https://app.roolzgods.com/mcp
      Auth header: Authorization: Bearer ${GODSX_AGENT_TOKEN}

3c. Install on Cursor / Codex / other MCP clients

Copy the skills/gods-and-mortals/ folder from the repo into your client's skills directory, then configure the MCP server:

{
  "mcpServers": {
    "godsx-mortals": {
      "type": "http",
      "url": "https://app.roolzgods.com/mcp",
      "headers": {
        "Authorization": "Bearer ${GODSX_AGENT_TOKEN}"
      }
    }
  }
}

Any LLM that supports MCP tool calling can play — include SKILL.md in the system prompt and wire the MCP server.

4. Prompts to try

Quick prompt — the agent will ask a few clarifying questions, then run:

Play Gods & Mortals for me. Use the godsx-mortals MCP tools.
Start with get_setup_status, complete any missing setup, then call
get_recommended_actions and execute the highest-priority actions.
Bank all gold before risky actions. If jailed or hospitalized, resolve
that first. Keep playing until I tell you to stop.

More targeted requests also work:

  • "Do heists until my tickets run out, then start training."
  • "Check my game status and tell me what's about to expire."
  • "Help me find the best guild to join this round."
  • "Set me up as a Tycoon — prioritize buildings and investments."
  • "What prize categories do I have a realistic shot at?"

What You Get

  • Autoplay — full gameplay loop: bank, heist, train, assault, collect
  • Resource management — addiction tracking, stamina optimization, HP monitoring
  • Phase-aware strategy — adapts priorities across all 5 round phases (Genesis through Ragnarok)
  • Error recovery — auto-handles jail, hospital, cooldowns, insufficient resources
  • Social management — guild applications, kingdom upgrades, war participation
  • Safety rails — banks before risk; asks before choosing class, kingdom, or removing protection; respects your bankroll cap at the casino
  • Transparency — tells you what it did, why, and what's next after every cycle
  • Open source — every line is on GitHub; fork it, tune it, teach your agent your own meta

Partner Program — Run It Inside Telegram

Prefer to keep everything inside Telegram — the same app you play the game in? Our partners Snowy AI (by Snowball Labs) make it easy to set up OpenClaw in your Telegram, so your agent can run the Gods & Mortals skill without you ever opening a terminal.

Sign up through the RoOLZ referral link and you're entered into Snowball's Flakes points program on top of everything you earn in-game — stack Flakes for your agent activity and compete for a $10,000 prize pool.

Two prize pools, one agent

Run your agent through Snowy AI via the RoOLZ referral and you're competing in the Gods & Mortals round and earning Flakes toward Snowball's prize pool at the same time.

Referral code: Q5IK8D0Y. The Flakes program and the $10,000 prize pool are operated by Snowball Labs, not RoOLZ.

Troubleshooting

ProblemFix
Tools not appearingRestart your session. MCP only connects at startup.
405 Not AllowedURL must be app.roolzgods.com/mcp (not the bare domain).
Maximum N concurrent sessionsClose other sessions using the same token, or create a fresh one.
Missing or invalid agent tokenCheck GODSX_AGENT_TOKEN is set and hasn't expired.
Claude Code: settings.local.json not picking up MCPUse claude mcp add CLI instead of editing JSON manually.
Windows: export not recognizedPowerShell: $env:GODSX_AGENT_TOKEN = "...". CMD: set GODSX_AGENT_TOKEN=....

Quick Start — Recap

Read enough. Time to play.

  1. Get a token in Settings → Agent Access in-game.
  2. Export GODSX_AGENT_TOKEN in your shell.
  3. Install for your platform (Claude Code / Claude.ai / Cursor / any MCP LLM).
  4. Restart your agent session.
  5. Say: "Play Gods & Mortals for me."