x402-video MCP server
OfficialThis MCP server lets an agent generate AI videos and pay per call in USDC on Base via x402, with free catalog, quote, status, and feedback tools.
List available video SKUs and current USD prices (
list_skus).Fetch gateway reliability stats: success rate, p50 generation time, total delivered (
get_stats).Get an exact USDC quote for a generation request without paying (
quote_price).Generate a video by paying the live x402 quote, subject to
MAX_USD_PER_CALLspend guard; returns ajob_id(generate_video).Poll job status and retrieve a
video_urlvalid for 24h on success (get_job).Submit free product feedback on pricing, missing features, quality, bugs, or cheaper sources (
submit_feedback).Use free tools without a wallet;
generate_videorequiresBUYER_PRIVATE_KEYfor a dedicated USDC spending wallet on Base.Prompts are screened before payment; rejected prompts are never charged.
Allows agents to generate AI videos with payments using USDC on the Base (Ethereum) network via the x402 protocol, providing gasless transactions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@x402-video MCP server generate a 5s 720p video of a dog running"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_urlBacked 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
Tool | Cost | What |
| free | Live catalog + current USD prices |
| free | Public reliability stats (success rate, p50 generation time) |
| free | Exact USDC quote for a request, without paying |
| paid | Quote → spend-guard check → pay → |
| free | Poll status; returns |
| free | Tell humans: price / missing feature / quality / bug / cheaper source |
Related MCP server: @hpp-io/x402-mcp-bridge
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-mcpClaude 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
Var | Default | |
| — | Spending wallet key (USDC on Base). Required only for |
|
| Hard spend guard — |
|
| Point at another gateway instance. |
How payment works
The tool POSTs your request unpaid; the gateway answers
HTTP 402with the exact USDC amount for that request (a free quote).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.You get a
job_id; generation takes ~2 minutes (p50). Pollget_job, downloadvideo_urlwithin 24h.
Develop
npm install
npm run build
BUYER_PRIVATE_KEY=0x... node dist/index.js # speaks MCP over stdioContent 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.
Available Tools
6 toolsgenerate_videoGenerate a video (paid)A
Generate an AI video, paying per call in USDC on Base via x402 (gasless EIP-3009 signature). Quotes the exact price first and refuses if it exceeds MAX_USD_PER_CALL (default $5). Returns a job_id — poll get_job until status is 'succeeded' (typically ~2 minutes). Prompts are screened before payment; rejected prompts are never charged.
Inputs: prompt (required), seed, model, ratio, +4 more.
get_jobCheck job status / get video URLA
Poll a generation job (free call). status: queued/running/succeeded/failed. On success returns video_url (download within 24h).
Inputs: job_id (required).
get_statsGateway reliability statsA
Live public stats: success rate, p50 generation seconds, total delivered (free call).
Inputs: no named parameters.
list_skusList video SKUs and pricesA
Live catalog of pay-per-call video generation endpoints with current USD prices (free call). Fixed-price SKUs (~$0.45-0.56 for 5s 720p) and custom endpoints (4-15s, up to 1080p, optional audio).
Inputs: no named parameters.
quote_priceQuote exact price (no payment)A
Get the exact USDC price for a generation request without paying. Free call — useful before generate_video.
Inputs: prompt (required), seed, model, ratio, +4 more.
submit_feedbackSend product feedback to humans (free)A
Free call, no payment or wallet required. A human reads every note. Use when a price looks wrong, output quality is poor, a model/feature is missing (e.g. wait_for_job, reference images, vertical ratio), you know a cheaper source, or you hit a bug. Prefer this over silently retrying or dropping the task.
Inputs: message (required), sku, source, contact, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a clearly distinct function: catalog browsing, stats, price quoting, video generation, job polling, and feedback submission. There is no meaningful overlap between tools, and generate_video vs get_job is explicitly separated by job_id polling.
All tool names follow a consistent verb_noun snake_case pattern: list_skus, get_stats, quote_price, generate_video, get_job, submit_feedback. The naming is predictable and makes the purpose of each tool immediately understandable.
Six tools is a well-scoped set for a pay-per-call video generation service. Each tool covers a necessary step in the workflow—discover, estimate, generate, poll, retrieve, and provide feedback—without unnecessary redundancy.
The tool surface covers the full lifecycle of paid video generation: catalog discovery, pricing, generation, job status polling, result retrieval, and a feedback path for edge cases. The mention of potentially missing features in submit_feedback is a reasonable workaround rather than a coverage gap.
Related MCP Connectors
AI music, video, image, and voice tools callable by agents with USDC payments via x402 on Base.
Pay-per-call AI and media tools over x402. USDC on Base, no signup, no API key.
Hire Vevang's AI agents, pay-per-call in USDC on Base via x402: video, visibility, verify, extract
Pay-per-call tools for autonomous agents, settled in USDC on Base via x402.
Related MCP Servers
- AlicenseBqualityDmaintenanceConnects AI agents to the Base network for onchain data, batch USDC payments, and access to over 200 AI models. It utilizes the x402 protocol to enable pay-per-request functionality using USDC without requiring traditional API keys or accounts.10054 npm4MIT

@hpp-io/x402-mcp-bridgeofficial
AlicenseNot gradedqualityBmaintenanceEnables AI agents to autonomously pay for and discover services using HPP USDC.e over the x402 protocol, without API keys or manual signing.695 npmApache 2.0- FlicenseNot gradedqualityCmaintenanceEnables AI agents to pay per tool call in USDC via the x402 micropayment protocol, with no API keys or subscriptions required.-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to access 25 pay-per-request intelligence APIs using USDC micropayments via the x402 protocol, without API keys or accounts.-