MCP and Agent Skills

Give your agent image and video

Already running Claude Code or Codex on WanAPIs? The same key generates images and video — no second account, no second bill. Seedance, Veo, Kling, Midjourney, Seedream and Nano Banana included.

Option 1

MCP Server

For clients that speak MCP. Adds five tools: generate image, generate video, check task, estimate cost, list models.

claude mcp add wanapis \
  --env WANAPIS_API_KEY=sk-xxx \
  -- npx -y @wanapis/mcp

npm Source

Option 2

Agent Skill

Nothing to install. Unzip into your agent's skills directory — it calls the HTTP API directly, with no dependencies. For agents without MCP support, or when you would rather not run a second process.

Download wanapis-media.zip

SKILL.md · scripts/wanapis.mjs · reference/models.md

Option 3

Codex plugin

For the Codex desktop app and CLI. It shows up as a proper entry in the plugin list, toggleable, with no config file to hand-edit.

codex plugin marketplace add ZXYZZP/wanapis-mcp
codex plugin add wanapis-media@wanapis

In the desktop app: Settings → Integrations → Plugins.

Client setup

Claude Code

One line, then restart.

claude mcp add wanapis \
  --env WANAPIS_API_KEY=sk-xxx \
  -- npx -y @wanapis/mcp

Codex

Codex uses TOML, not JSON. This writes it into ~/.codex/config.toml for you.

codex mcp add wanapis \
  --env WANAPIS_API_KEY=sk-xxx \
  -- npx -y @wanapis/mcp

Cursor / Windsurf

Add to the MCP config file.

{
  "mcpServers": {
    "wanapis": {
      "command": "npx",
      "args": ["-y", "@wanapis/mcp"],
      "env": { "WANAPIS_API_KEY": "sk-xxx" }
    }
  }
}

Skill (any agent with Skills support)

Unzip into your skills directory and set the API key. Claude Code reads .claude/skills/.

unzip wanapis-media.zip -d .claude/skills/
export WANAPIS_API_KEY=sk-xxx

node .claude/skills/wanapis-media/scripts/wanapis.mjs \
  video "a paper plane over a city at dusk" \
  --model seedance-2.0-mini --quality low --seconds 5 --out clip.mp4

Know the cost before you generate

A single clip ranges from cents to several dollars. Estimates read the same pricing feed the gateway bills from, so the number you see is the number you pay.

seedance-2.0-mini   480p × 5s   →   0.6975
kling-v2-6          720p × 5s   →   1.6745
gpt-image-2         1K          →   0.1200

Models covered

Video

seedance-2.5 · seedance-2.0 · seedance-2.0-fast · seedance-2.0-mini · veo3.1-quality · veo3.1-fast · veo3.1-lite · kling-v3 · kling-v2-6 · viduq3 · happyhorse-1.0 · grok-video

Image

gpt-image-2 · gpt-image-2-official · seedream-5-0-pro · seedream-5-0-lite · seedream-4-5 · nano-banana-pro · nano-banana-2 · midjourney

Every family names its parameters differently — Seedance uses resolution, Kling uses mode, Midjourney puts it in the prompt. You say low/medium/high; the translation is handled for you.

You will need an API key

Get an API key Read the docs