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
1

Que pouvez-vous faire avec x402engine MCP ?

  • Découvrir les API payantes — Demandez à votre assistant de lister les services payants à la demande via discover_services et vérifiez leur statut avec service_health.
  • Générer des images et exécuter du code — Demandez la création d’images avec generate_image ou l’exécution de code avec execute_code, avec paiement automatique en USDC sur Base ou Solana.
  • Interroger les données crypto et portefeuille — Obtenez les prix, tendances du marché, soldes de portefeuille, transactions et métadonnées de jetons à l’aide d’outils comme get_crypto_price et get_wallet_balances.
  • Traiter l’audio et IPFS — Transcrivez des fichiers audio avec transcribe_audio, ou épinglez et récupérez du contenu depuis IPFS avec pin_to_ipfs et get_from_ipfs.
  • Rechercher des options de voyage — Trouvez des vols, hôtels, lieux et dates de voyage les moins chères avec des outils comme search_flights et search_hotels.

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 web et le scraping, l'exécution de code, les données crypto et portefeuille, la simulation de transactions, l'audio, les voyages et IPFS. Ce MCP expose un ensemble d'outils sélectionnés et une découverte en direct pour le catalogue complet.

Démarrage rapide

Utilisez un portefeuille payeur dédié à 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.1"],
      "env": {
        "X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
        "X402_PAYMENT_NETWORK": "base",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Approvisionnez le portefeuille en 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.1"],
      "env": {
        "X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",
        "X402_PAYMENT_NETWORK": "solana",
        "X402_MAX_PAYMENT_USD": "1.00"
      }
    }
  }
}

Approvisionnez le portefeuille en USDC sur Solana et en SOL suffisant 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.1

Agent Hermes

Installez la compétence x402engine et fusionnez ce serveur dans le config.yaml du profil Hermes actif :

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"

Démarrez une nouvelle session et appelez discover_services ou service_health ; les deux sont gratuits. Gardez le réseau sur auto jusqu'à ce qu'un portefeuille soit configuré. Pour les paiements Base, stockez X402_EVM_PRIVATE_KEY dans le .env local du profil, ajoutez X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" au env du serveur, et changez le réseau en base. Ne mettez jamais les clés de portefeuille dans le chat. Le plafond s'applique par requête ; autorisez un budget total séparé pour chaque tâche.

Guide de configuration Hermes complet · Compétence installable

Contrôles de paiement

VariableDéfautDescription
X402_EVM_PRIVATE_KEYnon définiClé payeuse dédiée pour USDC Base
X402_SOLANA_PRIVATE_KEYnon définiClé payeuse Base58 ou JSON pour USDC Solana
X402_PAYMENT_NETWORKautoauto, base ou solana
X402_MAX_PAYMENT_USD1.00Limite de dépense stricte par requête
X402_BASE_URLpasserelle de productionRemplace l'URL de la passerelle
X402_PAYMENT_HEADERnon définiEn-tête x402 pré-signé hérité
X402_DEV_BYPASSnon définiSecret de contournement pour le développement

En mode auto, Base est préférée 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égorieOutils
Découvertediscover_services, service_health
Image et codegenerate_image, execute_code
Audiotranscribe_audio
Cryptoget_crypto_price, get_crypto_markets, get_crypto_history, get_trending_crypto, search_crypto, get_crypto_categories
Portefeuille et jetonget_wallet_balances, get_wallet_transactions, get_wallet_pnl, get_token_prices, get_token_metadata
IPFSpin_to_ipfs, get_from_ipfs
Voyagesearch_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éveloppement

npm install
npm test
npm run build

Liens