Quick start
Connect Kubeez MCP and run your first generation in 5 minutes.
#1. Add the server
In your MCP client (Cursor, Claude Desktop, ChatGPT custom GPT, etc.), open MCP / integrations settings and add:
https://mcp.kubeez.com/mcp
#Cursor — one-click
Opens Cursor directly via the MCP install protocol — no intermediate browser tab. After it confirms the server, complete OAuth in the browser when prompted.
#Claude Code — CLI
claude mcp add --transport http kubeez https://mcp.kubeez.com/mcp
Paste in your terminal. OAuth opens in your browser on first use.
#Codex CLI
codex mcp add kubeez --url https://mcp.kubeez.com/mcp
Paste in your terminal. The server is saved to ~/.codex/config.toml; OAuth opens in your browser on first use.
#2. Authorize
When the client asks you to sign in:
- You'll be redirected to Kubeez in a browser tab.
- Sign in (or create an account).
- Review the requested capabilities — for example Generate media, Read balance.
- Click Approve.
The client receives a token and can now call Kubeez tools using your account and credits.
#API-key clients
Clients without OAuth (e.g. ChatGPT custom GPTs) ask for an access token. Generate one at Settings → MCP, copy it once, paste it into the client's token field. Same server URL.
#3. Try a generation
Ask your assistant to do something creative:
- "Generate an image of a sunset over mountains, 16:9."
- "Make a 5-second video of ocean waves at golden hour."
- "Create a chill lofi beat, 70 BPM, instrumental."
- "Generate 3 ad variants from this reference image and my product."
The assistant picks the right tool, starts the job, polls until ready, and shares the result links.
#Tools at a glance
| Tool | Purpose |
|---|---|
| get_models | Live catalog of models, capabilities, and pricing. Always call first to pick a model. |
| get_balance | Check credit balance. |
| get_upload_url + get_upload_session | Two-step flow when the user has a local file to upload. |
| estimate_generation_cost | Preview cost without deducting credits. |
| generate_media | Start an image or video generation. |
| generate_music | Start a song. |
| generate_dialogue | Multi-speaker TTS. |
| generate_captions | Transcribe a video. |
| generate_separation | Split audio into vocals + instrumental. |
| create_ad_copy | Generate ad variants. |
| get_*_status | Poll a job until completed. |
The full per-tool reference (parameters, scopes, response shape) lives at mcp.kubeez.com/docs.
Next: Getting connected for permissions and tokens, or How it works for the polling and billing flow.