Connector tools

Every tool the Rosebud connector gives an assistant, what each one reads or changes, its limits and its error codes.

The Rosebud connector at https://mcp.rosebud.ai/mcp has ten tools. Each one needs a permission you approved when you connected.

Claude and Claude Code get seven of them. The three that exist to generate assets (create_asset, list_asset_models and get_asset_job) are available in ChatGPT and Codex only.

Tools

ToolWhat it doesChanges anything?PermissionAvailable in
list_asset_modelsLists the models create_asset can use, by category, with what each one costs in credits, and your credit balance.Noassets:readChatGPT, Codex
search_my_assetsSearches your Rosebud library: files you generated, uploaded or used in games.Noassets:readAll
get_asset_jobChecks an asset that was still being generated.Noassets:readChatGPT, Codex
list_my_gamesLists your games, newest first, including games made in Rosebud's editor.Nogames:readAll
get_gameReturns one game's title, description, play link, editor link and current version.Nogames:readAll
get_game_filesReads a game's current files. Needs code download on the owner's account.Nogames:readAll
create_assetGenerates an image, sprite, sound, music, skybox, 3D model or video into your library.Yes. Spends credits, up to the limit it sets.assets:writeChatGPT, Codex
add_file_to_libraryAdds a file you attached in ChatGPT, or a local file from a coding agent, to your library.Yes. Adds a file.assets:writeAll
publish_gamePublishes a new, unlisted browser game into your account and returns its play link and editor link.Yes. Creates a game.games:writeAll
update_gameChanges a game you own: adds or replaces files, links assets, removes paths, or changes the title, description or cover.Yes. Replaces the files it names.games:writeAll

No tool deletes a game or removes anything from your library.

How a game is sent

  • Text files (HTML, JavaScript, CSS, JSON) are sent as text. A game needs index.html at its top level.
  • Media is never typed out by the assistant. Images, sound and models are in your Rosebud library, and a game uses them by ID, at a path such as assets/hero.png.
  • Updates are patches. update_game changes only the paths it names. Everything else stays as it is, including edits made in Rosebud.
  • Versions. Every answer carries a content_version. An update must send the version the assistant last saw. If the game changed since, nothing is written and the answer lists the paths that changed.

Limits

LimitValue
Game size2,000 files and 1 GiB per game
Files in one call500 text files, 2,000 linked assets, 2,000 removed paths
One request16 MiB. Larger games are published in parts.
Title, description255 and 4,000 characters
Tool calls120 per connection per minute
Asset requests30 per person per minute, shared with the asset API
New games60 per person per hour

Results

A long generation answers with status: "pending" and a job_id in place of the asset. That is not an error: the assistant checks it with get_asset_job.

Publishing and updating a published game return a preview card with the game's title, description and a Play button that opens the game, plus its cover when it has one. In ChatGPT and Codex, Rosebud makes a cover for a new game that doesn't come with one. In Claude and Claude Code it doesn't; pass an image from the library as the cover.

Errors

Every failure has a stable code and a message that says what to do next.

CodeMeaning
invalid_inputAn argument, file, path or asset ID was refused. field, reason, path and limit say which and why.
payment_requiredcreate_asset would cost more credits than the account has. Nothing was made.
plan_requiredget_game_files on an account without code download. Updating still works.
version_conflictThe game changed since the version the assistant sent. changed_paths lists what changed.
project_busyRosie is generating in this game. Try again when it finishes.
moderation_refusedA generated asset was rejected by moderation. Its credits are returned.
throttledToo many calls. retry_after_seconds says how long to wait.
not_foundNo game or asset job with that ID in the account.
payload_too_largeThe request is over the size limit. Send fewer files, then add the rest with update_game.
terms_requiredThe account hasn't accepted Rosebud's latest terms. Open Rosebud and accept them.
unavailableRosebud can't take the call right now. Send the same call again.
internal_errorSomething failed on Rosebud's side. Try again; if it repeats, continue in Rosebud.

A connection that has expired, been revoked or lacks a permission answers HTTP 401 or 403, and the app asks you to connect again.

On this page