discover_servicesLABSCO SUMMARY
An agent reaches a dozen services without holding an account at any of them.
Each call carries its own price and settles in stablecoin, so there is no subscription to manage per vendor. The ceiling matters more than the convenience: the cap is checked before anything is signed, which is what makes handing a wallet to an agent a bounded decision.
What it is
A client for the x402engine gateway: pay-per-request APIs reached through HTTP 402, with payment signed locally in USDC on Base or Solana. The gateway's catalog spans LLMs, image and video generation, web search and scraping, code execution, crypto and wallet data, transaction simulation, audio, travel and IPFS; this package exposes a curated tool set plus live discovery of the rest.
What you get
- Discovery that works before any wallet exists — what the gateway currently offers and whether it is healthy, free to call
- Crypto market data: current prices, markets, historical series, what is trending, search, and the category breakdown
- Wallet and token data for an address: balances, transaction history, profit and loss, token prices and token metadata
- Image generation and sandboxed code execution
- Audio transcription
- IPFS content pinned and fetched back
- Travel search across flights, locations, hotels and cheapest dates
- Prices carried in each tool's own description and in live discovery, so what a call costs is visible before it is made
- Payment refused before signing when it does not fit: unknown assets, unsupported networks and anything above your cap are rejected, and automatic payment accepts only the canonical USDC contracts on Base and Solana
Requirements
Node, run over stdio from npm as x402engine-mcp. Nothing else for discovery — the server starts without a wallet, and paid tools simply return their payment requirements until one is configured. To pay automatically, give it a dedicated low-balance payer key: X402_EVM_PRIVATE_KEY for Base, where the facilitator covers gas and the wallet signs an EIP-3009 USDC authorization, or X402_SOLANA_PRIVATE_KEY for Solana, which also needs a little SOL for fees. X402_PAYMENT_NETWORK chooses between them and prefers Base when both are set. X402_MAX_PAYMENT_USD is a hard per-request ceiling, 1.00 by default. The key is signed with locally and never sent to x402engine. X402_BASE_URL moves the gateway and X402_DEV_BYPASS skips payment while testing.
Setup effort
One command — npx -y x402engine-mcp@1.1.0
USE CASES
01
Seeing what is available before committing a wallet
List the live catalog with prices and check the gateway is healthy — both work with no key configured.
02
Answering a question about a token
Pull the current price, the market context around it and the history, without an API account anywhere.
03
Looking into an address
Read its balances and transactions, then the profit and loss, with token metadata to make sense of what it holds.
04
Finding what the market is paying attention to
Read the trending list and the categories, then search for the specific asset behind the noise.
05
Producing something rather than reading it
Generate an image, run code in a sandbox, or transcribe an audio file — each paid for at call time.
06
Planning a trip inside the conversation
Resolve the places, search flights and hotels, and check which dates come out cheapest.
22 tools
Listed in project docs. Your client may show a different list.
service_healthgenerate_imageexecute_codetranscribe_audioget_crypto_priceget_crypto_marketsget_crypto_historyget_trending_cryptosearch_cryptoget_crypto_categoriesget_wallet_balancesget_wallet_transactionsget_wallet_pnlget_token_pricesget_token_metadatapin_to_ipfsget_from_ipfssearch_flightssearch_locationssearch_hotelssearch_cheapest_datesBEFORE YOU INSTALL
What to know first
Tools you get
22 tools named in the project's documentation.
Requires
- npx on PATH
- Node.js 20.18+
Where it runs
All 3 documented setups run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y x402engine-mcp@1.1.0MCP Clients
Claude Code
CLAUDE CODE · TERMINAL
claude mcp add x402engine -- npx -y x402engine-mcp@1.1.0Any MCP client — EVM key
ANY MCP CLIENT — EVM KEY · JSON
{
"mcpServers": {
"x402engine": {
"command": "npx",
"args": [
"-y",
"x402engine-mcp@1.1.0"
],
"env": {
"X402_EVM_PRIVATE_KEY": "<YOUR_X402_EVM_PRIVATE_KEY>",
"X402_PAYMENT_NETWORK": "base",
"X402_MAX_PAYMENT_USD": "1.00"
}
}
}
}Any MCP client — Solana key
ANY MCP CLIENT — SOLANA KEY · JSON
{
"mcpServers": {
"x402engine": {
"command": "npx",
"args": [
"-y",
"x402engine-mcp@1.1.0"
],
"env": {
"X402_SOLANA_PRIVATE_KEY": "<YOUR_X402_SOLANA_PRIVATE_KEY>",
"X402_PAYMENT_NETWORK": "solana",
"X402_MAX_PAYMENT_USD": "1.00"
}
}
}
}
