x402engine

resmi

50'den fazla ödeme başına çağrı API'si, HTTP 402 kripto mikro ödemeleri aracılığıyla AI ajanları için. USDC ve USDm ile çağrı başına $0.001–$0.12.

GitHub

x402engine MCP ile neler yapabilirsiniz?

Ücretli API'leri keşfedin — Asistanınızdan discover_services aracılığıyla kullanılabilir ödeme başına istek hizmetlerini listelemesini isteyin ve service_health ile durumlarını kontrol edin.
Görseller oluşturun ve kod çalıştırın — generate_image ile görsel oluşturma veya execute_code ile kod çalıştırma talep edin; Base veya Solana üzerinde otomatik USDC ödemesiyle.
Kripto ve cüzdan verilerini sorgulayın — get_crypto_price ve get_wallet_balances gibi araçları kullanarak fiyatları, piyasa trendlerini, cüzdan bakiyelerini, işlemleri ve token meta verilerini alın.
Ses ve IPFS işleyin — transcribe_audio ile ses dosyalarını yazıya dökün veya pin_to_ipfs ve get_from_ipfs kullanarak IPFS içeriğini sabitleyin ve alın.
Seyahat seçeneklerini arayın — search_flights ve search_hotels gibi araçlarla uçuşları, otelleri, konumları ve en ucuz seyahat tarihlerini bulun.

Dokümantasyon

x402engine-mcp

Ajan dostu x402engine için MCP sunucusu. Ajanların HTTP 402 üzerinden ödeme başına istek yapan API'leri keşfetmesini ve çağırmasını sağlar; Base veya Solana üzerinde otomatik USDC ödemesiyle birlikte çalışır.

Canlı ağ geçidi; LLM'ler, görüntü ve video üretimi, web arama ve kazıma, kod çalıştırma, kripto ve cüzdan verileri, işlem simülasyonu, ses, seyahat ve IPFS'yi kapsar. Bu MCP, tam katalog için seçilmiş bir araç seti ve canlı keşif sunar.

Hızlı Başlangıç

Düşük bakiyeli, özel bir ödeme cüzdanı kullanın. MCP, x402 ödemelerini yerel olarak imzalar ve özel anahtarı asla x402engine'e göndermez.

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

Cüzdanı Base üzerinde USDC ile fonlayın. x402 kolaylaştırıcısı işlem gazını öder; cüzdan bir EIP-3009 USDC yetkilendirmesi imzalar.

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

Cüzdanı Solana üzerinde USDC ve işlem ücretleri için yeterli SOL ile fonlayın.

Cüzdan Olmadan Keşif

Sunucu cüzdan olmadan başlar ve discover_services ile service_health gibi ücretsiz araçlar yine de çalışır. Ücretli araçlar, bir cüzdan yapılandırılana kadar x402 ödeme gereksinimlerini döndürür.

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

Hermes Ajanı

x402engine becerisini yükleyin ve bu sunucuyu aktif Hermes profilinin config.yaml bölümüne ekleyin:

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"

Yeni bir oturum başlatın ve discover_services veya service_health çağırın; ikisi de ücretsizdir. Bir cüzdan yapılandırılana kadar ağı auto üzerinde tutun. Base ödemeleri için X402_EVM_PRIVATE_KEY değerini profilin yerel .env alanına kaydedin, sunucunun env alanına X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" ekleyin ve ağı base olarak değiştirin. Cüzdan anahtarlarını asla sohbete koymayın. Limit istek başına uygulanır; her görev için ayrı bir toplam bütçe yetkilendirin.

Tam Hermes kurulum kılavuzu · Yüklenebilir beceri

Ödeme Kontrolleri

Değişken	Varsayılan	Açıklama
`X402_EVM_PRIVATE_KEY`	ayarlanmamış	Base USDC için özel ödeme anahtarı
`X402_SOLANA_PRIVATE_KEY`	ayarlanmamış	Solana USDC için Base58 veya JSON ödeme anahtarı
`X402_PAYMENT_NETWORK`	`auto`	`auto`, `base` veya `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	İstek başına sabit harcama limiti
`X402_BASE_URL`	üretim ağ geçidi	Ağ geçidi URL'sini geçersiz kıl
`X402_PAYMENT_HEADER`	ayarlanmamış	Eski önceden imzalanmış x402 başlığı
`X402_DEV_BYPASS`	ayarlanmamış	Geliştirme atlama sırrı

auto modunda, her iki anahtar da yapılandırıldığında Base tercih edilir. Otomatik ödeme yalnızca Base ve Solana'daki kanonik USDC sözleşmelerini kabul eder. Bilinmeyen varlıkları, desteklenmeyen ağları ve yapılandırılmış limitin üzerindeki tutarları imzalamadan önce reddeder.

MegaETH, kendi uyumlu ödeme başlığını sağlayan istemciler için kullanılabilir durumda kalır.

MCP Araçları

Kategori	Araçlar
Keşif	`discover_services`, `service_health`
Görüntü ve kod	`generate_image`, `execute_code`
Ses	`transcribe_audio`
Kripto	`get_crypto_price`, `get_crypto_markets`, `get_crypto_history`, `get_trending_crypto`, `search_crypto`, `get_crypto_categories`
Cüzdan ve token	`get_wallet_balances`, `get_wallet_transactions`, `get_wallet_pnl`, `get_token_prices`, `get_token_metadata`
IPFS	`pin_to_ipfs`, `get_from_ipfs`
Seyahat	`search_flights`, `search_locations`, `search_hotels`, `search_cheapest_dates`

Fiyatlar her araç açıklamasına ve canlı keşfe dahildir. Ağ geçidi kataloğu bu paketten bağımsız olarak değişebilir.

Keşif

Ağ geçidi keşfi: /.well-known/x402.json
Ajan kartı: /.well-known/agent.json
Uç nokta manifesti: /.well-known/agent-manifest.v1.json
Hizmetler API'si: /api/services
Paket meta verileri: server.json

Geliştirme

npm install
npm test
npm run build

Bağlantılar

Web sitesi: x402engine.app
npm: x402engine-mcp
GitHub: agentc22/x402engine-mcp
Protokol: x402.org