mcpField
X
x402-video

x402-video

Local
github.com/x402-videoMedia & Design0Updated 12w ago
Repository

About x402-video

x402-video lets MCP agents generate AI videos with per-call USDC payments over x402 on Base. It combines price quotes, job tracking, and video links, with content screening before payment.

Key features

  1. 01Browse video options and prices
  2. 02Get exact USDC quotes
  3. 03Generate videos at the quoted price
  4. 04Check job status and video links
  5. 05Submit feedback and view service stats

Use cases

  1. 01Generate AI videos per agent request
  2. 02Check generation costs before paying
  3. 03Track jobs and retrieve finished video links

MCP support

The MCP server exposes tools for video options, quotes, generation, job status, feedback, and service statistics. Video generation requires a USDC wallet on Base; free tools work without one.

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": {
      "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.x402-video.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.1

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.