English Français العربية

x402 Video — AI Video Generation (pay-per-call, no account)

Official registry Media and design

Pay-per-call AI video generation (Seedance text-to-video) via x402. USDC on Base, no API key.

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).

NPM package x402-video-mcp
Claude Code 
claude mcp add x402-video-ai-video-generation-pay-per-c -e 'BUYER_PRIVATE_KEY=<your buyer_private_key>' -e 'MAX_USD_PER_CALL=<MAX_USD_PER_CALL>' -e 'GATEWAY_URL=<GATEWAY_URL>' -- npx -y x402-video-mcp@0.1.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "x402-video-ai-video-generation-pay-per-c": {
            "command": "npx",
            "args": [
                "-y",
                "x402-video-mcp@0.1.3"
            ],
            "env": {
                "BUYER_PRIVATE_KEY": "<your buyer_private_key>",
                "MAX_USD_PER_CALL": "<MAX_USD_PER_CALL>",
                "GATEWAY_URL": "<GATEWAY_URL>"
            }
        }
    }
}

Environment variables

  • BUYER_PRIVATE_KEY secret Spending wallet private key (USDC on Base). Only required for the paid generate_video tool; quotes and polling work without it.
  • MAX_USD_PER_CALL Hard spend guard in USD — generate_video refuses quotes above this (default 5).
  • GATEWAY_URL Alternate gateway instance (default https://api.x402video.com).

Documentation

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

Contents
  1. x402-video MCP server
  2. Tools
  3. Setup
  4. Environment variables
  5. How payment works
  6. Develop
  7. Content policy

x402-video MCP server

Give any MCP-capable agent (Claude Code, Claude Desktop, Cursor, ...) the ability to generate AI videos and pay per call — USDC on Base over the x402 protocol. No accounts, no API keys, no credit cards.

quote_price → generate_video (pays exact USDC quote, gasless) → get_job → video_url

Backed by x402video.com: ~$0.45 for a 5s 720p clip, custom 4–15s up to 1080p with optional audio ($0.13–$4.62). Prompts are screened before payment — rejected requests are never charged.

Tools

ToolCostWhat
list_skusfreeLive catalog + current USD prices
get_statsfreePublic reliability stats (success rate, p50 generation time)
quote_pricefreeExact USDC quote for a request, without paying
generate_videopaidQuote → spend-guard check → pay → job_id
get_jobfreePoll status; returns video_url on success (24h link)
submit_feedbackfreeTell humans: price / missing feature / quality / bug / cheaper source

Setup

You need a dedicated spending wallet with a few USDC on Base (8453). Never use your main wallet — see the 5-minute getting-started guide.

Claude Code
claude mcp add x402-video \
  --env BUYER_PRIVATE_KEY=0xYOUR_SPENDING_WALLET_KEY \
  -- npx -y x402-video-mcp
Claude Desktop / Cursor (JSON)
{
  "mcpServers": {
    "x402-video": {
      "command": "npx",
      "args": ["-y", "x402-video-mcp"],
      "env": {
        "BUYER_PRIVATE_KEY": "0xYOUR_SPENDING_WALLET_KEY"
      }
    }
  }
}

Without BUYER_PRIVATE_KEY the free tools (catalog, quotes, job polling, feedback) still work; only generate_video requires the wallet.

Feedback (free)

Agents can report product needs without paying:

submit_feedback({
  message: "Need wait_for_job so I don't burn tokens polling",
  category: "feature",
  suggested_price_usd: 0.5
})

Categories: pricing | feature | quality | bug | source | other. Also available as raw HTTP: POST https://api.x402video.com/feedback.

Environment variables

VarDefault
BUYER_PRIVATE_KEY—Spending wallet key (USDC on Base). Required only for generate_video.
MAX_USD_PER_CALL5Hard spend guard — generate_video refuses quotes above this.
GATEWAY_URLhttps://api.x402video.comPoint at another gateway instance.

How payment works

  1. The tool POSTs your request unpaid; the gateway answers HTTP 402 with the exact USDC amount for that request (a free quote).
  2. If the quote is within MAX_USD_PER_CALL, the request is retried with an x402 payment header — an EIP-3009 signature, so the buyer pays no gas.
  3. You get a job_id; generation takes ~2 minutes (p50). Poll get_job, download video_url within 24h.

Develop

npm install
npm run build
BUYER_PRIVATE_KEY=0x... node dist/index.js   # speaks MCP over stdio

Content policy

Hard red lines (rejected pre-payment, never charged): content involving minors, real-person likeness/deepfakes. Sexually explicit content and graphic violence are rejected.

MIT. Independent gateway — not affiliated with or endorsed by model vendors.

Frequently asked questions

What is x402 Video — AI Video Generation (pay-per-call, no account)?

Pay-per-call AI video generation (Seedance text-to-video) via x402. USDC on Base, no API key.

How do I install x402 Video — AI Video Generation (pay-per-call, no account)?

It runs on your machine. In Claude Code: claude mcp add x402-video-ai-video-generation-pay-per-c -e 'BUYER_PRIVATE_KEY=<your buyer_private_key>' -e 'MAX_USD_PER_CALL=<MAX_USD_PER_CALL>' -e 'GATEWAY_URL=<GATEWAY_URL>' -- npx -y x402-video-mcp@0.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does x402 Video — AI Video Generation (pay-per-call, no account) need an API key?

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

Is x402 Video — AI Video Generation (pay-per-call, no account) open source?

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

Who maintains x402 Video — AI Video Generation (pay-per-call, no account)?

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