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:

• `imaginevid-client`, the typed Agent REST v1 client.
• `imaginevid-cli`, the command-line adapter.
• `imaginevid-mcp`, the local stdio MCP adapter.
• `server.json`, the hosted MCP Registry metadata.

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.