sts2mcp

sts2mcp is a Slay the Spire 2 automation workspace with two responsibilities:

• packages/mcp-server: a local MCP server that exposes game control to agents.
• game-mod/Sts2McpBridge: a C# bridge scaffold intended to run inside an STS2 mod.

The public control surface is semantic rather than click-based. Agents ask for snapshots, inspect currently legal actions, and send typed intents such as play_card, choose_reward, or start_run.

Workspace Layout

• packages/protocol: shared TypeScript protocol schemas and example payloads.
• packages/mcp-server: MCP server, bridge transport, and tests.
• protocol/examples: example JSON messages and snapshots for integration work.
• game-mod/Sts2McpBridge: C# bridge skeleton that speaks the same wire protocol.

Development

pnpm install
pnpm test
pnpm build

The machine this was scaffolded on does not currently have dotnet installed, so the C# project is included as source and contract documentation but is not compiled as part of the Node workspace checks.