How do I use x402-Gated MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@x402-Gated MCP Server Generate 10 synthetic user profiles" 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-Gated MCP Server

by arifsakib01

Overview Schema Source Related Servers Discussions Admin

Python

Remote

x402-Gated MCP Server 💰

A Model Context Protocol (MCP) server that charges AI agents per-call via the x402 micropayment protocol (USDC on Base).

Agents pay $0.05 USDC per tool call — no API keys, no subscriptions, just pay-per-use crypto.

How It Works

Agent → POST /mcp/tools/call (no payment)
     ← 402 + pricing payload (how much, where to pay)

Agent → signs USDC tx on Base
     → POST /mcp/tools/call + X-Payment-Signature: 0x...
     ← 200 + tool results ✅

Related MCP server: @hpp-io/x402-mcp-bridge

Quick Start

# Install dependencies
pip install -r requirements.txt

# Configure (copy and edit .env)
cp .env.example .env
# Set PAYMENT_WALLET_ADDRESS=0xYourWallet

# Run server
python server.py

# Test the payment flow (in another terminal)
python client.py

Available Tools

Tool	Description	Price
`generate_synthetic_data`	Generates user profiles, transactions, or IoT sensor data	0.05 USDC
`crypto_market_analytics`	Deep DEX liquidity, 24h volume, and sentiment score on Base network	0.05 USDC
`web_content_extractor`	Clean markdown summaries, key takeaways, and structured JSON from URLs	0.05 USDC

Endpoints

Method	Path	Auth	Description
GET	`/`	None	Health check + payment config
GET	`/mcp/sse`	x402	MCP SSE connection
POST	`/mcp/messages/`	x402	MCP JSON-RPC messages
POST	`/mcp/tools/call`	x402	REST tool invocation

Deploy to Railway

Deploy on Railway

# Or via CLI:
railway login
railway init
railway up
# Set env vars in Railway dashboard:
#   PAYMENT_WALLET_ADDRESS=0x...
#   VERIFY_MODE=onchain

Environment Variables

Variable	Required	Default	Description
`PAYMENT_WALLET_ADDRESS`	Yes	-	Your Base wallet for receiving USDC
`PAYMENT_AMOUNT`	No	`0.05`	Price per call in USDC
`VERIFY_MODE`	No	`mock`	`onchain` for production, `mock` for dev
`BASE_RPC_URL`	No	`https://mainnet.base.org`	Base RPC endpoint
`PORT`	No	`8402`	Server port

Architecture

┌─────────────────────────────────────────────┐
│                FastAPI App                   │
│  ┌───────────────────────────────────────┐  │
│  │    x402 Payment Middleware (ASGI)     │  │
│  │    ┌─────────────────────────────┐    │  │
│  │    │   MCP SSE Transport         │    │  │
│  │    │   └─ /mcp/sse              │    │  │
│  │    │   └─ /mcp/messages/        │    │  │
│  │    │   REST Endpoint             │    │  │
│  │    │   └─ /mcp/tools/call       │    │  │
│  │    └─────────────────────────────┘    │  │
│  └───────────────────────────────────────┘  │
│  Health Check (public)                       │
│  └─ /                                        │
└─────────────────────────────────────────────┘

Tech Stack

FastAPI + uvicorn — ASGI web server
MCP SDK v2 — Model Context Protocol
web3.py — On-chain USDC verification on Base
httpx — Async HTTP client

License

MIT

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

x711 — Universal Agent Gas Station B
io.github.0580iris-lang
Pay-per-use tool API for AI agents. Free tier, x402 USDC micropayments, or API key.
AI & Machine Learning Payments & Billing
472
Agentic Endpoints A
com.oliverkiss
Pay-per-call tools for autonomous agents, settled in USDC on Base via x402.
Autonomous Agents Payments & Billing Blockchain
181
quartermaster B
app.surewhynot.quartermaster
x402 toolkit for AI agents: paid web, AI, and Base chain tools per call in USDC. Free tools too.
Autonomous Agents Blockchain
492
Vibe Springs A
net.vibesprings
Pay-per-use weather, environment, finance, and on-chain intelligence tools for AI agents via x402.
Weather Services Finance Blockchain
252

Related MCP Servers

navi-x402-mcp
Cryptocurrency Weather Services Language Translation
mobileappbyharis
A
license
A
quality
F
maintenance
Enables AI agents to access paid tools like crypto prices, weather, translation, and web intelligence via per-request USDC payments on Base, with no API keys or subscriptions.
Updated 3 months ago (2026-06-11 10:07 UTC)
15
27
MIT
@hpp-io/x402-mcp-bridgeofficial
Cryptocurrency Autonomous Agents Payments & Billing
hpp-io
A
license
Not graded
quality
B
maintenance
Enables AI agents to autonomously pay for and discover services using HPP USDC.e over the x402 protocol, without API keys or manual signing.
Updated 23 days ago (2026-08-20 01:23 UTC)
88
Apache 2.0
x402tools MCP Server
acrylicfiddle
A
license
A
quality
C
maintenance
Provides AI agents with 10 pay-per-call utility tools (QR generation, DNS lookup, OCR, etc.) using USDC on Base via the x402 protocol, with agent's private key never leaving the agent.
Updated a month ago (2026-07-27 16:32 UTC)
11
67
MIT
@warppay402/warppay402-mcp
Web Scraping Blockchain
golfgolfgolf200
F
license
Not graded
quality
B
maintenance
Enables AI agents to use pay-per-use web scraping, Base blockchain analytics, and PDF text extraction tools, monetized via x402 USDC micropayments.
Updated 15 days ago (2026-08-28 01:17 UTC)
-