Skip to main content
Glama
deanxizian

balatro-codex-mcp

by deanxizian

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BALATROBOT_URLNoBalatroBot JSON-RPC root URLhttp://127.0.0.1:12346
BALATROBOT_TIMEOUTNoSingle HTTP timeout in seconds15
BALATROBOT_READ_RETRIESNoRead connection-level retries, range 0-31
BALATROBOT_ALLOW_NON_LOOPBACKNoSet to 1 to allow non-loopback addresses0

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
balatro_healthA

检查 MCP、BalatroBot、rpc.discover 与当前游戏状态;离线时返回 macOS 修复命令。

balatro_capabilitiesA

返回安全方法的精简 OpenRPC 参数与 required state;不返回被禁用的调试工具。

balatro_get_stateA

读取最新状态。每次动作前调用;decision 返回 state_token 与所有有效 0-based 索引。

balatro_available_actionsA

按当前阶段、资源和索引范围列出允许及不允许的写操作,并返回最新 state_token。

balatro_start_runA

仅 MENU 可用;不会覆盖或重置一局已经存在的游戏。

balatro_select_blindB

选择当前 Blind。所有旧索引在动作后失效。

balatro_skip_blindA

跳过 Small/Big Blind;Boss Blind 会在本地被拒绝。

balatro_play_cardsA

在 SELECTING_HAND 出牌;不自动重试。

balatro_discard_cardsA

在 SELECTING_HAND 弃牌;先检查剩余弃牌次数。

balatro_cash_outA

仅 ROUND_EVAL 可用,结算奖励并进入商店。

balatro_buy_shop_itemA

购买商店物品;先校验 SHOP、索引、资金及明显的槽位不足。

balatro_reroll_shopA

仅 SHOP 可用;商店索引在刷新后全部失效。

balatro_sell_itemA

出售 Joker 或消耗牌;Eternal Joker 会提前拒绝。

balatro_use_consumableB

使用消耗牌;目标规则最终以 BalatroBot 校验和拒绝结果为准。

balatro_choose_pack_itemB

映射上游 pack {card, targets};不猜测 Tarot/Spectral 目标数量。

balatro_skip_packC

映射上游 pack {skip:true}。

balatro_rearrangeA

重新排序指定区域;order 不得缺失、重复或越界。

balatro_next_roundA

仅 SHOP 可用,进入下一次 Blind 选择。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/deanxizian/balatro-codex-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server