MCP · 13 tools
All 13 BrShot MCP tools
What an agent can do with BrShot: list the models, quote a take in credits, run it, fetch the files, upload your own inputs and check your credits.
Make 6
| Tool | What it does |
|---|---|
list_models | List models. The models you can use: id (pass it as model), name, kind (image/video/audio/text), inputs with their types and limits, price in credits and a typical estimate. |
quote | Quote a generation. What one generation would cost in credits, without spending anything. |
generate | Generate (spends credits). Start one generation; it reserves the quoted credits and never charges more (a failed take is refunded). |
get_job | Get a job. Status of one of your jobs: processing | completed (outputs with signed download URLs valid 1 hour, text for text models) | failed (with the reason; failed takes are refunded) | blocked (moderation). |
list_jobs | List my jobs. Your jobs, newest first (status, model, credits). |
get_download_url | Get a download URL. A fresh signed URL (valid 1 hour) for output index of one of your completed jobs. |
Your files 2
| Tool | What it does |
|---|---|
get_upload_url | Get an upload URL. A one-time URL to upload one of YOUR OWN files (image ≤10 MB, video ≤50 MB/60 s, audio ≤20 MB/10 min) with an HTTP PUT of the raw bytes, valid 15 minutes. |
upload_media | Upload a small file. Upload one of YOUR OWN small files (≤4 MB) as base64 in the call. |
Account and keys 5
| Tool | What it does |
|---|---|
account_status | Account and credits. Your credits: balance, credits held by running jobs, used today, your daily limit and what is left. |
redeem_code | Redeem a promo code. Redeem a BrShot promo code: its credits are added to your account, once per account. |
create_api_key | Create an API key. Create an API key for headless use (CI): send it as Authorization: Bearer <key>. |
list_api_keys | List API keys. Your API keys (id, name, first characters, created, last used, revoked). |
revoke_api_key | Revoke an API key. Revoke one of your API keys; requests with it stop at once. |
Coming next to the MCP server: characters, projects and flows.
Sign in with Google in your agent: 50 free credits a month. The MCP server is hosted: you connect with a URL and sign in, with nothing to install. The same account and credits work on brshot.com.
Free credits every month
Sign in with Google and get 50 free credits every month. Unused credits do not roll over. Your credits also work in Claude Code and Codex through the BrShot MCP server.
Signing in shares your Google email address with BrShot; the privacy note says what we keep and for how long. Privacy note.