Summary
Gives Claude direct access to 50+ pay-per-call APIs through the x402 micropayment protocol. You get LLM inference across 16+ models (GPT-4o, Claude, Gemini, DeepSeek), image generation, sandboxed code execution in Python/JS/Bash, audio transcription and TTS, crypto market data from CoinGecko, on-chain wallet analysis, web scraping, and IPFS pinning. Each call costs between $0.001 and $0.12, paid in USDC on Base or Solana. Useful when you want Claude to orchestrate multiple AI services or access live crypto data without managing separate API keys. Payment happens automatically via HTTP 402 responses, though you can use a dev bypass token for testing.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Tools
Public tool metadata for what this MCP can expose to an agent.
24 tools
discover_servicesList all available x402 Engine APIs with pricing, endpoints, and payment networks. Call this first to understand what's available.
List all available x402 Engine APIs with pricing, endpoints, and payment networks. Call this first to understand what's available.
No parameter schema in public metadata yet.
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.5 params
Generate 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.
Parameters* required
heightnumberImage height in pixelsdefault: 1024
promptstringText description of the image to generate
seednumberRandom seed for reproducibility
tierstringQuality tier: fast ($0.015), quality ($0.05), text ($0.12)one of
fast · quality · textdefault: fastwidthnumberImage width in pixelsdefault: 1024
execute_codeExecute code in a secure sandboxed environment (E2B). Supports Python, JavaScript, Bash, and R. $0.005 per execution.3 params
Execute code in a secure sandboxed environment (E2B). Supports Python, JavaScript, Bash, and R. $0.005 per execution.
Parameters* required
codestringCode to execute
languagestringProgramming languageone of
python · javascript · bash · rdefault: pythontimeoutnumberExecution timeout in seconds
transcribe_audioTranscribe audio to text using Deepgram Nova-3. Accepts a public URL to an audio file. $0.10 per transcription.4 params
Transcribe audio to text using Deepgram Nova-3. Accepts a public URL to an audio file. $0.10 per transcription.
Parameters* required
audio_urlstringPublic URL to audio file (mp3, wav, etc.)
diarizebooleanEnable speaker identificationdefault: false
languagestringLanguage code (e.g., 'en', 'es')
punctuatebooleanAdd punctuationdefault: true
get_crypto_priceGet current prices for cryptocurrencies. $0.001 per request.4 params
Get current prices for cryptocurrencies. $0.001 per request.
Parameters* required
currenciesstringComma-separated fiat currencies (default: 'usd')default: usd
idsstringComma-separated coin IDs (e.g., 'bitcoin,ethereum,solana')
include_24hbooleanInclude 24h price changedefault: true
include_mcapbooleanInclude market capdefault: false
get_crypto_marketsGet top cryptocurrencies by market cap with detailed market data. $0.002 per request.5 params
Get top cryptocurrencies by market cap with detailed market data. $0.002 per request.
Parameters* required
categorystringFilter by category
currencystringFiat currency for pricesdefault: usd
limitnumberNumber of resultsdefault: 20
orderstringSort orderdefault: market_cap_desc
pagenumberPage numberdefault: 1
get_crypto_historyGet historical price data for a cryptocurrency. $0.003 per request.3 params
Get historical price data for a cryptocurrency. $0.003 per request.
Parameters* required
currencystringFiat currencydefault: usd
daysvalueNumber of days of history (or 'max')default: 30
idstringCoin ID (e.g., 'bitcoin')
get_trending_cryptoGet trending cryptocurrencies. $0.001 per request.
Get trending cryptocurrencies. $0.001 per request.
No parameter schema in public metadata yet.
search_cryptoSearch for a cryptocurrency by name or symbol. $0.001 per request.1 params
Search for a cryptocurrency by name or symbol. $0.001 per request.
Parameters* required
qstringSearch query (coin name or symbol)
get_wallet_balancesGet token balances for a wallet address on any supported chain. $0.005 per request.2 params
Get token balances for a wallet address on any supported chain. $0.005 per request.
Parameters* required
addressstringWallet address
chainstringBlockchain name (e.g., 'ethereum', 'base', 'solana', 'arbitrum')
get_wallet_transactionsGet transaction history for a wallet address. $0.005 per request.2 params
Get transaction history for a wallet address. $0.005 per request.
Parameters* required
addressstringWallet address
chainstringBlockchain name
get_wallet_pnlGet profit and loss analysis for a wallet's token trades. $0.01 per request.4 params
Get profit and loss analysis for a wallet's token trades. $0.01 per request.
Parameters* required
addressstringWallet address
chainstringBlockchain name
min_liquiditynumberMinimum liquidity filter
min_volume_24hnumberMinimum 24h volume filter
get_token_pricesGet DEX-derived prices for tokens by contract address. $0.005 per request.1 params
Get DEX-derived prices for tokens by contract address. $0.005 per request.
Parameters* required
tokensarrayArray of tokens to price
get_token_metadataGet metadata for a token (name, symbol, decimals, etc.). $0.002 per request.4 params
Get metadata for a token (name, symbol, decimals, etc.). $0.002 per request.
Parameters* required
addressstringToken contract address
chainstringBlockchain name (required with address)
idstringToken ID (alternative to chain+address)
slugstringToken slug (alternative to chain+address)
pin_to_ipfsPin JSON data to IPFS via Pinata. Returns the IPFS CID. $0.01 per pin.2 params
Pin JSON data to IPFS via Pinata. Returns the IPFS CID. $0.01 per pin.
Parameters* required
jsonobjectJSON object to pin to IPFS
namestringName for the pinned content
get_from_ipfsRetrieve content from IPFS by CID. $0.001 per request.1 params
Retrieve content from IPFS by CID. $0.001 per request.
Parameters* required
cidstringIPFS content identifier (CID)
search_flightsSearch flight offers by route, dates, and passengers. Returns pricing, itineraries, and airlines. $0.01 per request.8 params
Search flight offers by route, dates, and passengers. Returns pricing, itineraries, and airlines. $0.01 per request.
Parameters* required
adultsnumberNumber of adult passengersdefault: 1
currencyCodestringCurrency code for prices (e.g., 'USD', 'EUR')
departureDatestringDeparture date in YYYY-MM-DD format
destinationstringDestination airport IATA code (e.g., 'LAX')
maxnumberMaximum number of offers to returndefault: 10
nonStopbooleanOnly show non-stop flightsdefault: false
originstringOrigin airport IATA code (e.g., 'JFK')
returnDatestringReturn date in YYYY-MM-DD format (for round trips)
search_locationsSearch for airports and cities by keyword. Returns IATA codes, names, and coordinates. $0.005 per request.2 params
Search for airports and cities by keyword. Returns IATA codes, names, and coordinates. $0.005 per request.
Parameters* required
keywordstringSearch keyword (e.g., 'London', 'JFK', 'Paris')
subTypestringLocation type filter: AIRPORT, CITY, or bothdefault: AIRPORT,CITY
search_hotelsSearch hotel offers by city and dates. Returns room details, pricing, and availability. $0.01 per request.7 params
Search hotel offers by city and dates. Returns room details, pricing, and availability. $0.01 per request.
Parameters* required
adultsnumberNumber of adult guests per roomdefault: 1
checkInDatestringCheck-in date in YYYY-MM-DD format
checkOutDatestringCheck-out date in YYYY-MM-DD format
cityCodestringCity IATA code (e.g., 'PAR' for Paris, 'LON' for London)
currencystringCurrency code for prices (e.g., 'USD')
priceRangestringPrice range filter (e.g., '100-200')
roomQuantitynumberNumber of roomsdefault: 1
search_cheapest_datesFind the cheapest travel dates for a route. Returns date/price pairs sorted by price. $0.01 per request.4 params
Find the cheapest travel dates for a route. Returns date/price pairs sorted by price. $0.01 per request.
Parameters* required
departureDatestringApproximate departure date in YYYY-MM-DD format
destinationstringDestination airport IATA code (e.g., 'LAX')
oneWaybooleanSearch one-way flights onlydefault: false
originstringOrigin airport IATA code (e.g., 'JFK')
resolve_ensResolve an ENS name (e.g. vitalik.eth) to an Ethereum address. $0.001 per request.1 params
Resolve an ENS name (e.g. vitalik.eth) to an Ethereum address. $0.001 per request.
Parameters* required
namestringENS name to resolve (e.g. 'vitalik.eth')
reverse_ensLook up the ENS name for an Ethereum address. Returns null if none set. $0.001 per request.1 params
Look up the ENS name for an Ethereum address. Returns null if none set. $0.001 per request.
Parameters* required
addressstringEthereum address (0x...)
llm_chatSend a chat completion request to any supported LLM. Models: gpt-4o ($0.04), gpt-4o-mini ($0.003), gpt-4.1 ($0.03), gpt-4.1-mini ($0.006), gpt-5 ($0.035), gpt-5-mini ($0.007), o3 ($0.03), o4-mini ($0.02), claude-opus ($0.09), claude-sonnet ($0.06), claude-haiku ($0.02), gemini...3 params
Send a chat completion request to any supported LLM. Models: gpt-4o ($0.04), gpt-4o-mini ($0.003), gpt-4.1 ($0.03), gpt-4.1-mini ($0.006), gpt-5 ($0.035), gpt-5-mini ($0.007), o3 ($0.03), o4-mini ($0.02), claude-opus ($0.09), claude-sonnet ($0.06), claude-haiku ($0.02), gemini...
Parameters* required
max_tokensnumberMaximum tokens to generate (default: 1024, reasoning models: 4096)
messagesarrayChat messages array
modelstringModel to useone of
gpt-4o · gpt-4o-mini · gpt-4.1 · gpt-4.1-mini · gpt-5 · gpt-5-minicreate_embeddingsGenerate text embeddings using OpenAI text-embedding-3-small. For semantic search, clustering, and RAG. $0.001 per request.2 params
Generate text embeddings using OpenAI text-embedding-3-small. For semantic search, clustering, and RAG. $0.001 per request.
Parameters* required
textstringSingle text to embed (use this OR texts, not both)
textsarrayArray of texts to embed (1-100)
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 discover_services and service_health still work. Paid tools return their x402 payment requirements until a wallet is configured.
claude mcp add x402engine -- npx -y x402engine-mcp@1.1.0
Payment Controls
| Variable | Default | Description |
|---|---|---|
X402_EVM_PRIVATE_KEY | unset | Dedicated payer key for Base USDC |
X402_SOLANA_PRIVATE_KEY | unset | Base58 or JSON payer key for Solana USDC |
X402_PAYMENT_NETWORK | auto | auto, base, or solana |
X402_MAX_PAYMENT_USD | 1.00 | Hard per-request spending limit |
X402_BASE_URL | production gateway | Override the gateway URL |
X402_PAYMENT_HEADER | unset | Legacy pre-signed x402 header |
X402_DEV_BYPASS | unset | Development bypass secret |
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
| Category | Tools |
|---|---|
| Discovery | discover_services, service_health |
| Image and code | generate_image, execute_code |
| Audio | transcribe_audio |
| Crypto | get_crypto_price, get_crypto_markets, get_crypto_history, get_trending_crypto, search_crypto, get_crypto_categories |
| Wallet and token | get_wallet_balances, get_wallet_transactions, get_wallet_pnl, get_token_prices, get_token_metadata |
| IPFS | pin_to_ipfs, get_from_ipfs |
| Travel | search_flights, search_locations, search_hotels, search_cheapest_dates |
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 build
Links
- Website: x402engine.app
- npm: x402engine-mcp
- GitHub: agentc22/x402engine-mcp
- Protocol: x402.org
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Configuration
X402_BASE_URLGateway URL (default: https://x402engine.app)
X402_DEV_BYPASSsecretDev bypass secret to skip payments during testing
X402_PAYMENT_HEADERsecretPre-signed x402 payment header for automatic payment
Categories
Registryactive
Packagex402engine-mcp
TransportSTDIO
AuthRequired
UpdatedFeb 11, 2026
