Clipia MCP
Connect Clipia to Claude Code, claude.ai, ChatGPT, Cursor, VS Code and Windsurf — 50+ image and video models right inside your agent's chat with a single API key.
Clipia MCP is a remote Model Context Protocol server at https://api.clipia.ai/mcp. It gives any MCP client (Claude Code, claude.ai, ChatGPT, Cursor, VS Code, Windsurf and more) a set of tools for generating images and video: the agent picks the model, tracks progress and shows the result right in the conversation. Authentication uses a regular public-API key; usage is billed in credits from your Clipia account.
Endpoint
Server address (Streamable HTTP): https://api.clipia.ai/mcp. Supported auth schemes: Authorization: Bearer clipia_... (recommended), Authorization: Key <key>, X-Api-Key: <key>.
Getting a key
Create an API key in Clipia Settings → "API keys" tab. Keys prefixed clipia_live_ are live (they charge credits); keys prefixed clipia_test_ run in the sandbox: instant mock responses with no charge, handy for debugging agents and CI.
The key is a server-side secret
A live key is shown only once at creation — it is the equivalent of a password to your credit balance. Keep it in an environment variable or a secrets manager, and never commit it to a repository.
Connect a client
Cards in chat
In claude.ai the result is shown as an interactive card with live progress and media. In Claude Code an inline preview lands in the terminal. Other clients return links to the full-quality file.
One command in the terminal and the Clipia tools are available in any session, including headless and CI. Pull the key from an environment variable rather than hard-coding it:
claude mcp add --transport http clipia https://api.clipia.ai/mcp \
--header "Authorization: Bearer $CLIPIA_API_KEY"Then ask Claude: "Generate an image of a neon city in Clipia" — the preview lands right in the terminal.
claude.ai (web, desktop, mobile) connects via sign-in to your Clipia account (OAuth); no key required:
- Open Settings → Connectors.
- Click "Add custom connector" and paste the URL
https://api.clipia.ai/mcp. - Click Connect and sign in to your Clipia account.
- In a new chat, ask for an image or a video — a live Clipia card with progress and an "Original" button appears in the message.
- In ChatGPT (web): Settings → Apps & Connectors → Advanced settings → enable Developer mode (Plus, Pro, Business, Enterprise).
- Apps & Connectors → Create. Name — Clipia, MCP Server URL
https://api.clipia.ai/mcp. - Authentication — OAuth, check "I trust this application" and click Create.
- Sign in to your Clipia account. In a chat, click "+" → More → Clipia and ask for generations in plain text.
Add the server to ~/.cursor/mcp.json (global) or .cursor/mcp.json in the project, then restart Cursor. Substitute the key from an environment variable in place of the placeholder:
{
"mcpServers": {
"clipia": {
"url": "https://api.clipia.ai/mcp",
"headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
}
}
}Create .vscode/mcp.json in your workspace (or via the "MCP: Add Server" command). Open Copilot Chat in Agent mode and the Clipia tools appear in the list:
{
"servers": {
"clipia": {
"type": "http",
"url": "https://api.clipia.ai/mcp",
"headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
}
}
}Add the server to ~/.codeium/windsurf/mcp_config.json (the serverUrl field is a Windsurf quirk), then refresh the server list in Cascade → MCPs:
{
"mcpServers": {
"clipia": {
"serverUrl": "https://api.clipia.ai/mcp",
"headers": { "Authorization": "Bearer ${CLIPIA_API_KEY}" }
}
}
}Sandbox
Keys prefixed clipia_test_ return instant mock results with no charge — perfect for debugging response parsing, polling and pipelines. Live keys return the exact cost of each generation, and the get_balance tool reports the remaining credit balance.
See the full tool reference on the Tools page.