MCP · Codex
Generate images and video from Codex with BrShot
Connect Codex to BrShot over MCP. The agent can list the models, quote a take in credits, run it and fetch the files, inside your daily limit.
Setup
- Add the server (one line in your terminal). Codex then starts the sign-in by itself:
codex mcp add brshot --url https://mcp.brshot.com/mcp - If no sign-in page opened, run codex mcp login brshot and sign in.
- Check it with codex mcp list: the Auth column shows OAuth.
- Codex asks before each generate, because generate spends credits. Approve it in the session.
For codex exec in scripts or CI, which cannot ask, pre-approve generate in ~/.codex/config.toml:
[mcp_servers.brshot]
url = "https://mcp.brshot.com/mcp"
[mcp_servers.brshot.tools.generate]
approval_mode = "approve"An agent can also set itself up: point it at brshot.com/mcp/install.md.
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.
Things to ask
- “List the BrShot models and their prices.”
- “Quote a 16:9 FLUX still of a lighthouse at dusk.”
- “Put my mug from mug.jpg on a kitchen counter and tell me what it used.”
- “Make that take a 5-second clip with a slow dolly-in.”
The tools
Guarantees
- Credits are quoted and held before every run.
- Your daily limit is enforced on the server; agents cannot raise it.
- Sign-in is OAuth in your browser; the agent never sees a password.
Questions
- Do I install anything?
- No. BrShot runs the MCP server for you; your client connects to it with a URL.
- How does the agent sign in?
- With Google, in your browser (OAuth); the agent never sees a password. For CI, create an API key and send it as a bearer token.
- Can an agent overspend?
- Every run is quoted in credits and held before it starts. A call past your daily limit is refused with a clear error, and no tool can raise the limit.
- How do I get it?
- 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.
Claude CodeCursor (not tested yet)Claude Desktop (not tested yet)
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.