X402 Video

io.github.x402-videoPublished by GitHub account x402-videov0.1.1Updated Oct 24, 2026

Pay-per-call AI video generation over x402 (USDC on Base). No accounts, no API keys.

VerifiedSTDIODesktop onlyFinanceMedia & Design

Overview

AI-generated overview

Local MCP server that lets an assistant generate AI videos and pay per clip in USDC on Base over the x402 protocol, with no account or API key.

What you can do
  • Browse the live video catalog and current USD prices, and read public reliability stats
  • Get an exact USDC quote for a request without paying
  • Generate a video by paying the quote from a spending wallet, returning a job ID
  • Poll job status and retrieve the resulting video link
  • Send free feedback on pricing, missing features, quality or bugs
When to use it
Useful when an assistant should produce short AI video clips on demand and pay per call in crypto instead of holding a vendor account or subscription. Free catalog, quote and polling tools can be tried without a wallet.
Requirements
Runs locally over stdio via npx (Node.js). A dedicated spending wallet with a small USDC balance on Base, supplied as BUYER_PRIVATE_KEY, is needed only for paid generation. Optional settings: MAX_USD_PER_CALL (default 5) and GATEWAY_URL. Network access to the gateway is required.
Before you install
BUYER_PRIVATE_KEY is a wallet private key that the server uses to sign payments; use a dedicated low-balance wallet, never a main one. Generation spends real USDC per call, with prices up to about 9.82 USD for long 1080p clips, so keep MAX_USD_PER_CALL low. Prompts and feedback are sent to a third-party gateway, and video links expire after 24 hours.

Installation

In SourceWeft

  1. Open X402 Video in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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. Seedance 2.0, 5s 720p: Mini $0.67, Fast $1.05, Standard $1.33 per clip. Custom 4–15s with optional audio: Mini $0.26–$2.00 and Fast $0.40–$3.15 (480p/720p), Standard $0.49–$9.82 (up to 1080p). The exact USDC price is always the live 402 quote. 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

bash
claude mcp add x402-video \  --env BUYER_PRIVATE_KEY=0xYOUR_SPENDING_WALLET_KEY \  -- npx -y x402-video-mcp

Claude Desktop / Cursor (JSON)

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. Raise MAX_USD_PER_CALL for long 1080p Standard jobs (up to $9.82).
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

bash
npm installnpm run buildBUYER_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.

Source: README.md at commit 6fb0691

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts