Clipia MCP

Hosted remote MCP server for AI image and video generation from one Streamable HTTP endpoint.

Documentation

Clipia MCP

Create AI images, video, speech, music and presentations inside Claude, Cursor and ChatGPT — 60+ models in one MCP endpoint.

Clipia is an AI creation platform. This hosted, remote Model Context Protocol (MCP) server lets any MCP-capable agent generate images, video, speech and music; chat with text models; plan and compose videos; create and edit presentations; poll results; browse models; search prompt templates; and read your credit balance — no SDK and no code required.

Endpoint: https://mcp.clipia.ai/mcp — stateless Streamable HTTP, authenticated with a Clipia API key.

Quick start

Connect Clipia to Claude Code in one command (replace the placeholder with your key):

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Then just ask in the chat: "Generate a neon city image with Clipia" — the preview lands right in the terminal.

Where to get a key: create one in the Clipia Developer Console. The key is shown once.

Sandbox without charges: keys with the clipia_test_ prefix run in a sandbox — instant mock results, no credits spent. Use a clipia_test_* key to validate your integration before going live.

Connect from any client

The endpoint is the same everywhere: https://mcp.clipia.ai/mcp. IDEs and CLIs authenticate with an API key from the Developer Console; claude.ai and ChatGPT connect by signing in to your Clipia account over OAuth (no key needed).

Ready-to-paste configs live in examples/.

Client	How to connect	Auth
Claude Code	`claude mcp add --transport http clipia …` (see Quick start)	API key
Claude Desktop	`mcp-remote` bridge in `claude_desktop_config.json`	API key
claude.ai (web/desktop/mobile)	Settings → Connectors → Add custom connector	OAuth
Cursor	`~/.cursor/mcp.json` (or project `.cursor/mcp.json`)	API key
VS Code	`.vscode/mcp.json` (`servers` + `inputs`)	API key
Cline	`cline_mcp_settings.json` (`mcpServers`)	API key
Windsurf	`~/.codeium/windsurf/mcp_config.json` (`serverUrl`)	API key
Codex CLI	`~/.codex/config.toml` (`bearer_token_env_var`)	API key (env)
Gemini CLI	`gemini mcp add --transport http clipia …`	API key
ChatGPT	Developer mode → Apps & Connectors → Create	OAuth

Claude Code

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Claude Desktop

Claude Desktop bridges to remote HTTP servers through mcp-remote. Add to claude_desktop_config.json (Settings → Developer → Edit Config), then restart Claude Desktop:

{
  "mcpServers": {
    "clipia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.clipia.ai/mcp",
        "--header",
        "Authorization: Bearer <CLIPIA_API_KEY>"
      ]
    }
  }
}

claude.ai (web / desktop / mobile)

Open Settings → Connectors.
Click Add custom connector and paste the URL: https://mcp.clipia.ai/mcp
Click Connect and sign in to your Clipia account — no key needed (OAuth).
In a new chat, ask for an image or a video: a live Clipia card with progress and the result appears inside the message.

Credits are charged to the connected Clipia account.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project), then restart Cursor:

{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

VS Code

Create .vscode/mcp.json in your workspace (or use the MCP: Add Server command). VS Code prompts for the key on first run and stores it securely:

{
  "servers": {
    "clipia": {
      "type": "http",
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer ${input:clipia_api_key}" }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "clipia_api_key",
      "description": "Clipia API Key",
      "password": true
    }
  ]
}

Cline

Cline reads mcpServers from its cline_mcp_settings.json (MCP Servers → Configure MCP Servers in the Cline panel):

{
  "mcpServers": {
    "clipia": {
      "url": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

Cline can also install this server itself — see llms-install.md.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json (note the Windsurf-specific serverUrl field), then refresh Cascade → MCPs:

{
  "mcpServers": {
    "clipia": {
      "serverUrl": "https://mcp.clipia.ai/mcp",
      "headers": { "Authorization": "Bearer <CLIPIA_API_KEY>" }
    }
  }
}

Codex CLI

Add a block to ~/.codex/config.toml and export the key into your environment — Codex injects Authorization: Bearer from the variable automatically:

# ~/.codex/config.toml
[mcp_servers.clipia]
url = "https://mcp.clipia.ai/mcp"
bearer_token_env_var = "CLIPIA_API_KEY"

# in your environment:
# export CLIPIA_API_KEY=<CLIPIA_API_KEY>

Gemini CLI

gemini mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Verify the connection with gemini mcp list.

ChatGPT (Developer Mode)

In ChatGPT (web): Settings → Apps & Connectors → Advanced settings → enable Developer mode (Plus, Pro, Business, Enterprise).
Back in Apps & Connectors → Create. Name it Clipia, MCP Server URL: https://mcp.clipia.ai/mcp.
Authentication — OAuth, tick "I trust this application", click Create.
Sign in to your Clipia account in the popup. In a chat press + → More → Clipia, then ask in plain text.

Supported auth header schemes: Authorization: Bearer clipia_* (recommended), Authorization: Key <key>, or X-Api-Key: <key>.

Tools

The server always exposes 10 core tools to the agent. As of 2026-07-26, production exposes 15 agent tools: the 10 core tools plus chat, scenario planning, server-side video composition, presentation generation and presentation editing. Seven app-only helpers are hidden from the AI agent. Compact schemas keep the agent's context window light.

Tool	What it does
`generate_image`	Generate image(s) from a text prompt, optionally with reference images (editing / image-to-image). Waits briefly and usually returns the finished image inline (URL + small preview). Cost in credits is returned.
`generate_video`	Start a video generation from a text prompt (text-to-video) or from a start image (image-to-video, pass `image_url`). Returns `request_id` and cost in credits immediately — renders take 1–10 min, poll with `wait_generation`.
`generate_audio`	Generate speech from text with a selected voice and language. Returns an MP3 when complete.
`generate_music`	Generate background music or a soundtrack from a description of mood, genre and tempo.
`wait_generation`	Wait for a generation to finish (long-poll up to `wait_seconds`, then returns current status). Call repeatedly until `COMPLETED`, `FAILED` or `CANCELED`. Returns output URLs (and an inline preview) when done.
`get_generation`	Get the current status/result of a generation without waiting. When `COMPLETED`, `output.images[].url` is the inline webp preview and `output.images[].original_url` is the full-quality PNG/JPG.
`list_models`	List available AI models with type (text/image/video/audio), capabilities and pricing in credits. Text models expose per-1K input/output rates; generation models expose a base price. Filter by `type` / `search`.
`get_model`	Get model details and pricing: `input_schema` for generation models; context limits and per-1K input/output rates for text models.
`get_balance`	Get the credit balance of the connected Clipia account and 30-day usage of the current API key.
`search_templates`	Search 3500+ curated prompt templates (hybrid text+semantic search, Russian or English query). Each result has a ready-to-use prompt and a recommended model.
`chat`	Currently enabled, feature-gated: chat with a text LLM using a prompt or messages array; returns reply text, token usage and credit cost.
`generate_scenario`	Currently enabled, feature-gated: turn a brief into per-scene video prompts and a soundtrack prompt.
`compose_video`	Currently enabled, feature-gated: stitch 2–20 completed scenes into a final MP4 with optional voiceover, soundtrack and subtitles.
`generate_presentation`	Currently enabled, feature-gated: render an editable PPTX, PDF and previews from a structured deck specification.
`edit_presentation`	Currently enabled, feature-gated: edit an existing deck, reorder or replace slides, change text and theme, and reuse unchanged illustrations.
`app_get_generation`	Internal / app-only: status poll used by the Clipia generation viewer card (MCP Apps). Hidden from the model; prefer `get_generation`.

Default models (used when no slug is passed): nano-banana-2 for images, seedance-2-fast-t2v / seedance-2-fast-i2v for video. Override with a model slug from list_models.

Why Clipia

Pay from Russia & CIS — Russian bank cards, SBP, MIR, no VPN required. Western processors reject these; Clipia is built for this market (and works internationally too).
60+ flagship models, one endpoint — Western and Chinese models side by side: Veo 3.1, Sora, Kling 3, Seedance 2, Hailuo, Wan 2.7, Nano Banana, FLUX, Midjourney V7, Imagen 4, and more. No juggling multiple foreign subscriptions.
Sandbox without charges — clipia_test_* keys return instant mock results with no credit spend, perfect for wiring up an integration or CI.
Live preview in the chat (MCP Apps) — on claude.ai (web/desktop/mobile) every generation renders an interactive card with live progress, the finished media and an "Original" button. In Claude Code the preview lands inline in the terminal for vision-based iteration.
3500+ prompt templates — search_templates gives the agent curated, ready-to-use prompts (hybrid search, RU/EN), each with a recommended model.
Cost in every response — every generation returns its exact cost in credits, and get_balance shows the remaining balance. No hidden MCP markup.
Compact tool surface — 10 core tools with tight schemas keep the agent's context window light; enabled capabilities add only the tools they need.

SDK

Prefer calling Clipia from your own code instead of an agent? Use the official SDKs against the same public API (fal.ai-style submit → status → result queue, credits-based billing):

TypeScript / Node: clipia-ai — npm install clipia-ai (also ships a clipia CLI).
Python: clipia — pip install clipia (sync + async clients).

Both support webhooks with HMAC-SHA256 signature verification and the same clipia_test_* sandbox keys.

Glama server runtime

The repository includes a minimal Docker runtime so Glama can start the public server entry and inspect its MCP tool definitions. The container is a stdio bridge to the hosted endpoint; it does not contain the Clipia application or any credentials.

Configure CLIPIA_API_KEY as a secret in Glama. Use a sandbox key with the clipia_test_ prefix so validation never spends credits. The optional CLIPIA_MCP_URL setting defaults to https://mcp.clipia.ai/mcp and only accepts HTTPS URLs.

docker build -t clipia-mcp-glama .
docker run --rm -i \
  -e CLIPIA_API_KEY='<CLIPIA_TEST_API_KEY>' \
  clipia-mcp-glama

Pricing

Billing is in credits from your connected Clipia account — the same balance as the website. Every generation returns its exact credit cost, and get_balance shows what's left. Different models cost different credits depending on resolution, duration and quality.

New accounts receive a small pack of welcome credits to evaluate the platform; after that a subscription is required. Four monthly plans (Basic / Standard / Pro / Ultima) — see clipia.ai/tariffs.

clipia_test_* sandbox keys return mock results with no credit charge — use them to develop and test without spending.

🇷🇺 Для России и СНГ

Clipia — AI-платформа для генерации изображений, видео, речи, музыки и презентаций, а также текстовых AI-чатов и сборки готовых роликов. Для пользователей из России и СНГ доступны оплата картой РФ, СБП и МИР, без VPN. 60+ западных и китайских моделей (Veo 3.1, Sora, Kling 3, Seedance 2, Nano Banana, FLUX, Midjourney V7) работают через один MCP-эндпоинт прямо из Claude, Cursor и ChatGPT.

Подключение в одну команду (ключ — в консоли разработчика):

claude mcp add --transport http clipia https://mcp.clipia.ai/mcp \
  --header "Authorization: Bearer <CLIPIA_API_KEY>"

Ключи clipia_test_* — песочница без списания кредитов для отладки. Биллинг в кредитах, стоимость каждой генерации возвращается в ответе. Тарифы: clipia.ai/tariffs.

Support & legal

Website: clipia.ai
Documentation: clipia.ai/en/docs/mcp
Privacy Policy: clipia.ai/privacy
Terms: clipia.ai/terms
Support: support@clipia.ai

Clipia MCP

Documentation

Clipia MCP

Quick start

Connect from any client

Claude Code

Claude Desktop

claude.ai (web / desktop / mobile)

Cursor

VS Code

Cline

Windsurf

Codex CLI

Gemini CLI

ChatGPT (Developer Mode)

Tools

Why Clipia

SDK

Glama server runtime

Pricing

🇷🇺 Для России и СНГ

Links

Support & legal

License