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):

Terminal

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

Terminal

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:

config.json

{
  "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:

config.json

{
  "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:

config.json

{
  "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):

config.json

{
  "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:

config.json

{
  "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:

server.ts

# ~/.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

bash

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.

Terminal

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.

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

Terminal

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 README

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