MCP Catalogs
← HomeSTS2MCP screenshot

STS2MCP

by Gennadiyev·★ 344·Score 50

MCP server for Slay the Spire 2 that exposes game state and actions for AI agents.

ai-llmotherproductivity
60
Forks
20
Open issues
this month
Last commit
2d ago
Indexed

Overview

STS2MCP is a mod for Slay the Spire 2 that exposes in-game state and actions via a localhost REST API with an MCP server for Claude integration. It supports both single-player and multiplayer modes with comprehensive game control including profile switching, character selection, and lobby management. The project is actively maintained with recent commits and provides clear documentation for both players and developers.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:AI agents playing Slay the Spire 2 autonomously
you:Automating repetitive game tasks and grinding
you:Researching AI decision-making in complex game environments
you:Is this a cheat mod?
you:How many tokens does a run consume?

When to choose this

Choose this MCP server if you're researching AI decision-making in game environments or want AI agents to play Slay the Spire 2 autonomously with full game state access.

When NOT to choose this

Don't choose if you need support for games other than Slay the Spire 2, require multiplayer AI support for games besides STS2, or prefer solutions without external game modding requirements.

Tools this server exposes

7 tools extracted from the README
  • get_game_state

    Retrieves the current game state in Slay the Spire 2

  • get_profile

    Gets the active profile's progress summary including discoveries and achievements

  • get_compendium

    Returns the compendium data including card library, relics, and run history

  • search_wiki

    Searches discovered card and relic wiki entries with fuzzy matching

  • list_profiles

    Lists all available profile slots and identifies the active profile

  • switch_profile

    Switches to a different profile slot

  • delete_profile

    Deletes a profile slot through the game UI

Comparable tools

game-mcpdesktop-automation-mcpopenai-gym-integration

Installation

  1. Download the latest release and copy STS2_MCP.dll and STS2_MCP.json to <game_install>/mods/
  2. Launch the game and enable mods in settings
  3. The mod starts an HTTP server on localhost:15526
  4. For MCP server setup, install [uv](https://docs.astral.sh/uv/) and run:

``bash uv run --directory /path/to/STS2_MCP/mcp python server.py ``

  1. Add to Claude Desktop config:

```json { "mcpServers": { "sts2": { "command": "uv", "args": ["run", "--directory", "/path/to/STS2_MCP/mcp", "python", "server.py"] } } }

FAQ

Is this a cheat mod?
The mod itself does not alter gameplay. It's just an interface allowing external programs to interact with the game. What you do with that interface is up to you.
How many tokens does a run consume?
Claude Sonnet 4.6 uses slightly more than 8M tokens for a full run. GPT-5.4 averages 7.34M tokens. Consumption can vary based on prompt and model choice.

Compare STS2MCP with

STS2MCP vs ultimate_mcp_serverSTS2MCP vs mcp-server-chartSTS2MCP vs everythingSTS2MCP vs filesystemSTS2MCP vs time
GitHub →

Last updated · Auto-generated from public README + GitHub signals.