{
  "markdown": "# x402-video MCP server\n\nGive any MCP-capable agent (Claude Code, Claude Desktop, Cursor, ...) the ability to\n**generate AI videos and pay per call** — USDC on Base over the\n[x402 protocol](https://docs.x402.org). No accounts, no API keys, no credit cards.\n\n```\nquote_price → generate_video (pays exact USDC quote, gasless) → get_job → video_url\n```\n\nBacked by [x402video.com](https://x402video.com): ~$0.45 for a 5s 720p clip,\ncustom 4–15s up to 1080p with optional audio ($0.13–$4.62). Prompts are screened\n**before** payment — rejected requests are never charged.\n\n## Tools\n\n| Tool | Cost | What |\n|---|---|---|\n| `list_skus` | free | Live catalog + current USD prices |\n| `get_stats` | free | Public reliability stats (success rate, p50 generation time) |\n| `quote_price` | free | Exact USDC quote for a request, without paying |\n| `generate_video` | paid | Quote → spend-guard check → pay → `job_id` |\n| `get_job` | free | Poll status; returns `video_url` on success (24h link) |\n| `submit_feedback` | free | Tell humans: price / missing feature / quality / bug / cheaper source |\n\n## Setup\n\nYou need a **dedicated spending wallet** with a few USDC on Base (8453).\nNever use your main wallet — see the 5-minute\n[getting-started guide](https://github.com/x402-video/web/blob/main/GETTING-STARTED.md).\n\n### Claude Code\n\n```bash\nclaude mcp add x402-video \\\n  --env BUYER_PRIVATE_KEY=0xYOUR_SPENDING_WALLET_KEY \\\n  -- npx -y x402-video-mcp\n```\n\n### Claude Desktop / Cursor (JSON)\n\n```json\n{\n  \"mcpServers\": {\n    \"x402-video\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"x402-video-mcp\"],\n      \"env\": {\n        \"BUYER_PRIVATE_KEY\": \"0xYOUR_SPENDING_WALLET_KEY\"\n      }\n    }\n  }\n}\n```\n\nWithout `BUYER_PRIVATE_KEY` the free tools (catalog, quotes, job polling, feedback) still work;\nonly `generate_video` requires the wallet.\n\n### Feedback (free)\n\nAgents can report product needs without paying:\n\n```\nsubmit_feedback({\n  message: \"Need wait_for_job so I don't burn tokens polling\",\n  category: \"feature\",\n  suggested_price_usd: 0.5\n})\n```\n\nCategories: `pricing` | `feature` | `quality` | `bug` | `source` | `other`.\nAlso available as raw HTTP: `POST https://api.x402video.com/feedback`.\n\n## Environment variables\n\n| Var | Default | |\n|---|---|---|\n| `BUYER_PRIVATE_KEY` | — | Spending wallet key (USDC on Base). Required only for `generate_video`. |\n| `MAX_USD_PER_CALL` | `5` | Hard spend guard — `generate_video` refuses quotes above this. |\n| `GATEWAY_URL` | `https://api.x402video.com` | Point at another gateway instance. |\n\n## How payment works\n\n1. The tool POSTs your request unpaid; the gateway answers `HTTP 402` with the **exact**\n   USDC amount for that request (a free quote).\n2. If the quote is within `MAX_USD_PER_CALL`, the request is retried with an x402\n   payment header — an [EIP-3009](https://eips.ethereum.org/EIPS/eip-3009) signature,\n   so the buyer pays **no gas**.\n3. You get a `job_id`; generation takes ~2 minutes (p50). Poll `get_job`, download\n   `video_url` within 24h.\n\n## Develop\n\n```bash\nnpm install\nnpm run build\nBUYER_PRIVATE_KEY=0x... node dist/index.js   # speaks MCP over stdio\n```\n\n## Content policy\n\nHard red lines (rejected pre-payment, never charged): content involving minors,\nreal-person likeness/deepfakes. Sexually explicit content and graphic violence are\nrejected.\n\n---\n\nMIT. Independent gateway — not affiliated with or endorsed by model vendors.\n",
  "bytes": 3401,
  "sha": "89ae1e0bdd84a8a8e84facc84dfc10e648859303a86eab5ff3c6d53cc0223fad",
  "repo_slug": "x402-video/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_x402_video_seedance_video_gene_af879950/readme"
}