x402-mcp-server

Provides an MCP server that implements an x402-style micropayment gateway for AI agents. It exposes MCP tools to create payment requests, verify USDC payments on Solana, query payment status/history, set per-tool pricing, and fetch revenue statistics.

Evaluated Apr 04, 2026 (40d ago)
Homepage ↗ Repo ↗ Payments mcp ai-agents payments micropayments solana usdc x402
⚙ Agent Friendliness
44
/ 100
Can an agent use this?
🔒 Security
43
/ 100
Is it safe for agents?
⚡ Reliability
18
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
55
Documentation
45
Error Messages
0
Auth Simplicity
85
Rate Limits
10

🔒 Security

TLS Enforcement
70
Auth Strength
25
Scope Granularity
10
Dep. Hygiene
45
Secret Handling
70

The README describes configuration via environment variables (MERCHANT_WALLET, SOLANA_RPC_URL) which is generally safer than hardcoding secrets. However, there is no documented authentication/authorization for who can call the MCP tools, and no mention of protecting merchant keys or handling sensitive data. Dependency hygiene is not verifiable from provided content; only a short dependency list is shown.

⚡ Reliability

Uptime/SLA
0
Version Stability
20
Breaking Changes
30
Error Recovery
20
AF Security Reliability

Best When

You want agent-to-agent paywalling for specific tools using on-chain USDC verification and are comfortable validating correctness/security in your own environment.

Avoid When

You need clearly documented API contracts, guaranteed idempotency, or documented error/retry behavior for financial workflows.

Use Cases

  • Charging other agents for premium tool calls via USDC micropayments on Solana
  • Gating access to paid functionality between autonomous agents
  • Tracking revenue and audit history for tool usage priced per call

Not For

  • General-purpose payment processing for end-user commerce
  • Use cases requiring formal compliance guarantees or enterprise-grade operational guarantees (not evidenced here)
  • Production deployments where robust operational docs (SLA, retries, idempotency semantics) must be proven

Interface

REST API
No
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
No

Authentication

Methods: Environment-based configuration (MERCHANT_WALLET, SOLANA_RPC_URL)
OAuth: No Scopes: No

No user-facing authentication mechanism is described; the server appears configured with a merchant wallet and connects to a Solana RPC endpoint. Authorization/authz for who can invoke tools is not described in the provided README.

Pricing

Free tier: No
Requires CC: No

Project is open-source (MIT per manifest/README). Financial costs are blockchain fees and any USDC transfer costs.

Agent Metadata

Pagination
none
Idempotent
False
Retry Guidance
Not documented

Known Gotchas

  • No idempotency/retry guidance documented for payment creation/verification—agents may duplicate requests if they retry aggressively.
  • No explicit tool input/output schema or error code semantics provided in the README excerpt, making robust agent handling harder.
  • On-chain verification requires correct USDC/memo/payment parameters; incorrect setup could lead to false negatives/positives (not documented).

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for x402-mcp-server.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-04-04.

8642
Packages Evaluated
17761
Need Evaluation
586
Need Re-evaluation
Community Powered