STS2 Agent

Expose the game status and operations of "Slay the Spire 2" as a local HTTP API and wrap it into an MCP server, allowing AI clients that support MCP to call it directly.

STS2 Agent

🎮 **Let AI play "Slay the Spire 2"! **

This is a mod package that exposes the game state and operations of "Slay the Spire 2" as a local HTTP API and packages it into an MCP server.

🧩 Introduction to components

• **STS2AIAgent**: Exposes game state and actions via native HTTP API.
• **mcp_server**: Wrap this local API as an MCP server for use by AI clients.

🚀 Quick Start

1. Install the module

After downloading and unzipping the release package, copy the following files into the game's `mods/` directory:

```

STS2AIAgent.dll

STS2AIAgent.pck

mod_id.json

```

The default Steam installation path is usually:

`C:\Program Files (x86)\Steam\steamapps\common\Slay the Spire 2`

The final directory structure should look like this:

```

Slay the Spire 2/

mods/

STS2AIAgent.dll

STS2AIAgent.pck

mod_id.json

```

2. Start the game and confirm that the module is loaded

Launch the game normally so the mod will load.

Then visit:

`

If the endpoint responds, the module is running.

3. Start the MCP server

**Prepare the environment first:**

• Install `Python 3.11+`
• Install `uv`

**Install uv on Windows:**

```powershell

powershell -ExecutionPolicy Bypass -c "irm | iex"

```

**Install uv on macOS:**

```bash

brew install uv

```

**Then start the default `stdio` MCP server. **

**Windows：**

```powershell

powershell -ExecutionPolicy Bypass -File ".\scripts\start-mcp-stdio.ps1"

```

**macOS / Linux：**

```bash./scripts/start-mcp-stdio.sh

```

This is the recommended default. Most desktop AI clients prefer integrating MCP via `stdio`.

4. Connect to your MCP client

If your client supports command-based MCP startup, point its working directory to `mcp_server/` and use:

```bash

uv run sts2-mcp-server

```

If your client is better suited to working over HTTP, start a web server instead.

**Windows：**

```powershell

powershell -ExecutionPolicy Bypass -File ".\scripts\start-mcp-network.ps1"

```

**macOS / Linux：**

```bash./scripts/start-mcp-network.sh

```

**Default MCP endpoint:**

`

---

🔗 **Related Links**

• GitHub project homepage

💡 **Experience Suggestions**

This mod opens up whole new possibilities for Slay the Spire 2! You can use it to train the AI, test strategies, or simply see how the AI ​​performs on difficult challenges. This is an excellent tool for developers and AI enthusiasts.