X402engine Mcp

io.github.agentc22Published by GitHub account agentc22v1.0.3Updated Nov 3, 2026

50+ pay-per-call APIs for AI agents — images, LLM, code, crypto, travel & more via x402

VerifiedSTDIODesktop onlyWeb Search & Scraping Finance AI & ML

Server details

Identifier: io.github.agentc22/x402engine-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account agentc22 for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.agentc22%2Fx402engine-mcp.svg)](https://sourceweft.com/mcp/io.github.agentc22%2Fx402engine-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Local MCP server that lets an assistant discover and call 50+ pay-per-request APIs, paying in USDC on Base or Solana via x402.

What you can do: Discover the gateway catalog and check service health, free of charge
Generate images and run code
Transcribe audio
Look up crypto prices, markets, history, trending coins, categories and search
Read wallet balances, transactions and PnL, plus token prices and metadata
Pin and retrieve files on IPFS, and search flights, locations, hotels and cheapest travel dates
When to use it: Useful when an assistant needs many unrelated capabilities (images, LLM, code, crypto, travel, IPFS) from one gateway and you are willing to pay per call in USDC. Free discovery and health tools work without a wallet, so it can also be tried just to browse the catalog.
Requirements: Runs locally via npx (Node.js). A funded payer wallet is needed for paid tools: X402_EVM_PRIVATE_KEY for Base USDC or X402_SOLANA_PRIVATE_KEY for Solana USDC, plus SOL for Solana fees. Optional settings include X402_PAYMENT_NETWORK, X402_MAX_PAYMENT_USD, X402_BASE_URL, X402_PAYMENT_HEADER and X402_DEV_BYPASS. Network access to the gateway is required.

Before you install

Paid tools spend real USDC from the configured wallet; the cap in X402_MAX_PAYMENT_USD applies per request, not per task, so set a separate budget. Use a dedicated low-balance wallet and never put keys in chat. X402_DEV_BYPASS skips payments and X402_PAYMENT_HEADER carries a pre-signed payment. Requests go to a third-party gateway whose catalog can change independently of the package.

Installation

In SourceWeft

Open X402engine Mcp in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

json

{  "mcpServers": {    "x402engine": {      "command": "npx",      "args": ["-y", "[email protected]"],      "env": {        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",        "X402_PAYMENT_NETWORK": "base",        "X402_MAX_PAYMENT_USD": "1.00"      }    }  }}

{  "mcpServers": {    "x402engine": {      "command": "npx",      "args": ["-y", "[email protected]"],      "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

json

{  "mcpServers": {    "x402engine": {      "command": "npx",      "args": ["-y", "[email protected]"],      "env": {        "X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",        "X402_PAYMENT_NETWORK": "solana",        "X402_MAX_PAYMENT_USD": "1.00"      }    }  }}

{  "mcpServers": {    "x402engine": {      "command": "npx",      "args": ["-y", "[email protected]"],      "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.

Hermes Agent

Install the x402engine skill and merge this server into the active Hermes profile's config.yaml:

yaml

mcp_servers:  x402engine:    command: npx    args: ["-y", "[email protected]"]    env:      X402_BASE_URL: "https://x402engine.app"      X402_PAYMENT_NETWORK: "auto"      X402_MAX_PAYMENT_USD: "0.10"

mcp_servers:  x402engine:    command: npx    args: ["-y", "[email protected]"]    env:      X402_BASE_URL: "https://x402engine.app"      X402_PAYMENT_NETWORK: "auto"      X402_MAX_PAYMENT_USD: "0.10"

Start a new session and call discover_services or service_health; both are free. Keep the network on auto until a wallet is configured. For Base payments, store X402_EVM_PRIVATE_KEY in the profile's local .env, add X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" to the server's env, and change the network to base. Never put wallet keys in chat. The cap applies per request; authorize a separate total budget for each task.

Full Hermes setup guide · Installable skill

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

Links

Source: README.md at commit dd1c274

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.3LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.