x402-video

x402-video MCP サーバー

MCP 対応のエージェント（Claude Code、Claude Desktop、Cursor など）で、AI 動画を生成し、呼び出しごとに支払うことができます。支払いには、x402 プロトコルを通じて Base 上の USDC を使用します。アカウント、API キー、クレジットカードは不要です。

quote_price → generate_video (pays exact USDC quote, gasless) → get_job → video_url

x402video.com が提供しています。5 秒の 720p クリップは約 $0.45、4～15 秒のカスタム動画は音声の有無を選択でき、最大 1080p で $0.13～$4.62 です。プロンプトは支払い前に審査されるため、リクエストが拒否されても請求されません。

ツール

ツール	費用	内容
list_skus	無料	リアルタイムのカタログと現在の USD 価格
get_stats	無料	公開されている信頼性統計（成功率、p50 生成時間）
quote_price	無料	支払いなしで、リクエストの正確な USDC 見積もりを取得
generate_video	有料	見積もり → 支出上限チェック → 支払い → job_id
get_job	無料	ステータスを確認。成功時に video_url（24 時間有効なリンク）を返します
submit_feedback	無料	価格／不足している機能／品質／バグ／より安価な提供元について、開発者に伝えます

セットアップ

Base（8453）上に少額の USDC を入れた、専用の支払い用ウォレットが必要です。 メインのウォレットは絶対に使用しないでください。5 分で完了する 導入ガイドをご覧ください。

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

BUYER_PRIVATE_KEY が設定されていなくても、無料のツール（カタログ、見積もり、ジョブのポーリング、フィードバック）は引き続き利用できます。 ウォレットが必要なのは generate_video のみです。

フィードバック（無料）

エージェントは、支払いなしで製品に関する要望を送信できます。

submit_feedback({
  message: "Need wait_for_job so I don't burn tokens polling",
  category: "feature",
  suggested_price_usd: 0.5
})

カテゴリ：pricing | feature | quality | bug | source | other。 生の HTTP リクエストからも送信できます：POST https://api.x402video.com/feedback。

環境変数

変数	デフォルト
BUYER_PRIVATE_KEY	—	支払い用ウォレットのキー（Base 上の USDC）。generate_video の場合のみ必須です。
MAX_USD_PER_CALL	5	支出上限。これを超える見積もりの場合、generate_video は拒否します。
GATEWAY_URL	https://api.x402video.com	別のゲートウェイインスタンスを指定します。

支払いの仕組み

1. ツールがリクエストを未払いの状態で POST し、ゲートウェイがそのリクエストの正確な USDC 額を HTTP 402 で返します（無料の見積もり）。
2. 見積もりが MAX_USD_PER_CALL 以内の場合、x402 支払いヘッダー（EIP-3009 の署名）を付けてリクエストを再送します。これにより、購入者にガス代はかかりません。
3. job_id が返されます。生成には約 2 分（p50）かかります。get_job をポーリングし、24 時間以内に video_url から動画をダウンロードしてください。

開発

npm install
npm run build
BUYER_PRIVATE_KEY=0x... node dist/index.js   # speaks MCP over stdio

コンテンツポリシー

厳格に禁止されるコンテンツ（支払い前に拒否され、請求されません）：未成年者が関わるコンテンツ、実在人物の肖像を使ったコンテンツ／ディープフェイク。性的に露骨なコンテンツおよび生々しい暴力表現も拒否されます。

---

MIT。独立したゲートウェイであり、モデル提供元とは提携も推奨も受けていません。