Sts2 Agent by Chartyr is a free MCP server tool and in-game mod designed to connect with Slay the Spire 2. It enables external AI clients and developers to interact with the game, providing control and access to game state. Built with Python for its server component and C# for the game mod, Sts2 Agent supports research and educational applications. It offers a structured way for AI models to play or observe the game through a local HTTP API, making it a key interface for advanced game automation.

What does Sts2 Agent connect to?

Sts2 Agent connects directly to the game Slay the Spire 2, serving a dual purpose as both an MCP server and an in-game mod. The server component, developed in Python, communicates with external AI clients, while the underlying game mod is built in C#. This architecture allows for deep interaction, enabling AI models to observe and influence gameplay. It establishes a bridge between the game environment and external intelligence, making Slay the Spire 2 accessible for automated control.

Core features and tools

Sts2 Agent exposes several callable tools for interacting with Slay the Spire 2. These include health_check for system status, get_game_state and get_raw_game_state for retrieving game information, and agent_view for a specific perspective. Actions are managed through get_available_actions and act, allowing AI clients to make moves. Additional tools like get_game_data_* provide specific data, and wait_until_actionable helps synchronize operations. These tools enable detailed control and observation of the game.

Who is it for?

Sts2 Agent is intended for developers and external AI clients engaged in research and educational endeavors. Its design supports projects focused on game automation, AI model training, and experimental gameplay scenarios within Slay the Spire 2. The program provides the necessary interface for AI to interpret game states and execute actions, making it a valuable resource for academic or exploratory AI development. Skip this if you are not a developer or an external AI client interested in game automation or research.

How to get started

The server authenticates using an API key passed as an environment variable. This involves configuring the STS2_NETWORK_BEARER_TOKEN and using HTTP transport via http://127.0.0.1:8765/mcp.

Use cases

• Allowing an AI model to auto-play or step through the game.
• Launching a local second game instance for co-operative play with an AI model.
• Exposing game state and actions via a local HTTP API for external AI clients to call and control the game.

Sts2 Agent provides a specialized interface for AI interaction with Slay the Spire 2, serving developers and AI clients in research. Its Python-based MCP server and C# game mod enable detailed game state access and action execution via HTTP. The program supports various AI-driven gameplay scenarios, from auto-playing to co-operative sessions. It is a focused solution for those building intelligent agents for the game.