English Français العربية

io.imaginevid/imaginevid-ai-generation

Official registry Media and design

OAuth-protected ImagineVid MCP for image, video, and music generation.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http imaginevid-ai-generation 'https://imaginevid.io/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "imaginevid-ai-generation": {
            "type": "http",
            "url": "https://imaginevid.io/api/mcp"
        }
    }
}
NPM package imaginevid-mcp
Claude Code 
claude mcp add imaginevid-ai-generation -e 'IMAGINEVID_API_KEY=<your imaginevid_api_key>' -e 'IMAGINEVID_BASE_URL=https://imaginevid.io' -- npx -y imaginevid-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "imaginevid-ai-generation": {
            "command": "npx",
            "args": [
                "-y",
                "imaginevid-mcp@0.1.0"
            ],
            "env": {
                "IMAGINEVID_API_KEY": "<your imaginevid_api_key>",
                "IMAGINEVID_BASE_URL": "https://imaginevid.io"
            }
        }
    }
}

Environment variables

  • IMAGINEVID_API_KEY required secret ImagineVid API key used by the local adapter.
  • IMAGINEVID_BASE_URL Optional ImagineVid API base URL.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ImagineVid Agent Tools AI
  2. Choose a connection
  3. Development
  4. Security and license

ImagineVid Agent Tools AI

Open-source distribution packages for ImagineVid, an AI generation platform for images, videos, and music. This repository contains the typed REST client, a CLI, and a local stdio MCP adapter. The hosted MCP server remains the source of truth for identity, OAuth consent, scopes, credits, quotes, idempotency, owned assets, and provider lifecycle.

Choose a connection

Hosted MCP

Use the OAuth-protected Streamable HTTP endpoint when your host supports remote MCP servers:

{
  "mcpServers": {
    "imaginevid": {
      "url": "https://imaginevid.io/api/mcp"
    }
  }
}

The host handles OAuth and explicit consent. The endpoint exposes models_list, credits_get, generation_quote, generation_create, and generation_get. See the ImagineVid website for the product and account flow.

Local stdio MCP

After the npm package is released, configure a local host with:

{
  "mcpServers": {
    "imaginevid": {
      "command": "npx",
      "args": ["-y", "imaginevid-mcp"],
      "env": {
        "IMAGINEVID_API_KEY": "${IMAGINEVID_API_KEY}",
        "IMAGINEVID_BASE_URL": "https://imaginevid.io"
      }
    }
  }
}

The local adapter uses a scoped API key, never prints it, and never retries an ambiguous submission_unknown result. It accepts product capability values and owned asset IDs, not provider parameters, arbitrary remote URLs, or inline base64 media.

CLI

After the npm package is released:

npm install --global imaginevid-cli
export IMAGINEVID_API_KEY="..."
imaginevid models list
imaginevid credits

The CLI also supports assets upload, generate, generations get, and generations wait. generate quotes first and requires an exact explicit credit confirmation plus a stable idempotency key.

Development

pnpm install
pnpm test
pnpm build

The public package metadata and release files live in:

For product documentation, generation tools, and account access, visit the ImagineVid website. Source issues belong in this GitHub repository.

Security and license

Do not commit API keys or account configuration. The hosted endpoint uses OAuth; the local adapters read credentials from the environment or an owner-only local config file. Report package or security issues through the ImagineVid support page.

The public distribution code is available under MIT-0.

Frequently asked questions

What is io.imaginevid/imaginevid-ai-generation?

OAuth-protected ImagineVid MCP for image, video, and music generation.

How do I install io.imaginevid/imaginevid-ai-generation?

It runs as a remote server. In Claude Code: claude mcp add --transport http imaginevid-ai-generation 'https://imaginevid.io/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.imaginevid/imaginevid-ai-generation need an API key?

Yes. It expects IMAGINEVID_API_KEY, which you set in its configuration.

Is io.imaginevid/imaginevid-ai-generation open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.imaginevid/imaginevid-ai-generation?

It is published by imagineVid. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.