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
| Tool | What it does | Changes anything? | Permission | Available in |
|---|---|---|---|---|
list_asset_models | Lists the models create_asset can use, by category, with what each one costs in credits, and your credit balance. | No | assets:read | ChatGPT, Codex |
search_my_assets | Searches your Rosebud library: files you generated, uploaded or used in games. | No | assets:read | All |
get_asset_job | Checks an asset that was still being generated. | No | assets:read | ChatGPT, Codex |
list_my_games | Lists your games, newest first, including games made in Rosebud's editor. | No | games:read | All |
get_game | Returns one game's title, description, play link, editor link and current version. | No | games:read | All |
get_game_files | Reads a game's current files. Needs code download on the owner's account. | No | games:read | All |
create_asset | Generates an image, sprite, sound, music, skybox, 3D model or video into your library. | Yes. Spends credits, up to the limit it sets. | assets:write | ChatGPT, Codex |
add_file_to_library | Adds a file you attached in ChatGPT, or a local file from a coding agent, to your library. | Yes. Adds a file. | assets:write | All |
publish_game | Publishes a new, unlisted browser game into your account and returns its play link and editor link. | Yes. Creates a game. | games:write | All |
update_game | Changes 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:write | All |
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.htmlat 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_gamechanges 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
| Limit | Value |
|---|---|
| Game size | 2,000 files and 1 GiB per game |
| Files in one call | 500 text files, 2,000 linked assets, 2,000 removed paths |
| One request | 16 MiB. Larger games are published in parts. |
| Title, description | 255 and 4,000 characters |
| Tool calls | 120 per connection per minute |
| Asset requests | 30 per person per minute, shared with the asset API |
| New games | 60 per person per hour |
Results
list_my_games lists the games an assistant can read and change. Games made with an older version of Rosebud can't be used this way, so they aren't listed. The answer says how many were left out, and you can open those from your profile in Rosebud.
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.
| Code | Meaning |
|---|---|
invalid_input | An argument, file, path or asset ID was refused. field, reason, path and limit say which and why. |
payment_required | create_asset would cost more credits than the account has. Nothing was made. |
plan_required | get_game_files on an account without code download. Updating still works. |
version_conflict | The game changed since the version the assistant sent. changed_paths lists what changed. |
project_busy | Rosie is generating in this game. Try again when it finishes. |
moderation_refused | A generated asset was rejected by moderation. Its credits are returned. |
throttled | Too many calls. retry_after_seconds says how long to wait. |
not_found | No game or asset job with that ID in the account. |
payload_too_large | The request is over the size limit. Send fewer files, then add the rest with update_game. |
terms_required | The account hasn't accepted Rosebud's latest terms. Open Rosebud and accept them. |
unavailable | Rosebud can't take the call right now. Send the same call again. |
internal_error | Something 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.