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
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.