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

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

Local
x402video.comMedia & Design0Updated 12w ago
RepositoryVisit website

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

x402 Video is an MCP server that lets agents request AI-generated videos and pay per call in USDC on Base. It offers free pricing and job-status tools, while video generation requires a spending wallet and applies a per-call spending limit.

Key features

  1. 01View video catalog and prices
  2. 02Get an exact USDC quote before payment
  3. 03Generate videos through paid requests
  4. 04Check job status and retrieve video URLs
  5. 05Set a per-call spending guard
  6. 06Submit feedback without payment

Use cases

  1. 01Check current video options and prices
  2. 02Estimate the cost of a video request
  3. 03Generate a video from an agent workflow
  4. 04Poll a generation job and retrieve its video

MCP support

Exposes tools to MCP clients for catalog and price queries, video generation, job polling, and feedback. `generate_video` uses x402 payment in USDC on Base; the other listed tools are free.

#video-generation#text-to-video#ai-video#seedance#x402#usdc#base#pay-per-call#agent-payments#no-api-key#micropayments

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "x402-video-seedance-video-generation": {
      "command": "npx",
      "args": [
        "-y",
        "x402-video-mcp"
      ],
      "env": {
        "BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>",
        "MAX_USD_PER_CALL": "<MAX_USD_PER_CALL>",
        "GATEWAY_URL": "<GATEWAY_URL>"
      }
    }
  }
}
Run commandnpx -y x402-video-mcp
Environment variables to set
BUYER_PRIVATE_KEYSecretSpending wallet private key (USDC on Base). Only required for the paid generate_video tool; quotes and polling work without it.
MAX_USD_PER_CALLHard spend guard in USD — generate_video refuses quotes above this (default 5).
GATEWAY_URLAlternate gateway instance (default https://api.x402video.com).

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmx402-video-mcp0.1.3

Tools

5

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.