Brainrotshorts

BrainrotShorts

Create and manage 9:16 short-form videos with BrainrotShorts. Prefer the MCP server for interactive agent work and use the REST API for HTTP automations or capabilities not exposed through MCP.

Choose the integration

• Use the BrainrotShorts MCP tools when they are available. Read references/mcp.md before the first MCP workflow.
• Use REST for AI voice-over projects, direct HTTP integrations, or when MCP is unavailable. Read references/rest-api.md before making a REST request.
• Treat the live MCP tool schemas and the canonical REST documentation as authoritative if bundled examples differ.
• Never send an MCP key to the REST API or a REST key to MCP; the scopes are separate.

Apply the operating rules

1. Identify the requested format: brainrot dialogue, Reddit story, or AI voice-over.
2. Gather only missing creative inputs. Infer reversible style choices when the request is open-ended.
3. Discover valid character, background, caption, sticker, font, project, and overlay IDs with list/get tools. Never invent IDs.
4. Build a draft before rendering. Inspect the resulting project and correct obvious script or configuration issues.
5. Start a paid render only when the user has explicitly asked to render, export, or create the finished video. Pass approved: true only in that case.
6. Poll render status until it succeeds, fails, or needs user action. Return the finished output URL when available.
7. Ask for explicit confirmation immediately before project_delete or the equivalent REST delete call.

Do not expose API keys in chat, source files, logs, or command output. Use environment variables or the MCP client's secret configuration. If a key is exposed, stop using it and tell the user to rotate it.

Run a brainrot dialogue workflow

1. Use script_ideate when the user needs ideas; otherwise start from their concept.
2. Call character_list, background_list, and caption_style_list before selecting IDs.
3. Call project_create with the selected catalog values.
4. Call script_generate, present or select the best variation according to the user's direction, then call project_apply_script.
5. Use project_get, project_update, and project_scene_update for the final review and adjustments.
6. Call render_start with approved: true only when authorized, then poll render_status and finish with render_latest_url.

Run a Reddit story workflow

• For a Reddit URL, use reddit_video_create_from_url for the shortest route or stage the work with reddit_post_fetch, reddit_post_repurpose, and reddit_project_create when review is important.
• For an original story prompt, use reddit_video_create_from_prompt for the shortest route or reddit_script_generate followed by reddit_project_create for more control.
• Keep approved: false while drafting. Set it to true only when rendering is authorized.
• Use reddit_project_update to refine voice, background, captions, playback rate, music, watermark, or story blocks.

Add overlays

1. Render the base project first.
2. Call overlay_timeline to understand scene and caption timing.
3. Discover assets with overlay_sticker_list, overlay_font_list, and overlay_image_list. Upload remote images with overlay_image_upload before adding them.
4. Use overlay_add or overlay_update with normalized positions and explicit millisecond timing.
5. Inspect with overlay_get, then call overlay_render with approved: true only when authorized.

Use the REST API

Use https://www.brainrotshorts.com/api/v1 and send the REST key in X-API-Key. Add a unique Idempotency-Key to mutating POST requests so network retries do not create duplicate projects, jobs, or renders. Follow the endpoint sequences in references/rest-api.md.

Shape the creative brief

Read references/content-workflows.md when the request does not already provide a finished script and production settings. Keep the final brief compact: topic, audience, hook, format, target duration, voice/tone, visual background, caption style, and CTA.

Report completion

Return the project ID, format, important creative choices, render status, and output URL. If the render is still processing, return the render ID and current status without claiming completion. Include the request ID for REST failures so support can trace the request.