X402engine MCP server
io.github.agentc22/x402engine-mcp·v1.0.3·1 stars50+ pay-per-call APIs for AI agents — images, LLM, code, crypto, travel & more via x402
1 stars66 downloads/wk
Reviews
Write oneNobody has reviewed X402engine yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
X402engine tools (20, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
discover_servicesList all available x402 Engine APIs with pricing, endpoints, and payment networks. Call this first to understand what's available.
execute_codewrite actionExecute code in a secure sandboxed environment (E2B). Supports Python, JavaScript, Bash, and R. $0.005 per execution.
generate_imageGenerate an image from a text prompt. Three quality tiers: 'fast' ($0.015, FLUX Schnell), 'quality' ($0.05, FLUX.2 Pro), 'text' ($0.12, Ideogram v3 for images with text). Returns image URL.
get_crypto_historyGet historical price data for a cryptocurrency. $0.003 per request.
get_crypto_marketsGet top cryptocurrencies by market cap with detailed market data. $0.002 per request.
get_crypto_priceGet current prices for cryptocurrencies. $0.001 per request.
get_from_ipfsRetrieve content from IPFS by CID. $0.001 per request.
get_token_metadataGet metadata for a token (name, symbol, decimals, etc.). $0.002 per request.
get_token_pricesGet DEX-derived prices for tokens by contract address. $0.005 per request.
get_trending_cryptoGet trending cryptocurrencies. $0.001 per request.
get_wallet_balancesGet token balances for a wallet address on any supported chain. $0.005 per request.
get_wallet_pnlGet profit and loss analysis for a wallet's token trades. $0.01 per request.
get_wallet_transactionsGet transaction history for a wallet address. $0.005 per request.
pin_to_ipfsPin JSON data to IPFS via Pinata. Returns the IPFS CID. $0.01 per pin.
search_cheapest_datesFind the cheapest travel dates for a route. Returns date/price pairs sorted by price. $0.01 per request.
search_cryptoSearch for a cryptocurrency by name or symbol. $0.001 per request.
search_flightsSearch flight offers by route, dates, and passengers. Returns pricing, itineraries, and airlines. $0.01 per request.
search_hotelsSearch hotel offers by city and dates. Returns room details, pricing, and availability. $0.01 per request.
search_locationsSearch for airports and cities by keyword. Returns IATA codes, names, and coordinates. $0.005 per request.
transcribe_audioTranscribe audio to text using Deepgram Nova-3. Accepts a public URL to an audio file. $0.10 per transcription.
Public scan report
scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it
- Code scan4 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 65 days ago12/15
- Maintainer identityregistry namespace matches repository owner6/10
How X402engine compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 75/100
- higher than 50% of 1,761 Finance servers
- Tools
- 20
- the typical Finance server has 8
- Tools that change things
- 5%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 1
- more than 65% of 946 Finance servers
- Downloads a week
- 66
- more than 58% of 421 Finance servers with a package
What its tools let an agent do: 18 read · 1 create · 1 run or deploy
Install X402engine in Claude Code, Cursor or VS Code
Runs npx -y x402engine-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add x402engine-mcp -- npx -y x402engine-mcp
What the publisher says
From the X402engine repository's README, as published. We do not edit it. Read it on GitHub
x402engine-mcp
Agent-friendly MCP server for x402engine. It lets agents discover and call pay-per-request APIs through HTTP 402, with automatic USDC payment on Base or Solana.
The live gateway covers LLMs, image and video generation, web search and scraping, code execution, crypto and wallet data, transaction simulation, audio, travel, and IPFS. This MCP exposes a curated tool set and live discovery for the full catalog.
Quick Start
Use a dedicated, low-balance payer wallet. The MCP signs x402 payments locally and never sends the private key to x402engine.
Base
{
"mcpServers": {
"x402engine": {
"command": "npx",
"args": ["-y", "x402engine-mcp@1.1.0"],
"env": {
"X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
"X402_PAYMENT_NETWORK": "base",
"X402_MAX_PAYMENT_USD": "1.00"
}
}
}
}Fund the wallet with USDC on Base. The x402 facilitator pays transaction gas; the wallet signs an EIP-3009 USDC authorization.
Solana
{
"mcpServers": {
"x402engine": {
"command": "npx",
"args": ["-y", "x402engine-mcp@1.1.0"],
"env": {
"X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",
"X402_PAYMENT_NETWORK": "solana",
"X402_MAX_PAYMENT_USD": "1.00"
}
}
}
}Fund the wallet with USDC on Solana and enough SOL for transaction fees.
Discovery Without a Wallet
The server starts without a wallet, and free tools such as discoverservices and servicehealth still work. Paid tools return their x402 payment requirements until a wallet is configured.
claude mcp add x402engine -- npx -y x402engine-mcp@1.1.0Payment Controls
In auto mode, Base is preferred when both keys are configured. Automatic payment only accepts the canonical USDC contracts on Base and Solana. It rejects unknown assets, unsupported networks, and amounts above the configured cap before signing.
MegaETH remains available to clients that supply their own compatible payment header.
MCP Tools
Prices are included in each tool description and in live discovery. The gateway catalog can change independently of this package.
Discovery
- Gateway discovery: /.well-known/x402.json
- Agent card: /.well-known/agent.json
- Endpoint manifest: /.well-known/agent-manifest.v1.json
- Services API: /api/services
- Package metadata: server.json
Development
npm install
npm test
npm run buildLinks
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
X402engine: common questions
- Is X402engine MCP server safe?
- Mostly: it is graded B (75/100). Read the X402engine safety report
- How do I install X402engine?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does X402engine need an API key?
- Yes. The registry entry asks for
X402_DEV_BYPASS,X402_PAYMENT_HEADER. - Is X402engine maintained?
- The last commit was 101 days ago (2026-07-25). The latest release is v1.0.3.
- What can I use instead of X402engine?
- Servers from other publishers that do the same job: Blockrun MCP server, Agent402.Tools: pay-per-call web tools MCP server and three.ws Agent Payments MCP server.
- How does X402engine compare with other Finance MCP servers?
- safety score 75/100 (higher than 50% of 1,761 Finance servers); tools 20 (the typical Finance server has 8); tools that change things 5% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to X402engine
Same job from other publishers: the closest match first, then the best rated.
- BlockrunWeb search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.not reviewedEstablishedB
- Agent402.Tools: pay-per-call web toolsAgentic Finance: 500+ agent tools, multi-chain USDC over x402 or MPP, or free via proof-of-worknot reviewedEstablishedA
- three.ws Agent PaymentsGoverned x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.not reviewedEstablishedB
AlgoVault — Crypto Quant Trade CallsThe Brain Layer for AI Trading Agents — quant calls + cross-venue arb across perp venues via MCP.not reviewedEstablishedA
Hive Intelligence MCPEvidence-backed crypto due diligence with sources, freshness, and a runtime receipt on every call.not reviewedEstablishedC