X402engine Mcp

agentc22/x402engine-mcp

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.

tools: 24
auth: Secret needed
transport: STDIO
env vars: 3
last updated: Feb 11, 2026

View on GitHub

Tools

24 tools

Public tool metadata for what this MCP can expose to an agent.

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

heightnumber

Image height in pixelsdefault: 1024

promptstring

Text description of the image to generate

seednumber

Random seed for reproducibility

tierstring

Quality tier: fast ($0.015), quality ($0.05), text ($0.12)one of fast · quality · textdefault: fast

widthnumber

Image 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

codestring

Code to execute

languagestring

Programming languageone of python · javascript · bash · rdefault: python

timeoutnumber

Execution 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_urlstring

Public URL to audio file (mp3, wav, etc.)

diarizeboolean

Enable speaker identificationdefault: false

languagestring

Language code (e.g., 'en', 'es')

punctuateboolean

Add 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

currenciesstring

Comma-separated fiat currencies (default: 'usd')default: usd

idsstring

Comma-separated coin IDs (e.g., 'bitcoin,ethereum,solana')

include_24hboolean

Include 24h price changedefault: true

include_mcapboolean

Include 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

categorystring

Filter by category

currencystring

Fiat currency for pricesdefault: usd

limitnumber

Number of resultsdefault: 20

orderstring

Sort orderdefault: market_cap_desc

pagenumber

Page 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

currencystring

Fiat currencydefault: usd

daysvalue

Number of days of history (or 'max')default: 30

idstring

Coin 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

qstring

Search 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

addressstring

Wallet address

chainstring

Blockchain 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

addressstring

Wallet address

chainstring

Blockchain 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

addressstring

Wallet address

chainstring

Blockchain name

min_liquiditynumber

Minimum liquidity filter

min_volume_24hnumber

Minimum 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

tokensarray

Array 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

addressstring

Token contract address

chainstring

Blockchain name (required with address)

idstring

Token ID (alternative to chain+address)

slugstring

Token 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

jsonobject

JSON object to pin to IPFS

namestring

Name 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

cidstring

IPFS 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

adultsnumber

Number of adult passengersdefault: 1

currencyCodestring

Currency code for prices (e.g., 'USD', 'EUR')

departureDatestring

Departure date in YYYY-MM-DD format

destinationstring

Destination airport IATA code (e.g., 'LAX')

maxnumber

Maximum number of offers to returndefault: 10

nonStopboolean

Only show non-stop flightsdefault: false

originstring

Origin airport IATA code (e.g., 'JFK')

returnDatestring

Return 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

keywordstring

Search keyword (e.g., 'London', 'JFK', 'Paris')

subTypestring

Location 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

adultsnumber

Number of adult guests per roomdefault: 1

checkInDatestring

Check-in date in YYYY-MM-DD format

checkOutDatestring

Check-out date in YYYY-MM-DD format

cityCodestring

City IATA code (e.g., 'PAR' for Paris, 'LON' for London)

currencystring

Currency code for prices (e.g., 'USD')

priceRangestring

Price range filter (e.g., '100-200')

roomQuantitynumber

Number 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

departureDatestring

Approximate departure date in YYYY-MM-DD format

destinationstring

Destination airport IATA code (e.g., 'LAX')

oneWayboolean

Search one-way flights onlydefault: false

originstring

Origin 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

namestring

ENS 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

addressstring

Ethereum 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_tokensnumber

Maximum tokens to generate (default: 1024, reasoning models: 4096)

messagesarray

Chat messages array

modelstring

Model to useone of gpt-4o · gpt-4o-mini · gpt-4.1 · gpt-4.1-mini · gpt-5 · gpt-5-mini

create_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

textstring

Single text to embed (use this OR texts, not both)

textsarray

Array of texts to embed (1-100)

Configuration

X402_BASE_URL

Gateway URL (default: https://x402engine.app)

X402_DEV_BYPASSsecret

Dev bypass secret to skip payments during testing

X402_PAYMENT_HEADERsecret

Pre-signed x402 payment header for automatic payment

Readme

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.1"],
      "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

View the full README on GitHub

Details

Repository: github.com/agentc22/x402engine-mcp
Categories: AI & LLM Tools, Finance & Commerce
Package: x402engine-mcp
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related AI & LLM Tools MCP servers

View all

Agentic Terminal Directoryobserver-protocol/at-directoryVerified merchants accepting agentic payments on Lightning/L402/BOLT12/USDT — search, verify, pay.0stars

Computebackautonomad1/computeback-mcpAgent Rewards Marketplace: earn $NOMD on B2B work, spend on agent capabilities.0stars

Not Human Searchai.nothumansearch/searchSearch the agentic web. 4,100+ sites, 11 tools incl. check_url + verify_mcp for probe-before-use.0stars

El Buen Agente Mcpapasztetnik/el-buen-agente-mcpLa guía 'El Buen Agente' como 18 tools para evaluar, mejorar y construir agentes LLM. En español.0stars

Mcp Auditarchonics/mcp-auditFree context-engineering audits for AI agents. BYOK Anthropic key. Top-3 findings per scan.0stars

memexayushagrawal288/memexPersistent memory for AI agents — semantic + recency search, ONNX embeddings, Docker Compose.0stars