Quick start
Connect Kubeez MCP in a few steps.
#1. Open your MCP client
Add the Kubeez MCP server in your client’s MCP or integrations settings (many MCP clients are supported).
#2. Enter the server URL
Use:
https://mcp.kubeez.com/mcp
#3. Authorize
When the client asks you to log in or authorize:
- You’ll be sent to Kubeez in your browser.
- Sign in (or create an account).
- Review the capabilities the client is asking for (e.g. generate media, read balance).
- Approve to grant access.
After that, the client receives a token and can call Kubeez tools using your account and credits.
#4. Start using tools
You can ask the assistant to, for example:
- “Generate an image of a sunset over mountains.”
- “Create a 10-second video of ocean waves.”
- “Generate a pop song with female vocals.”
- “Create 3 ad variants from this reference image and my product.”
The assistant will use the appropriate tools and poll until the job is done, then share the result links.
#Tools at a glance (TL;DR)
| Tool | What it does |
|---|---|
| get_models | Returns available AI models with cost (credits), estimated time, and capabilities. Filter by model_type (image, video, music). Use model IDs from here when calling generate_media or generate_music. |
| get_balance | Returns your current Kubeez credit balance. |
| get_generations | Returns your latest 20 media generations with optional filters (status, model, generation_type). |
| get_generation_status | Poll a media generation by ID; returns status (pending, processing, completed, failed) and output URLs when done. |
| generate_media | Starts an image or video generation. Requires prompt and model (from get_models); optional source_media_urls for image-to-video/image-to-image. Poll with get_generation_status. |
| generate_music | Starts a music generation. Requires prompt; optional instrumental flag. Poll with get_music_status. |
| get_music_status | Poll a music generation by ID; returns status and song URLs when done. |
| create_ad_copy | Starts ad-copy generation: provide a reference ad image URL and your product (image URL or text). Returns generation IDs to poll with get_generation_status. |
For model list and pricing synced to the database, see Available models.
Next: Getting connected for more on permissions and tokens.
