imaginevid-ai-generation — Claude Code MCP server: install
Connects ImagineVid to an AI coding host for image, video, and music generation. Use its hosted OAuth endpoint or a local adapter.
claude mcp add --transport http imaginevid-ai-generation https://imaginevid.io/api/mcpWhat imaginevid-ai-generation does
This MCP server links ImagineVid with an agent through a hosted HTTP endpoint or a local stdio adapter. Its tools cover model discovery, credit checks, generation quotes, creation requests, and status lookups. The service handles image, video, and music generation.
The local option runs with npx -y imaginevid-mcp and reads IMAGINEVID_API_KEY plus IMAGINEVID_BASE_URL. A scoped API key is required for that setup. Generation is quoted before creation, then the request needs an exact credit confirmation and a stable idempotency key. Inputs are product capability values and owned asset IDs; arbitrary remote URLs and inline base64 media are rejected.
What it helps with
- list available ImagineVid models
- check the account's credit balance
- get a generation cost quote
- start a generation after credit approval
- retrieve a generation status
Example prompts for the agent
- List the available ImagineVid models.
- Check how many credits are available for this account.
- Quote a video generation and create it only after I confirm the exact credit amount.
How to install imaginevid-ai-generation
1Platform CLI: remote server
claude mcp add --transport http imaginevid-ai-generation https://imaginevid.io/api/mcp2Platform CLI
claude mcp add --env IMAGINEVID_API_KEY=<IMAGINEVID_API_KEY> --env IMAGINEVID_BASE_URL=<IMAGINEVID_BASE_URL> --transport stdio imaginevid-ai-generation -- npx -y imaginevid-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add imaginevid-ai-generation --url https://imaginevid.io/api/mcp2Platform CLI
codex mcp add imaginevid-ai-generation --env IMAGINEVID_API_KEY=<IMAGINEVID_API_KEY> --env IMAGINEVID_BASE_URL=<IMAGINEVID_BASE_URL> -- npx -y imaginevid-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"imaginevid-ai-generation": {
"url": "https://imaginevid.io/api/mcp"
}
}
}{
"mcpServers": {
"imaginevid-ai-generation": {
"command": "npx",
"args": [
"-y",
"imaginevid-mcp"
],
"env": {
"IMAGINEVID_API_KEY": "<IMAGINEVID_API_KEY>",
"IMAGINEVID_BASE_URL": "<IMAGINEVID_BASE_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"imaginevid-ai-generation": {
"type": "http",
"url": "https://imaginevid.io/api/mcp"
}
}
}{
"servers": {
"imaginevid-ai-generation": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"imaginevid-mcp"
],
"env": {
"IMAGINEVID_API_KEY": "<IMAGINEVID_API_KEY>",
"IMAGINEVID_BASE_URL": "<IMAGINEVID_BASE_URL>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http imaginevid-ai-generation https://imaginevid.io/api/mcp2Platform CLI
gemini mcp add -e IMAGINEVID_API_KEY=<IMAGINEVID_API_KEY> -e IMAGINEVID_BASE_URL=<IMAGINEVID_BASE_URL> imaginevid-ai-generation npx -y imaginevid-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about imaginevid-ai-generation
How do I install imaginevid-ai-generation in Claude Code?
Add the hosted MCP server with claude mcp add --transport http imaginevid-ai-generation https://imaginevid.io/api/mcp.
What does imaginevid-ai-generation do?
It connects Claude Code to ImagineVid and exposes tools for models, credits, generation requests, and status checks across image, video, and music workflows.
What is required for the local imaginevid-ai-generation setup?
The local adapter uses npx with IMAGINEVID_API_KEY and IMAGINEVID_BASE_URL. It accepts owned asset IDs, while arbitrary remote URLs and inline base64 media are not supported.
