# rawbit MCP server

Generate and edit images and videos, run photoshoots, UGC ads, voiceovers and workflows, and manage your products and campaigns directly inside Claude and ChatGPT. It runs on your plan's credits and signs in with your rawbit account — no API key needed.

## Endpoint

- URL: https://api.therawbit.ai/api/mcp
- Transport: Streamable HTTP (POST only, stateless)
- Auth: OAuth 2.1 with dynamic client registration and PKCE (S256). Sign in with your rawbit account; there is no API key.
- OAuth metadata: https://api.therawbit.ai/.well-known/oauth-protected-resource

## Connect a client

### Claude

1. Open Settings → Connectors
2. Click Add custom connector, name it rawbit and paste the URL below
3. Click Connect and approve the sign-in with your rawbit account

Server URL: https://api.therawbit.ai/api/mcp

### ChatGPT

1. Open Settings → Apps & Connectors → Advanced settings and turn on Developer mode
2. Click Create, name it rawbit, paste the URL below and choose OAuth
3. Approve the sign-in with your rawbit account

Server URL: https://api.therawbit.ai/api/mcp

## Tools

### Agency connections

- `list_companies`: Agency connections only: shows your companies as cards so you pick which one to work on. Every other tool then acts on that company.

### Creative agent

- `creative_agent`: Opens rawbit, your creative agent, in a window that looks like the studio's Agent page: the same shared conversations and sessions, the live work log, plans and memory notes, @ products and scenes, image attachments, and image, video and edit cards you approve in place. Credits are only spent when you approve a card. (spends credits)

### Workspace & brand

- `get_overview`: Workspace home card: image counts, product count and the latest generations.
- `brand_dna`: Opens your Brand DNA page in a window with the platform's design: Identity (logos, names, official colors, fonts, audience, socials), Visual style, Rules with rawbit's memory, and Competitors. Import from your website, Instagram or photos, see the live brand card, and save in one click. The first analysis and the first competitor search are free. (spends credits)
- `get_brand_kit`: Brand identity — lighting, colour and composition analysis, notes and brand memory.
- `update_brand_memory`: Add or remove lasting brand facts (preferences, prohibitions, product notes).
- `read_webpage`: Read a public web page — title, text and key images — for context.
- `get_billing_summary`: Remaining credits, subscription and recent credit transactions.
- `list_team_members`: Team members with their role and status.

### Products

- `edit_product`: Opens the interactive products window — browse your product cards and rename a product.
- `list_products`: Products as data, to find a product id.
- `get_product`: One product in full, with its visual analysis and reference images.
- `create_product`: Opens the add-product window — paste a store link to import the name and images, or create manually with up to 5 photos. Credits are spent only when you submit it. (spends credits)
- `update_product`: Change a product's name, brand, category, keywords or description.
- `upload_product_reference`: Add a reference image to a product from a URL or a local file (up to 5 per product).

### Image generation

- `get_credit_costs`: What every tool costs in credits right now — image and video models and edits — plus your balance.
- `image_generation`: Opens the Image generation window, same as the studio: write a prompt, add products, templates or assets, pick the model, ratio, resolution and number of images. The Generate button shows the price. (spends credits)
- `list_scenes`: The ready-made scene library as an interactive grid.
- `generate_image`: Generate a brand-styled image from a product, a scene, a prompt or gallery images — in any mix. With a product and no scene, the best scene is picked automatically. (spends credits)
- `regenerate_image`: The Regenerate button on an image card — re-rolls with a fresh scene, same product and ratio. (spends credits)
- `get_generation_status`: Check on an image job that is still running.

### Image editing

- `image_editor`: Opens the platform's image editor on one image: Edit, Mask edit, Scene light, Restyle, Camera, Background, Crop, Upscale, Logo and Reimagine, with prices shown before you apply. (spends credits)
- `edit_image`: Edit an image with any editor tool — a plain-language change, relight, restyle, new camera angle, background, crop, logo or variations. (spends credits)
- `upscale_image`: Upscale an image to a sharper, higher-resolution copy. (spends credits)
- `remove_background`: Cut out the subject — transparent, white or a solid colour behind it. (spends credits)
- `replace_background`: Keep the product exactly as it is and place it on a new background you describe. (spends credits)
- `expand_image`: Extend an image beyond its edges to landscape, portrait or square. (spends credits)

### Video

- `video_generation`: Opens the Video Generator window, same as the studio: pick the model, add start and end images, references, a video or a voiceover, write the shot or pick a template or an AI idea, then choose resolution, length and ratio. Every option and the Generate button show the price, and clips render in the window. (spends credits)
- `list_video_models`: The video models you can use, what each accepts, and the exact price per clip.
- `suggest_video_motions`: AI motion ideas for a start image — ready-to-use prompts for a video. Free.
- `animate_image`: Turn a still image into a 4–8 second product video (1080p or 4K). A failed video is refunded. (spends credits)
- `generate_video`: The full video tool: text-to-video, first/last frames, reference images, motion templates, video or voiceover references, any model. (spends credits)
- `edit_video`: Modify an existing video with an instruction — it rides as a reference into a new render. Trim, split and stitch stay in the studio clip editor. (spends credits)
- `get_video_status`: Check on a video or UGC ad until it finishes.

### Photoshoot

- `photoshoot`: Opens the Photoshoot window, same as the studio: choose a product, add shots from each direction, adjust every shot, then confirm the session total. (spends credits)
- `list_photoshoot_presets`: The shot catalogue — directions and their shot presets.
- `start_photoshoot`: Render a whole set of shots for one product in one session (up to 20). The session price is shown before it renders. (spends credits)
- `get_photoshoot_status`: Check on every shot of a photoshoot.

### UGC ads

- `ugc_ad`: Opens the UGC ad window, same as the studio wizard: choose the direction, product, presenter and voice, pick the ad vibe, write or suggest the scene cards, plan the scenes, approve the shot previews and generate. Every paid step shows its price on the button, and the ad renders in the window. (spends credits)
- `get_ugc_options`: Presenters, voices, dialects and styles, with the price of every step.
- `write_ugc_script`: Write the ad script for a product. (spends credits)
- `create_ugc_voiceover`: Voice the approved script. (spends credits)
- `plan_ugc_storyboard`: Plan the ad's shots. (spends credits)
- `generate_ugc_keyframes`: Render the opening frame of each shot so you can approve the look. (spends credits)
- `render_ugc_ad`: Render the finished ad — one clip per shot, stitched with the voiceover. (spends credits)

### Voice

- `voice_generation`: Opens the Voiceover window, same as the studio: write your script or start from a template, let the Director write it from a brief, pick the voice (with samples), style, intensity, speed and dialect, then generate. The price shows on the button, the recording plays in the window, and your recordings can be downloaded or used in a video. (spends credits)
- `list_voices`: Voices, delivery styles, limits and price.
- `write_voiceover_script`: Have rawbit write or polish a voiceover script from a brief.
- `generate_voiceover`: Synthesize a voiceover — usable as audio in generate_video. (spends credits)
- `list_voiceovers`: Your recent voiceovers.

### Workflows

- `workflow`: Opens the Workflow window, same as the studio: the home with the copilot prompt bar, the ready templates and your recent projects, and the canvas itself — product, scene, image, prompt, art director, generate image / video and output nodes wired together, with the flow cost and Run showing every step live. Nothing is spent until you press Run. (spends credits)

### Ad templates

- `ad_templates`: Opens the Templates window, same as the studio: ready-made ads playing as real clips, and a sheet where you add your product, fill the template's fields, pick the size and ratio, and generate stage by stage — the poster first, then the video after you approve it. Every button shows its price, and a template becomes a workflow you can keep editing. (spends credits)
- `list_ad_templates`: The ready-made ad templates as data: name, categories, ratio, length and the preview clip.

### Gallery

- `list_gallery`: Browse generated images and videos in an interactive grid — edit, animate, play or download each one.
- `get_recent_generations`: The most recent generated images.
- `get_image`: One generated image in full — prompt, scene, model and credits.

## Questions

### Do I need an API key?

No. Clients sign in with your rawbit account through OAuth — there is no key to copy or rotate.

### What does it cost?

The connection is included with your plan. Creating and editing images and videos spends credits exactly like the studio — ask for get_credit_costs to see prices first. Browsing your products, scenes and gallery is free.

### Where do my generations go?

Everything the assistant creates is saved to your rawbit gallery, the same as work made in the studio.

### Can my team members connect?

Yes — share the server URL with them. Each member signs in with their own rawbit account and only gets the tools their role allows (for example, a viewer can't generate images).

### Why is a tool missing or “not allowed”?

Tools follow your role's permissions in the company. Ask a company owner or admin to grant the permission, then reconnect so your client picks up the new tools.

### How long do I stay signed in?

Your client renews its access automatically while you use it. If the connection goes unused for 30 days, you'll be asked to sign in again.

### How does it work for agencies?

An agency connection covers every company in the agency. The assistant lists your companies and asks which one to act on before running a tool.

### Why do I get “subscription required”?

Every call checks that the company is active, that you're still a member and that it has plan access — credits left, an active or trial subscription, or a live contract. Subscribe or top up, then try again.

### How do I disconnect?

Remove the rawbit connector or server from your AI client. Removing a team member from the company also cuts their access on the next call.

Privacy policy: https://therawbit.ai/privacy-policy