MCP server
The Model Context Protocol (MCP) is an open standard that lets AI assistants call tools. Clipbeat runs a remote MCP server, so an assistant that supports MCP can import a song, check prices, start a video and hand back the download link, all inside the conversation.
Server
Section titled “Server”| URL | https://api.clipbeat.app/mcp |
| Transport | Streamable HTTP. Each message is a POST; responses are plain JSON (no server-sent event stream). |
| Sessions | Stateless. No Mcp-Session-Id, nothing to clean up. GET and DELETE return 405. |
| Protocol versions | 2025-06-18 (preferred), 2025-03-26, 2024-11-05 |
| Auth today | Authorization: Bearer cb_live_... API key. See MCP authentication. |
| Capabilities | tools. No resources or prompts (resources/list and prompts/list return empty lists). |
| Batching | JSON-RPC batches (arrays) are accepted. |
| Tool | Read only | What it does |
|---|---|---|
create_video_from_song_url |
no | Import a song (or reuse one) and start a video. Costs credits. |
get_video_status |
yes | Status, progress, cost and the download link when done. |
list_my_videos |
yes | The account’s latest videos. |
get_pricing |
yes | Price per tier, optionally for a specific song. |
get_balance |
yes | Credit balance and the link to add credits. |
How an assistant uses it
Section titled “How an assistant uses it”The server sends these instructions to the client when it connects:
Clipbeat turns a song into a music video for the signed-in account. Typical flow: get_pricing, then create_video_from_song_url (start with tier preview), then poll get_video_status every 30 to 60 seconds until status is completed and share result.video_url. Payment comes from the account’s credit balance; on insufficient_credits give the user topup_url (never ask for card details). The lead is always an original AI character; do not describe real or famous people.
A typical conversation:
- The user shares a song link and asks for a video.
- The assistant calls
get_pricingand tells the user the price. - The user confirms they own the song. The assistant calls
create_video_from_song_urlwithrights_attestation: trueandtier: "preview". - The assistant calls
get_video_statusevery 30 to 60 seconds and sharesresult.video_urlwhen the status iscompleted.
MCP or REST?
Section titled “MCP or REST?”| MCP server | REST API | |
|---|---|---|
| Best for | AI assistants and agent frameworks | Your own code, automations, backends |
| Song import and video start | One tool call | Two requests (POST /v1/songs, then POST /v1/videos) |
| Same prices, limits and rules | yes | yes |
Both use the same account, credits, rate limits and content policy.
- Tools reference: inputs, outputs and example calls.
- Connect a client: Claude, Cursor, VS Code, ChatGPT, n8n and others.