How do I install Mcp?

Mcp is a local plugin. Install it using npm package: x402-video-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Mcp need?

Mcp requires the following credentials or environment variables: BUYER_PRIVATE_KEY, MAX_USD_PER_CALL, GATEWAY_URL. You can find setup instructions on the server detail page.

What AI apps work with Mcp?

Mcp uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Mcp MCP Server

by X402 Video

Developer ToolsLow Risk10.0MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0

Low Risk10.0Low Risk

Valid MCP server (2 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Spending wallet private key (USDC on Base). Only required for the paid generate_video tool; quotes and polling work without it.Required

Environment variable: BUYER_PRIVATE_KEY

Hard spend guard in USD — generate_video refuses quotes above this (default 5).Optional

Environment variable: MAX_USD_PER_CALL

Alternate gateway instance (default https://api.x402-video.com).Optional

Environment variable: GATEWAY_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-x402-video-mcp": {
      "env": {
        "GATEWAY_URL": "your-gateway-url-here",
        "MAX_USD_PER_CALL": "your-max-usd-per-call-here",
        "BUYER_PRIVATE_KEY": "your-buyer-private-key-here"
      },
      "args": [
        "-y",
        "x402-video-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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 x402-video.com: ~$0.45 for a 5s 720p clip, custom 4–15s up to 1080p with optional audio ($0.13–$4.62). 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)

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) still work; only generate_video requires the wallet.

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.
`GATEWAY_URL`	`https://api.x402-video.com`	Point at another gateway instance.

How payment works

The tool POSTs your request unpaid; the gateway answers HTTP 402 with 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). 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.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Mcp MCP Server

About

Security Report

Findings (1)

Permissions Required

What You'll Need

How to Install

Documentation

x402-video MCP server

Tools

Setup

Claude Code

Claude Desktop / Cursor (JSON)

Environment variables

How payment works

Develop

Content policy

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MarkItDown

FinAgent