# Kubeez MCP

> Model Context Protocol server for Claude Desktop, Cursor, Claude.ai web, and any MCP-compatible client. 14 tools, 10 fetchable skills (served three ways: MCP resource, HTTPS markdown URL, OR `get_skill(name)` tool — pick whichever your client supports), and 5 user-invokable prompts spanning image, video, music, speech, captions, audio separation, and ad creatives. OAuth 2.1 + scoped API keys.

## Documentation
- [Tool reference (HTML)](https://mcp.kubeez.com/docs): browseable tool catalog with parameters, scopes, canonical upload→cost-preview→generate flows, polling cadence guidance, scope map.
- [Tool catalog (JSON)](https://mcp.kubeez.com/docs/tools.json): machine-readable list of every tool with name, scope, description.

## Endpoints
- `POST https://mcp.kubeez.com/mcp`: MCP protocol endpoint (JSON-RPC 2.0 over streamable HTTP). Use the official MCP SDK (Python `mcp`, TypeScript `@modelcontextprotocol/sdk`).
- `POST https://mcp.kubeez.com/register`: OAuth 2.1 Dynamic Client Registration
- `POST https://mcp.kubeez.com/authorize`: OAuth authorize
- `POST https://mcp.kubeez.com/token`: OAuth token exchange
- `POST https://mcp.kubeez.com/revoke`: OAuth token revocation
- `GET  https://mcp.kubeez.com/.well-known/oauth-authorization-server`: RFC 8414 metadata
- `GET  https://mcp.kubeez.com/.well-known/oauth-protected-resource`: protected resource metadata

## Tools (14)
Generation: `generate_media` (also extends Veo 3.1 via `generation_type="extend"`), `generate_music`, `generate_dialogue`, `generate_captions`, `generate_separation`, `create_ad_copy`.
Upload flow: `get_upload_url`, `get_upload_session`.
Status & estimate: `get_status` (auto-dispatches media / music / separation), `estimate` (returns credits + time).
Catalog & balance: `get_models`, `get_balance`, `get_generations`.
Skills: `get_skill(name)` — fetch the markdown body of any agent-facing skill (universal fallback for MCP clients without resources/read or web_fetch).

## Skills

Long-form agent guidance, fetched on demand. **Three equivalent fetch paths** — use the first one your client supports:
- **MCP TOOL** `get_skill(name="<skill>")` — bulletproof, works in every MCP client (Claude.ai web included). No web_fetch dependency. **Use this first.**
- **MCP `resources/read`** with the URI `kubeez://skills/<name>` — canonical, structured, surfaces in MCP-aware UIs.
- **HTTPS GET** at `https://mcp.kubeez.com/skills/<name>.md` — for non-MCP runtimes (curl, browser preview, custom integrations).

Index: [https://mcp.kubeez.com/skills/](https://mcp.kubeez.com/skills/)

| Skill | URL |
|---|---|
| `content-creation` | https://mcp.kubeez.com/skills/content-creation.md |
| `marketing-campaign` | https://mcp.kubeez.com/skills/marketing-campaign.md |
| `viral-carousel` | https://mcp.kubeez.com/skills/viral-carousel.md |
| `model-selection` | https://mcp.kubeez.com/skills/model-selection.md |
| `media-upload` | https://mcp.kubeez.com/skills/media-upload.md |
| `asset-library` | https://mcp.kubeez.com/skills/asset-library.md |
| `billing-confirmation` | https://mcp.kubeez.com/skills/billing-confirmation.md |
| `polling` | https://mcp.kubeez.com/skills/polling.md |
| `video-extend` | https://mcp.kubeez.com/skills/video-extend.md |
| `seedance-2-tiers` | https://mcp.kubeez.com/skills/seedance-2-tiers.md |

## Prompts (slash commands)
User-invokable workflows: `blog-cover`, `social-post`, `ad-creative`, `talking-avatar`, `product-animation`.

## Canonical flow
For any tool that consumes user media (edit images, motion control, lip-sync, captions, separation, ad-copy):
1. `get_upload_url(model_id=X)` → send the returned link to the user.
2. `get_upload_session(token)` → public URLs + per-file `duration_seconds` from probed metadata.
3. `estimate(model=X, reference_*_seconds=<from step 2>)` → exact preview, no deduction.
4. Quote the price to the user, wait for confirmation.
5. `generate_*` → the real call. Then `get_status(id)` until `completed`.

## Auth scopes
`generate:media`, `generate:music`, `generate:speech`, `generate:ads`, `read:balance`, `read:generations`. Create a key at https://kubeez.com/settings/api-keys.

## Related
- [REST API](https://api.kubeez.com/docs): same models via raw HTTP for non-MCP integrations.