English Français العربية

io.github.vicseeai/vicsee-mcp-server

Official registry Media and design

Generate, edit and upscale AI video and images from any agent via VicSee.

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 vicsee-mcp-server 'https://mcp.vicsee.com'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vicsee-mcp-server": {
            "type": "http",
            "url": "https://mcp.vicsee.com"
        }
    }
}
NPM package @vicsee/mcp-server
Claude Code 
claude mcp add vicsee-mcp-server -e 'VICSEE_API_KEY=<your vicsee_api_key>' -- npx -y @vicsee/mcp-server@0.3.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "vicsee-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@vicsee/mcp-server@0.3.3"
            ],
            "env": {
                "VICSEE_API_KEY": "<your vicsee_api_key>"
            }
        }
    }
}

Environment variables

  • VICSEE_API_KEY required secret VicSee API key (starts with sk-) from vicsee.com Settings then API. Requires a paid plan or credit pack.

Documentation

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

Contents
  1. VicSee MCP Server
  2. What your agent can do
  3. Setup
  4. Local development
  5. Example agent flow
  6. Notes
  7. License

VicSee MCP Server

Generate, edit, and upscale AI video & images from any agent — VicSee as a set of MCP tools.

Works with Hermes Agent, Claude (Desktop / Code), Cursor, OpenClaw, and any MCP-compatible client.

What your agent can do

ToolWhat it does
vicsee_list_modelsList available models (Seedance, Veo, Kling, FLUX, Nano Banana, …) + their credit costs
vicsee_estimateSame arguments as vicsee_generate; returns the exact credits it will charge and creates nothing
vicsee_generateText/image → video or image with a chosen model
vicsee_get_taskPoll a task and get the finished media URL (result.expires_at — URLs are kept 7 days; download what you want to keep)
vicsee_upscale_imageUpscale an image
vicsee_upscale_videoUpscale a video
vicsee_get_creditsCheck your credit balance

Generation is asynchronous: vicsee_generate (or vicsee_upscale_*) returns a task id immediately — your agent then polls vicsee_get_task until status is completed and reads the URL from result.url.

Setup

  1. Get an API key at vicsee.com → Settings → API (starts with sk-). API access requires a paid plan or credit pack.
  2. Add the server to your MCP client config with that key:
{
  "mcpServers": {
    "vicsee": {
      "command": "npx",
      "args": ["-y", "@vicsee/mcp-server"],
      "env": { "VICSEE_API_KEY": "sk-your-key-here" }
    }
  }
}

That's the whole setup — drop in your key, and your agent can generate.

Client config locations
  • Claude Desktop: claude_desktop_config.json → mcpServers
  • Cursor: Settings → MCP → add server (same command/args/env)
  • Hermes Agent / OpenClaw: add to the MCP servers section of your agent config
  • Claude Code: claude mcp add vicsee -e VICSEE_API_KEY=sk-... -- npx -y @vicsee/mcp-server
Optional env
  • VICSEE_BASE_URL — override the API base URL (defaults to https://vicsee.com/api/v1).

Local development

pnpm install
pnpm build
VICSEE_API_KEY=sk-... node dist/index.js   # stdio server
# or run from source: VICSEE_API_KEY=sk-... pnpm dev

Point your MCP client at the local build by using "command": "node", "args": ["/abs/path/to/dist/index.js"].

Example agent flow

"Make me a 5-second video of a kitten chasing a laser."

  1. vicsee_list_models (type: video) → pick e.g. seedance-2-5-text-to-video (up to 30s) or seedance-2-0-text-to-video (adds 1080p/4K)
  2. vicsee_generate (model, prompt, duration: 5) → { id, status: "pending" }
  3. vicsee_get_task (id) … poll … → { status: "completed", result: { url: "https://cdn.vicsee.com/…" } }

Notes

  • Result URLs are served from cdn.vicsee.com — stable VicSee CDN links.
  • Each generation costs credits; see vicsee_list_models for per-model costs and vicsee_get_credits for your balance.

License

MIT

Frequently asked questions

What is io.github.vicseeai/vicsee-mcp-server?

Generate, edit and upscale AI video and images from any agent via VicSee.

How do I install io.github.vicseeai/vicsee-mcp-server?

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

Does io.github.vicseeai/vicsee-mcp-server need an API key?

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

Is io.github.vicseeai/vicsee-mcp-server open source?

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

Who maintains io.github.vicseeai/vicsee-mcp-server?

It is published by vicseeai. 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.