io.github.agentc22/x402engine-mcp

Registre officiel Outils de développement

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package x402engine-mcp

Claude Code

claude mcp add x402engine-mcp -e 'X402_BASE_URL=<X402_BASE_URL>' -e 'X402_DEV_BYPASS=<your x402_dev_bypass>' -e 'X402_PAYMENT_HEADER=<your x402_payment_header>' -- npx -y x402engine-mcp@1.0.3

Configuration JSON (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "x402engine-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "x402engine-mcp@1.0.3"
            ],
            "env": {
                "X402_BASE_URL": "<X402_BASE_URL>",
                "X402_DEV_BYPASS": "<your x402_dev_bypass>",
                "X402_PAYMENT_HEADER": "<your x402_payment_header>"
            }
        }
    }
}

Variables d'environnement

X402_BASE_URL Gateway URL (default: https://x402engine.app)
X402_DEV_BYPASS secret Dev bypass secret to skip payments during testing
X402_PAYMENT_HEADER secret Pre-signed x402 payment header for automatic payment

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire

x402engine-mcp
Quick Start
Hermes Agent
Payment Controls
MCP Tools
Discovery
Development
Links

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

{
  "mcpServers": {
    "x402engine": {
      "command": "npx",
      "args": ["-y", "x402engine-mcp@1.1.1"],
      "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.1

Hermes Agent

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

mcp_servers:
  x402engine:
    command: npx
    args: ["-y", "x402engine-mcp@1.1.1"]
    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

npm install
npm test
npm run build

Questions fréquentes

Qu'est-ce que io.github.agentc22/x402engine-mcp ?

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

Comment installer io.github.agentc22/x402engine-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add x402engine-mcp -e 'X402_BASE_URL=<X402_BASE_URL>' -e 'X402_DEV_BYPASS=<your x402_dev_bypass>' -e 'X402_PAYMENT_HEADER=<your x402_payment_header>' -- npx -y x402engine-mcp@1.0.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.agentc22/x402engine-mcp ?

Oui. Il attend X402_DEV_BYPASS, X402_PAYMENT_HEADER, à renseigner dans sa configuration.

io.github.agentc22/x402engine-mcp est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.agentc22/x402engine-mcp ?

Il est publié par agentc22. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.

Détails du serveur

Référencé dans: Registre MCP officiel
Éditeur: agentc22
Catégorie: Outils de développement
Exécution: Local
Étoiles GitHub: ★ 1
Langage: JavaScript
Dernier commit: 11 oct. 2026
Tickets ouverts: 9
Version: 1.0.3
Publié le: 11 févr. 2026

io.github.agentc22/x402engine-mcp

Serveurs similaires

ljos Local memory, a work tracker and a shell-command guard shared by coding agents on one m...
Cartographer Governance MCP server for agent-maintained knowledge bases (OKF): git-backed writes, se...
amem Local, private memory for coding agents: facts, skills and tasks that persist across se...
tinyprobe API testing in YAML: inspect, call and run endpoints and workflows, with the guide to w...
Connecticut Code Connecticut General Statutes — state statutes by citation.
Colorado Code Colorado Revised Statutes — state statutes by citation, topic, and title.
Codestats Code::Stats MCP — public user XP / activity.
Vulnerability Exposure Confirmed vulnerabilities and exposure for IPs, domains and software versions (NVD, CIS...

Outils de développement