Balatro Agent
English | 简体中文
Alimenter votre agent
La commande propre à l'éditeur. Ce n'est pas un endpoint PlugMCP.
Host a copy with our keys and logs.
npx -y [email protected]Claude Code n'a pas de lien d'installation pour une commande locale. Copiez la commande ci-dessous et exécutez-la dans un terminal.
claude mcp add balatro-mcp -- npx -y balatro-mcp@0.2.6À exécuter dans un terminal.
{ "mcpServers": { "balatro-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}claude_desktop_config.json
URL distante ou commande sur votre machine ? Ce qui distingue les deux installations
Exécuter sur PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LancerDe l'éditeur
English | 简体中文
MCP server connecting AI agents to play Balatro
Let an AI agent play Balatro. Balatro Agent connects any MCP-compatible AI client to a running game. The agent can read live state, pick blinds, play and discard hands, buy jokers, and perform any action available to a human player. It needs no screen capture or vision model; everything works through text tool calls.
[!IMPORTANT] Balatro v1.1 is coming. I will try to provide support asap when its released. Any release after that will not guarantee compatibility with the v1.0 game.
Follow the SMODS installation guide for your platform. This step is the same for every Balatro mod.
Download and unpack the mod into Balatro's Mods directory:
balatro-agent-vX.Y.Z.zip from the latest release.[!TIP] On macOS you can clone and run
make install-modsfrom the repository root instead of copying by hand.
The result should look like .../Balatro/Mods/balatro-agent/main.lua.
Add the server to your MCP client configuration (Claude Code, Cursor, etc.), check the corresponding tutorials/docs. The config file might look like:
{
"mcpServers": {
"balatro": {
"command": "npx",
"args": ["-y","balatro-mcp"]
}
}
}
The whole command on one line:
npx -y balatro-mcp
By default every action result ends with a ## Next: <uri> snapshot of the surface
you now need, which saves a separate read for chat-style agents limited to one tool
call per turn. Code-mode clients (OpenCode's MCP code mode, Codex, and similar) chain
action calls and resource reads inside one program, so they can read balatro://turn
exactly when they need it. Start the server with --no-auto-context to skip the
follow-up read: actions return only what they changed, and your code reads the state
itself.
{
"mcpServers": {
"balatro": {
"command": "npx",
"args": ["-y", "balatro-mcp", "--no-auto-context"]
}
}
}
Start Balatro with the mod enabled.
Start your MCP client.
Ask the agent to play, for example:
Start a new run with the Red Deck and play through Ante 1.
[!IMPORTANT] Live game state and the wiki are exposed as MCP resources. If your agent client does not support resources properly, the agent may be unable to read the current game state or wiki pages.
{ "mcpServers": { "balatro-mcp": { "command": "npx", "args": [ "-y", "[email protected]" ] } }}Outils
Pas encore de liste d'outils. Les serveurs distants en obtiennent une après le premier contrôle d'état.
FAQ
Copiez sur cette page la configuration stdio pour Cursor, Claude Desktop, Claude Code ou VS Code. Elle utilise l'installation de l'éditeur, pas un proxy PlugMCP.
Aucune variable d'environnement requise n'est indiquée sur cette fiche.
Balatro s'exécute en local via stdio.
Dernière vérification : 2026-11-16. MCP server connecting AI agents to play Balatro