BrShot.

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

ToolWhat it does
list_modelsList 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.
quoteQuote a generation. What one generation would cost in credits, without spending anything.
generateGenerate (spends credits). Start one generation; it reserves the quoted credits and never charges more (a failed take is refunded).
get_jobGet 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_jobsList my jobs. Your jobs, newest first (status, model, credits).
get_download_urlGet a download URL. A fresh signed URL (valid 1 hour) for output index of one of your completed jobs.

Your files 2

ToolWhat it does
get_upload_urlGet 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_mediaUpload a small file. Upload one of YOUR OWN small files (≤4 MB) as base64 in the call.

Account and keys 5

ToolWhat it does
account_statusAccount and credits. Your credits: balance, credits held by running jobs, used today, your daily limit and what is left.
redeem_codeRedeem a promo code. Redeem a BrShot promo code: its credits are added to your account, once per account.
create_api_keyCreate an API key. Create an API key for headless use (CI): send it as Authorization: Bearer <key>.
list_api_keysList API keys. Your API keys (id, name, first characters, created, last used, revoked).
revoke_api_keyRevoke 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.

Sign in with Google

Signing in shares your Google email address with BrShot; the privacy note says what we keep and for how long. Privacy note.