1. Conduid
  2. Blockchain
  3. x402-mcp-server
MCP server · Blockchain

x402-mcp-server

MCP server wrapping x402 DeFi data endpoints — AI agent discovery layer

Unclaimed last commit 6 months ago blockchain
37Low

Scored 12 days ago · breakdown

About x402-mcp-server

x402-mcp-server is an MCP server published by AiAgentKarl in the Blockchain category: mCP server wrapping x402 DeFi data endpoints — AI agent discovery layer.

Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

uvx
uvx x402-mcp-server
pip
pip install x402-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (6)

create_payment_requestCreate a 402 payment request for a tool

Parameters not published.

get_payment_statusCheck payment status

Parameters not published.

get_price_listView all tool prices

Parameters not published.

get_revenueRevenue statistics

Parameters not published.

list_paymentsPayment history

Parameters not published.

verify_paymentVerify on-chain USDC payment

Parameters not published.

Ask AI

✦

Ask AI about x402-mcp-server

Powered by Claude · Grounded in docs

I know everything about x402-mcp-server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

x402 Payment Gateway MCP Server 💰

MCP Server that enables micropayments between AI agents using USDC on Solana. Based on the x402 protocol (HTTP 402 Payment Required).

What is x402?

x402 is a protocol that lets AI agents pay for services automatically. When an agent calls a premium tool, it gets a "402 Payment Required" response with payment instructions. The agent pays via blockchain, then gets access.

Features

  • Payment Requests — Create x402-compatible payment requests for any tool
  • On-Chain Verification — Verify USDC payments directly on Solana
  • Tool Pricing — Set per-call prices for individual tools
  • Revenue Tracking — Dashboard with total revenue, per-tool breakdown
  • Payment History — Full audit trail of all transactions

Installation

pip install x402-mcp-server

Configuration

Set your merchant wallet in .env:

MERCHANT_WALLET=YourSolanaWalletAddress
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

Usage with Claude Code

{
  "mcpServers": {
    "x402": {
      "command": "uvx",
      "args": ["x402-mcp-server"],
      "env": {
        "MERCHANT_WALLET": "YourSolanaWalletAddress"
      }
    }
  }
}

Tools

Tool Description
create_payment_request Create a 402 payment request for a tool
verify_payment Verify on-chain USDC payment
get_payment_status Check payment status
set_tool_price Set price for a tool
get_price_list View all tool prices
list_payments Payment history
get_revenue Revenue statistics

Flow

Agent A                    x402 Gateway                 Agent B (Service)
   |                           |                             |
   |-- "Use premium tool" ---->|                             |
   |                           |-- 402 Payment Required ---->|
   |<-- Payment instructions --|                             |
   |                           |                             |
   |-- USDC payment on-chain ->|                             |
   |                           |-- verify_payment ---------->|
   |                           |<-- verified ----------------|
   |<-- Access granted --------|                             |

More MCP Servers by AiAgentKarl

Category Servers
🔗 Blockchain Solana
🌍 Data Weather · Germany · Agriculture · Space · Aviation · EU Companies
🔒 Security Cybersecurity · Policy Gateway · Audit Trail
🤖 Agent Infra Memory · Directory · Hub · Reputation
🔬 Research Academic · LLM Benchmark · Legal

→ Full catalog (40+ servers)

License

MIT

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About x402-mcp-server

How do I install x402-mcp-server?

Run uvx x402-mcp-server, then add the server to your MCP client's configuration.

Is x402-mcp-server safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is x402-mcp-server still maintained?

The last commit was 6 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.