Model Context Protocol

Clipia MCP for any AI agent

Generate images and video with 60+ models without leaving Claude, ChatGPT, Cursor or your terminal. The agent picks the model, tracks progress and shows the result right in the chat.

Get an API key REST API & SDK

60+: image & video models
10+: core agent tools
1 min: to connect

Terminal · CLI

Run a single command in your terminal (key from the Clipia Developer Console):
One command
claude mcp add --transport http clipia https://mcp.clipia.ai/mcp --header "Authorization: Bearer clipia_YOUR_KEY"
Done. Ask Claude: “Generate a neon city image with Clipia” — the preview lands right in the terminal.

Create a key in the Clipia Developer Console. Keys with the clipia_test_ prefix run in a sandbox without spending credits.

generate_image

Text-to-image or reference-based editing. Usually returns the finished image in a single call — with a preview.

generate_video

Video from text or a start frame (image-to-video). Returns request_id and the credit cost immediately.

generate_audio

Text-to-speech: choose a voice and language and receive an MP3. Use it on its own or as a voiceover in the video pipeline.

generate_music

Background music and soundtracks from a mood, genre and tempo description. Produces an instrumental MP3 by default.

wait_generation

Wait for completion: long-poll until a terminal status.

get_generation

Instant status and result: webp preview + full-quality original_url.

list_models

Model catalog with types, capabilities and credit prices.

get_model

Parameters of a specific model (input_schema) and its price.

get_balance

Credit balance and 30-day usage of the key.

search_templates

Search 3,500+ curated prompts (hybrid, RU/EN).

Product shot

“Generate a Clipia photo of a perfume bottle on black marble, soft studio light, 4k”

Animate a photo

“Take this product photo and make a 6-second video with a slow camera push-in”

Social media set

“Make 4 cover options for Reels 9:16 in a neon style — I’ll pick the best one”

Compare models

“Run one prompt through three Clipia video models and show how the results differ”

Curated prompts

“Find a cyberpunk portrait prompt in Clipia templates and generate with it”

CI pipeline

“Generate covers for every article on this list and save the links to a file” — runs headless with an API key

A sandbox for integrations

Keys with the clipia_test_ prefix return instant mock results without spending credits — handy for debugging agents and CI. Live keys include the exact cost of every generation in the response, and get_balance shows the remaining credits.

What is MCP?

Model Context Protocol is an open standard that lets AI agents (Claude, ChatGPT, Cursor and others) plug in external tools. Clipia MCP always exposes 10 core agent tools for images, video, speech, music, status and catalog access. Additional tools are controlled by feature flags. A separate app-only helper powers the interactive card and is not exposed to the AI agent.

Do I need an API key?

For Claude Code, Cursor, VS Code, Windsurf, Codex and Gemini CLI — yes, a key from the Clipia Developer Console. claude.ai and ChatGPT need no key: they connect by signing in to your Clipia account (OAuth).

How are credits charged?

Exactly like on the website: from your Clipia account balance. Every tool response includes the precise credit cost of the generation, and get_balance shows the remainder. No hidden MCP markup.

Which models are available?

Every active model in the Clipia catalog — 60+ for images and video. The agent fetches the complete list via list_models with limit: 100, including prices and capabilities; you can request a specific model by name.

Will I see the result right in the chat?

Yes. In claude.ai (web, desktop, mobile) the result renders as an interactive card with live progress and an “Original” button. In Claude Code the preview lands right in the terminal. Other clients receive full-quality file links.

How long does video take?

Images usually take up to 30 seconds and often arrive in a single call. Video renders in 1–10 minutes: the agent tracks the status via wait_generation and continues as soon as it’s ready.

Is it secure?

Keys are stored as hashes only, permissions are scoped, and a key can be revoked in one click in the Developer Console. OAuth connections use PKCE and one-time codes; access is strictly limited to your own account.

Can I use it in production and CI?

Yes. The MCP server runs on top of the same public API: idempotent retries without double charges, a queue, webhooks and SDKs. For pipelines there is the clipia_test_ sandbox and a REST API documented on the developers page.