x402engine

resmi

50+ API bayar-per-panggilan untuk agen AI melalui pembayaran mikro kripto HTTP 402. $0,001–$0,12 per panggilan dengan USDC dan USDm.

GitHub

Apa yang bisa Anda lakukan dengan x402engine MCP?

Menemukan API berbayar — Minta asisten Anda untuk mencantumkan layanan bayar-per-permintaan yang tersedia melalui discover_services dan periksa statusnya dengan service_health.
Membuat gambar dan menjalankan kode — Minta pembuatan gambar dengan generate_image atau eksekusi kode dengan execute_code, dengan pembayaran USDC otomatis di Base atau Solana.
Mengkueri data kripto dan dompet — Dapatkan harga, tren pasar, saldo dompet, transaksi, dan metadata token menggunakan alat seperti get_crypto_price dan get_wallet_balances.
Memproses audio dan IPFS — Transkripsikan file audio dengan transcribe_audio, atau sematkan dan ambil konten dari IPFS menggunakan pin_to_ipfs dan get_from_ipfs.
Mencari opsi perjalanan — Temukan penerbangan, hotel, lokasi, dan tanggal perjalanan termurah dengan alat seperti search_flights dan search_hotels.

Dokumentasi

x402engine-mcp

Server MCP yang ramah agen untuk x402engine. Ini memungkinkan agen menemukan dan memanggil API bayar-per-permintaan melalui HTTP 402, dengan pembayaran USDC otomatis di Base atau Solana.

Gateway langsung mencakup LLM, pembuatan gambar dan video, pencarian web dan scraping, eksekusi kode, data kripto dan dompet, simulasi transaksi, audio, perjalanan, dan IPFS. MCP ini mengekspos serangkaian alat terkurasi dan penemuan langsung untuk katalog lengkap.

Mulai Cepat

Gunakan dompet pembayar khusus dengan saldo rendah. MCP menandatangani pembayaran x402 secara lokal dan tidak pernah mengirim kunci privat ke 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"
      }
    }
  }
}

Dana dompet dengan USDC di Base. Fasilitator x402 membayar gas transaksi; dompet menandatangani otorisasi 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"
      }
    }
  }
}

Dana dompet dengan USDC di Solana dan cukup SOL untuk biaya transaksi.

Penemuan Tanpa Dompet

Server berjalan tanpa dompet, dan alat gratis seperti discover_services dan service_health tetap berfungsi. Alat berbayar mengembalikan persyaratan pembayaran x402 mereka sampai dompet dikonfigurasi.

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

Agen Hermes

Instal keterampilan x402engine dan gabungkan server ini ke dalam config.yaml profil Hermes aktif:

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"

Mulai sesi baru dan panggil discover_services atau service_health; keduanya gratis. Pertahankan jaringan di auto sampai dompet dikonfigurasi. Untuk pembayaran Base, simpan X402_EVM_PRIVATE_KEY di .env lokal profil, tambahkan X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" ke env server, dan ubah jaringan ke base. Jangan pernah menaruh kunci dompet di obrolan. Batas berlaku per permintaan; otorisasi anggaran total terpisah untuk setiap tugas.

Panduan pengaturan Hermes lengkap · Keterampilan yang dapat diinstal

Kontrol Pembayaran

Variabel	Default	Deskripsi
`X402_EVM_PRIVATE_KEY`	tidak diatur	Kunci pembayar khusus untuk USDC Base
`X402_SOLANA_PRIVATE_KEY`	tidak diatur	Kunci pembayar Base58 atau JSON untuk USDC Solana
`X402_PAYMENT_NETWORK`	`auto`	`auto`, `base`, atau `solana`
`X402_MAX_PAYMENT_USD`	`1.00`	Batas pengeluaran keras per permintaan
`X402_BASE_URL`	gateway produksi	Menimpa URL gateway
`X402_PAYMENT_HEADER`	tidak diatur	Header x402 pra-tanda tangan lama
`X402_DEV_BYPASS`	tidak diatur	Rahasia bypass pengembangan

Dalam mode auto, Base lebih disukai ketika kedua kunci dikonfigurasi. Pembayaran otomatis hanya menerima kontrak USDC kanonik di Base dan Solana. Ini menolak aset yang tidak dikenal, jaringan yang tidak didukung, dan jumlah di atas batas yang dikonfigurasi sebelum menandatangani.

MegaETH tetap tersedia untuk klien yang menyediakan header pembayaran kompatibel mereka sendiri.

Alat MCP

Kategori	Alat
Penemuan	`discover_services`, `service_health`
Gambar dan kode	`generate_image`, `execute_code`
Audio	`transcribe_audio`
Kripto	`get_crypto_price`, `get_crypto_markets`, `get_crypto_history`, `get_trending_crypto`, `search_crypto`, `get_crypto_categories`
Dompet dan token	`get_wallet_balances`, `get_wallet_transactions`, `get_wallet_pnl`, `get_token_prices`, `get_token_metadata`
IPFS	`pin_to_ipfs`, `get_from_ipfs`
Perjalanan	`search_flights`, `search_locations`, `search_hotels`, `search_cheapest_dates`

Harga disertakan dalam setiap deskripsi alat dan dalam penemuan langsung. Katalog gateway dapat berubah secara independen dari paket ini.

Penemuan

Penemuan gateway: /.well-known/x402.json
Kartu agen: /.well-known/agent.json
Manifes titik akhir: /.well-known/agent-manifest.v1.json
API layanan: /api/services
Metadata paket: server.json

Pengembangan

npm install
npm test
npm run build

Tautan

Situs web: x402engine.app
npm: x402engine-mcp
GitHub: agentc22/x402engine-mcp
Protokol: x402.org