Slay the Spire 2 Agent
杀戮尖塔2的MOD，将杀戮尖塔2的游戏状态与操作暴露为本地 HTTP API 包装成 MCP Server，供支持 MCP 的AI客户端直接调用
What is Slay the Spire 2 Agent?
Slay the Spire 2 Agent is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 杀戮尖塔2的mod，将杀戮尖塔2的游戏状态与操作暴露为本地 http api 包装成 mcp server，供支持 mcp 的ai客户端直接调用
杀戮尖塔2的MOD，将杀戮尖塔2的游戏状态与操作暴露为本地 HTTP API 包装成 MCP Server，供支持 MCP 的AI客户端直接调用
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- 杀戮尖塔2的MOD，将杀戮尖塔2的游戏状态与操作暴露为本地 HTTP API 包装成 MCP Server，供支持 MC
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx sts2-agentConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Slay the Spire 2 Agent
The Slay the Spire 2 Agent MCP server is a game mod that exposes the full state and actions of Slay the Spire 2 as a local HTTP API, then wraps that API as an MCP server so AI clients can observe and control the game directly. It supports reading live game state, listing legal actions, executing combat decisions, navigating the map, managing rewards and shops, and serving game metadata for cards, relics, monsters, and potions. AI researchers and hobbyists use it to build and test game-playing agents against a modern roguelike without manual instrumentation.
Prerequisites
- Slay the Spire 2 installed via Steam (Windows, macOS, or Linux)
- Python 3.11+ and the uv package manager installed
- The three mod files: STS2AIAgent.dll, STS2AIAgent.pck, and mod_id.json from the GitHub releases page
- An MCP-compatible client such as Claude Desktop or Claude Code
Download the mod files
Go to the GitHub releases page at github.com/CharTyr/STS2-Agent/releases and download STS2AIAgent.dll, STS2AIAgent.pck, and mod_id.json.
Install the mod into the game directory
Copy the three downloaded files into the mods/ subdirectory of your Slay the Spire 2 installation. The default Steam path on Windows is shown below.
C:\Program Files (x86)\Steam\steamapps\common\Slay the Spire 2\mods\Install Python dependencies with uv
Clone the repository and use uv to install the Python MCP server dependencies.
git clone https://github.com/CharTyr/STS2-Agent
cd STS2-Agent
uv syncLaunch Slay the Spire 2 with the mod enabled
Start the game through Steam and enable the STS2AIAgent mod from the mod selection screen. Once in-game, the mod starts a local HTTP API at http://127.0.0.1:8080. Verify it is running.
curl http://127.0.0.1:8080/healthStart the MCP server
Run the stdio-mode startup script. On Windows use the PowerShell script; on macOS/Linux use the shell script.
# macOS/Linux
./scripts/start-mcp-stdio.sh
# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -File .\scripts\start-mcp-stdio.ps1Add the server to your MCP client config
Configure your MCP client to launch the stdio server. Point the command at the startup script for your platform.
Slay the Spire 2 Agent Examples
Client configuration
Claude Desktop config to connect to the STS2 Agent MCP server in stdio mode on macOS/Linux. Adjust the path to match your clone location.
{
"mcpServers": {
"sts2-agent": {
"command": "bash",
"args": ["/path/to/STS2-Agent/scripts/start-mcp-stdio.sh"]
}
}
}Prompts to try
Prompts to use with the STS2 Agent once the game is running and the MCP server is connected.
- "Read the current game state and tell me what cards are in my hand."
- "List all legal actions I can take in this combat."
- "Play the Strike card targeting the first enemy."
- "What relics do I currently have and what do they do?"
- "Navigate the map and choose the path with the most Elite fights."
- "Resolve the current reward screen by picking the best card for my deck."Troubleshooting Slay the Spire 2 Agent
curl http://127.0.0.1:8080/health returns connection refused
The game must be running with the mod enabled for the HTTP API to be active. Launch Slay the Spire 2 via Steam, confirm the STS2AIAgent mod is enabled in the mod list, and navigate into a run before checking the health endpoint.
uv sync fails or uv is not found
Install uv with: 'curl -LsSf https://astral.sh/uv/install.sh | sh' on macOS/Linux, or follow instructions at docs.astral.sh/uv. Then re-run 'uv sync' in the cloned repository directory.
The MCP server connects but actions return errors about invalid game state
The server can only execute actions valid for the current game phase. Ensure you are in an active run and in the correct phase (combat, map, reward, etc.) for the action you are attempting. Use the list-legal-actions tool first to confirm available moves.
Frequently Asked Questions about Slay the Spire 2 Agent
What is Slay the Spire 2 Agent?
Slay the Spire 2 Agent is a Model Context Protocol (MCP) server that 杀戮尖塔2的mod，将杀戮尖塔2的游戏状态与操作暴露为本地 http api 包装成 mcp server，供支持 mcp 的ai客户端直接调用 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Slay the Spire 2 Agent?
Follow the installation instructions on the Slay the Spire 2 Agent GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Slay the Spire 2 Agent?
Slay the Spire 2 Agent works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Slay the Spire 2 Agent free to use?
Yes, Slay the Spire 2 Agent is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Slay the Spire 2 Agent Alternatives — Similar Coding Agents Servers
Looking for alternatives to Slay the Spire 2 Agent? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Slay the Spire 2 Agent in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Slay the Spire 2 Agent?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.