x402engine

officiel

Plus de 50 API pay-per-call pour agents IA via micropaiements crypto HTTP 402. 0,001 $ à 0,12 $ par appel avec USDC et USDm.

GitHub

Que pouvez-vous faire avec x402engine MCP ?

Découvrez les API payantes disponibles — parcourez le catalogue de passerelle en direct avec discover_services pour trouver des points de terminaison LLM, image, crypto, voyage et autres endpoints payants par requête.
Vérifiez l'état du service avant de payer — utilisez service_health pour vérifier qu'un point de terminaison est accessible et voir son tarif actuel sans dépenser.
Générez des images à la demande — appelez generate_image pour créer des images générées par IA, avec paiement automatique en USDC sur Base ou Solana.
Exécutez du code dans un bac à sable — exécutez des extraits via execute_code et payez par exécution via le protocole x402.
Récupérez les prix des cryptos et les données de marché — interrogez get_crypto_price, get_crypto_markets ou get_trending_crypto pour obtenir des informations en temps réel sur les tokens et le marché.
Recherchez des vols et des hôtels — utilisez search_flights, search_hotels ou search_locations pour trouver des options de voyage avec facturation par requête.

Documentation

x402engine-mcp

Serveur MCP adapté aux agents pour x402engine. Il permet aux agents de découvrir et d'appeler des API payantes à la requête via HTTP 402, avec paiement automatique en USDC sur Base ou Solana.

La passerelle en direct couvre les LLM, la génération d'images et de vidéos, la recherche et le scraping web, l'exécution de code, les données crypto et de portefeuille, la simulation de transactions, l'audio, les voyages et IPFS. Ce MCP expose un ensemble d'outils organisé et une découverte en direct pour le catalogue complet.

Démarrage rapide

Utilisez un portefeuille payeur dédié avec un solde faible. Le MCP signe les paiements x402 localement et n'envoie jamais la clé privée à 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"
      }
    }
  }
}

Approvisionnez le portefeuille avec de l'USDC sur Base. Le facilitateur x402 paie les frais de transaction ; le portefeuille signe une autorisation USDC EIP-3009.

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"
      }
    }
  }
}

Approvisionnez le portefeuille avec de l'USDC sur Solana et suffisamment de SOL pour les frais de transaction.

Découverte sans portefeuille

Le serveur démarre sans portefeuille, et les outils gratuits tels que discover_services et service_health fonctionnent toujours. Les outils payants renvoient leurs exigences de paiement x402 jusqu'à ce qu'un portefeuille soit configuré.

claude mcp add x402engine -- npx -y x402engine-mcp@1.1.0

Contrôles de paiement

Variable	Valeur par défaut	Description
`X402_EVM_PRIVATE_KEY`	non défini	Clé payeur dédiée pour l'USDC sur Base
`X402_SOLANA_PRIVATE_KEY`	non défini	Clé payeur Base58 ou JSON pour l'USDC sur Solana
`X402_PAYMENT_NETWORK`	`auto`	`auto`, `base` ou `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	Limite de dépense stricte par requête
`X402_BASE_URL`	passerelle de production	Remplacer l'URL de la passerelle
`X402_PAYMENT_HEADER`	non défini	En-tête x402 pré-signé hérité
`X402_DEV_BYPASS`	non défini	Secret de contournement pour le développement

En mode auto, Base est préféré lorsque les deux clés sont configurées. Le paiement automatique n'accepte que les contrats USDC canoniques sur Base et Solana. Il rejette les actifs inconnus, les réseaux non pris en charge et les montants supérieurs au plafond configuré avant la signature.

MegaETH reste disponible pour les clients qui fournissent leur propre en-tête de paiement compatible.

Outils MCP

Catégorie	Outils
Découverte	`discover_services`, `service_health`
Image et 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`
Portefeuille et token	`get_wallet_balances`, `get_wallet_transactions`, `get_wallet_pnl`, `get_token_prices`, `get_token_metadata`
IPFS	`pin_to_ipfs`, `get_from_ipfs`
Voyages	`search_flights`, `search_locations`, `search_hotels`, `search_cheapest_dates`

Les prix sont inclus dans chaque description d'outil et dans la découverte en direct. Le catalogue de la passerelle peut changer indépendamment de ce package.

Découverte

Découverte de la passerelle : /.well-known/x402.json
Carte d'agent : /.well-known/agent.json
Manifeste des points de terminaison : /.well-known/agent-manifest.v1.json
API des services : /api/services
Métadonnées du package : server.json

Développement

npm install
npm test
npm run build

Liens

Site web : x402engine.app
npm : x402engine-mcp
GitHub : agentc22/x402engine-mcp
Protocole : x402.org