x402engine
resmi50'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.
x402engine MCP ile neler yapabilirsiniz?
- Kullanılabilir ücretli API'leri keşfedin — canlı ağ geçidi kataloğuna göz atmak için
discover_serviceskullanarak LLM, görsel, kripto, seyahat ve diğer istek başına ödeme uç noktalarını bulun. - Ödeme yapmadan önce hizmet durumunu kontrol edin — bir uç noktanın erişilebilir olduğunu doğrulamak ve harcama yapmadan mevcut fiyatlandırmasını görmek için
service_healthkullanın. - İsteğe bağlı görseller oluşturun — Base veya Solana üzerinde otomatik USDC ödemesiyle yapay zeka tarafından oluşturulmuş görseller oluşturmak için
generate_imageçağrısı yapın. - Korumalı alanda kod çalıştırın —
execute_codearacılığıyla kod parçacıkları çalıştırın ve x402 protokolü üzerinden her çalıştırma için ödeme yapın. - Kripto fiyatlarını ve piyasa verilerini alın — gerçek zamanlı token ve piyasa bilgileri için
get_crypto_price,get_crypto_marketsveyaget_trending_cryptosorgulayın. - Uçuş ve otel arayın — istek başına faturalandırma ile seyahat seçeneklerini aramak için
search_flights,search_hotelsveyasearch_locationskullanın.
Dokümantasyon
x402engine-mcp
x402engine için ajan dostu MCP sunucusu. Ajanların, Base veya Solana üzerinde otomatik USDC ödemesiyle, HTTP 402 aracılığıyla ödeme başına istek API'lerini keşfetmesini ve çağırmasını sağlar.
Canlı ağ geçidi; LLM'leri, görüntü ve video oluşturmayı, web araması ve kazımayı, kod yürütmeyi, kripto ve cüzdan verilerini, işlem simülasyonunu, ses, seyahat ve IPFS'i 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.0"],
"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.0"],
"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üzdansız Keşif
Sunucu cüzdansız başlar ve discover_services ile service_health gibi ücretsiz araçlar hâlâ ç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.0
Ö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 ön imzalı 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 üzerindeki kanonik USDC sözleşmelerini kabul eder. Bilinmeyen varlıkları, desteklenmeyen ağları ve yapılandırılan sınırın ü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ında ve canlı keşifte yer alır. 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 manifestosu: /.well-known/agent-manifest.v1.json
- Servisler API'si: /api/services
- Paket meta verisi: 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