eggox mcp

eggox mcp

Speaks the Model Context Protocol on stdin and stdout, so an agent that supports MCP gets the commands as tools without a shell. Same login, same limits.

Configuring an agent

Add Eggox to your agent's MCP configuration:

{ "mcpServers": { "eggox": { "command": "eggox", "args": ["mcp"] } } }

When building games or tooling, agents should follow the instructions in AGENTS.md.

Tools

tool	does
eggox_games	the games you own
eggox_blueprint_render	see any blueprint frame or selected layers as an inline PNG
eggox_render	see experience layouts, selected rooms or a section as an inline PNG
eggox_render_quota	remaining hourly account render allowance and reset time
eggox_pull	a game as files into a folder (game, dir)
eggox_check	would the folder work (dir)
eggox_push	make the game match the folder (dir, force)
eggox_playtest	play the pushed draft headless and return what the scripts did (dir, steps, room, reset, push)
eggox_logs	the last playtest's logs and errors (dir)
eggox_bag	the mints in your bag
eggox_stock	what the game holds (dir)
eggox_entrance	get, set or reset entrance artwork from stock (action, item, dir); applies immediately
eggox_stock_add	a mint into the stock (item, dir)
eggox_docs	the reference as markdown (page: api, project or blueprints)

There is no game-publish tool. An agent can push all day; only a person ships.

Blueprints use the same login and MCP process. eggox_blueprints lists your items; eggox_blueprint_schema exports the offline frame contract. The eggox_blueprint_init, pull, check, frame, push, and history tools work with files, keeping voxel arrays out of tool replies. Tools never spend Voxels: publishing an iteration costs them, so the user publishes in Eggox. eggox_blueprint_mint strikes the editions of a published iteration (free, once per design, the count is its whole supply) when the user asks. A push can be refused with design_taken when a frame copies somebody else's blueprint exactly. Old games-only logins need eggox login again to approve creator access. See Blueprint files, or eggox docs blueprints.