Skip to main content
Glama
x402-video MCP server

x402-video MCP server

Official
by x402-video

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

Tool

Cost

What

list_skus

free

Live catalog + current USD prices

get_stats

free

Public reliability stats (success rate, p50 generation time)

quote_price

free

Exact USDC quote for a request, without paying

generate_video

paid

Quote → spend-guard check → pay → job_id

get_job

free

Poll status; returns video_url on success (24h link)

submit_feedback

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

Var

Default

BUYER_PRIVATE_KEY

—

Spending wallet key (USDC on Base). Required only for generate_video.

MAX_USD_PER_CALL

5

Hard spend guard — generate_video refuses quotes above this. Raise MAX_USD_PER_CALL for long 1080p Standard jobs (up to $9.82).

GATEWAY_URL

https://api.x402video.com

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

Available Tools

6 tools
generate_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

    A4.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    Related MCP Servers