xpayr_health_check
API Ağ Geçidi Sağlık Kontrolü
XPayr Gateway API v1 operasyonel sağlığını, sürümünü ve sunucu zaman damgasını kontrol edin.
GET /health
Açık (Anahtarsız)
Gözetimsiz Kripto Ticareti İçin Model Context Protocol (MCP) Sunucusu.
Claude Desktop, Cursor, VS Code Copilot, Windsurf, Cline ve n8n ajanlarına politika korumalı yerel erişim sağlayın: güçlü tipli 21 XPayr aracı — çok zincirli USDT/USDC ödeme oturumları oluşturun, HMAC webhook'larını doğrulayın, otonom ödeme niyetleri gönderin ve şu orandaki 99.5% / 0.5% mutabakat paylaşımlarını modelleyin.
⚡ Canlı 21 Araçlı MCP Oyun Alanını Başlat
🌐 mcp.xpayr.com Portalını Aç
📦 npm: @xpayr/mcp-server
📄 /.well-known/mcp.json
21 AraçÖdeme, webhook'lar, AI ajanları ve üye iş yeri hazinesi genelinde.
2 Aktarım KatmanıUzak JSON-RPC 2.0 (
/api/mcp) + Yerel npx Stdio.6 Modül PaketiBağlam pencerelerini şu parametreyle daraltın:
--suite flagship veya all.Harcama Korkuluklarıİşlem başı tavanlar, günlük bütçeler ve insan onay kuyrukları.
Tek Tıkla IDE ve Ajan İstemci Yapılandırması
Canlı Tarayıcı Testi → POST /api/mcp
Doğrudan bu sayfadan XPayr'ın canlı Streamable HTTP MCP uç noktasına gerçek bir JSON-RPC 2.0 isteği gönderin.
// Click "Run tools/list" or "Run Fee Split ($250 USDC)" to inspect live JSON-RPC 2.0 output from https://xpayr.com/api/mcp
Resmi 21 MCP Aracının Tamamı
xpayr_create_payment_session
Kripto Ödeme Oturumu Oluştur (Çift Katmanlı Ödeme)
Web3 Tek Tık Ödeme, Doğrudan Borsa QR Transferi, Çok Zincirli Bağlantılar, 1 Yıllık Tekrar Kullanılabilir Bağlantılar ve Otomatik HTML Fatura E-posta Gönderimini destekleyen gözetimsiz bir kripto ödeme oturumu oluşturun.
POST /payments
Bearer sk_test / sk_live
xpayr_get_payment_session
Ödeme Oturumu Detaylarını Getir
Bir ödeme oturumu için tüm ayrıntıları, meta verileri, takas dağılım tutarlarını, ödeme modunu ve zincir üstü işlem karmasını (hash) alın.
GET /payments/{session_id}
Bearer sk_test / sk_live
xpayr_list_payment_sessions
İşyeri Ödeme Oturumlarını Listele
İşyeri kripto ödeme oturumlarını durum, para birimi, ağ ve sayfalama filtreleriyle listeleyin.
GET /payments
Bearer sk_test / sk_live
xpayr_get_public_payment_status
Açık Zincir Üstü Ödeme Durumunu Sorgula
API anahtarı olmadan gerçek zamanlı açık ödeme durumunu, zincir üstü tx_hash değerini, gönderen cüzdan adresini, blok onaylarını ve paid_at zaman damgasını sorgulayın.
GET /payments/{session_id}/status
Açık (Anahtarsız)
xpayr_apply_payment_coupon
Ödeme İndirim Kuponu Uygula
Beklemedeki aktif bir ödeme oturumuna işyeri promosyon indirim kupon kodunu doğrulayıp uygulayın.
POST /payments/{session_id}/coupon
Açık (Anahtarsız)
xpayr_get_merchant_profile
İşyeri Profili ve Takas Cüzdanını Getir
Kimliği doğrulanmış işyeri profilini, takas cüzdan adresini, baz puan cinsinden komisyon oranını (50 bps = 0.5%) ve aktif API anahtarlarını alın.
GET /me
Bearer sk_test / sk_live
xpayr_get_merchant_balance
Çok Zincirli Takas Hacmi ve Bakiyeyi Getir
Para birimi ve blokzincir ağına göre gruplandırılmış onaylı gözetimsiz takas hacmini, işlem sayılarını ve platform ücretlerini sorgulayın.
GET /me/balance
Bearer sk_test / sk_live
xpayr_get_supported_networks
Desteklenen Ağları, Zincirleri ve Tokenları Listele
Aktif tüm EVM, TRON, Solana ve Arc Mainnet/Testnet blokzincir ağlarını, zincir kimliklerini (chain ID), RPC uç noktalarını, bölüştürücü sözleşmeleri ve desteklenen tokenları listeleyin.
GET /me/networks
Bearer sk_test / sk_live
xpayr_get_webhook_config
Webhook Yapılandırmasını ve Olayları Getir
İşyeri webhook geri çağırma URL'sini, maskelenmiş HMAC-SHA256 imzalama sırrını ve abone olunan ödeme yaşam döngüsü olaylarını inceleyin.
GET /webhooks
Bearer sk_test / sk_live
xpayr_set_webhook_endpoint
HTTPS Webhook Uç Noktasını Yapılandır
İşyeri HTTPS webhook alıcı URL'sini yapılandırın veya güncelleyin ve yeni bir 32 baytlık HMAC-SHA256 imzalama sırrı oluşturun.
POST /webhooks
Bearer sk_test / sk_live
xpayr_send_test_webhook
İmzalı Test Webhook Olayı Gönder
İşyeri webhook imza doğrulamasını test etmek için HMAC-SHA256 başlıklarına sahip imzalı bir test.webhook yükü gönderin.
POST /webhooks/test
Bearer sk_test / sk_live
xpayr_create_ai_agent
Politika Kontrollü Yapay Zeka Ticaret Ajanı Oluştur
Kapsamlandırılmış kimlik bilgileri ve programlanabilir harcama koruma sınırlarıyla işyeri tarafından yönetilen yeni bir yapay zeka ticaret ajanı kimliği oluşturun.
POST /agents
Bearer sk_test / sk_live
xpayr_list_ai_agents
İşyeri Yapay Zeka Ticaret Ajanlarını Listele
İşyeri tarafından yönetilen tüm yapay zeka ticaret ajanlarını durumları, atanmış cüzdanları ve harcama politikalarıyla birlikte listeleyin.
GET /agents
Bearer sk_test / sk_live
xpayr_update_ai_agent_policy
Yapay Zeka Ajanı Harcama Koruma Sınırlarını Güncelle
Bir yapay zeka ajanı için harcama politikası koruma sınırlarını yapılandırın (işlem başı maks. USD, günlük üst sınır, otomatik onay eşiği, izin verilen zincirler/tokenlar).
PUT /agents/{agent_id}/policy
Bearer sk_test / sk_live
xpayr_submit_agent_payment_intent
Otonom Yapay Zeka Ajanı Ödeme Niyeti Gönder
İşyeri politika kurallarına göre gerçek zamanlı değerlendirilen otonom bir yapay zeka ajanı ödeme niyeti gönderin (approved, pending_approval, rejected).
POST /agent-intents
Bearer agk_test / agk_live
xpayr_list_agent_payment_intents
Yapay Zeka Ajanı Ödeme Niyetlerini ve Denetim Kayıtlarını Listele
İşyeri için yapay zeka ajanı ödeme niyetlerini, politika değerlendirme kararlarını ve denetim izi kayıtlarını listeleyin.
GET /agent-intents
Bearer sk_test / sk_live
xpayr_bridge_agent_intent_to_checkout
Onaylanan Ajan Niyetini Ödeme Oturumuna Dönüştür
Onaylanmış bir yapay zeka ajanı ödeme niyetini, barındırılan ödeme URL'si ve zincir üstü doğrulama içeren canlı yürütülebilir bir XPayr ödeme oturumuna dönüştürün.
POST /agent-intents/{intent_id}/bridge
Bearer sk_test / sk_live
xpayr_approve_agent_intent
Bekleyen Yapay Zeka Ajanı Niyetini Onayla (İnsan Onaylı)
İşyeri onay kuyruğundaki bekleyen bir yapay zeka ajanı ödeme niyetini onaylayın ve ödeme oturumuna aktarın.
POST /agent-approvals/{intent_id}/approve
Bearer sk_test / sk_live
xpayr_reject_agent_intent
Bekleyen Yapay Zeka Ajanı Niyetini Reddet
İşyeri onay kuyruğundaki bekleyen bir yapay zeka ajanı ödeme niyetini denetim gerekçesiyle reddedin.
POST /agent-approvals/{intent_id}/reject
Bearer sk_test / sk_live
xpayr_calculate_gateway_fee_and_split
0.5% Ağ Geçidi Komisyon Dağılımı ve Borsa Tolerans Hesaplayıcı
XPayr sabit 0.5% (50 bps) ağ geçidi komisyon dağılımını, net işyeri cüzdan takasını, 1% (maks. $0.50) borsa çekim toleransını ve BitPay, Coinbase Commerce ve Stripe'a kıyasla tasarrufu deterministik olarak hesaplayın.
LOCAL /tools/crypto-payment-fee-calculator
Çevrimdışı / Açık
XPayr MCP Sunucusu SSS
Uzak Streamable HTTP (/api/mcp) ile mi yoksa yerel npx (@xpayr/mcp-server) ile mi bağlanmalıyım?
Her iki yöntem de 21 XPayr aracının tamamını birebir aynı şemalarla sunar. Uzak Streamable HTTP (https://xpayr.com/api/mcp) sıfır yerel Node.js çalışma zamanı gerektirir ve bulut ajanlarında, n8n'de ve modern IDE'lerde anında çalışır; npx -y @xpayr/mcp-server@1.0.0 ise yerel olarak stdio üzerinden çalışır ve modül kapsamlandırmasını (--suite flagship,checkout) destekler.
AI ajanları API anahtarı olmadan herkese açık MCP araçlarını çağırabilir mi?
Evet. Herkese açık keşif, geçit sağlık kontrolü (xpayr_health_check), deterministik 0.5% komisyon bölünmesi hesaplaması (xpayr_calculate_gateway_fee_and_split) ve açık oturum durumu sorgulama kimlik bilgisi olmadan çalışır. Kimlik doğrulamalı ödeme oluşturma ve ajan ödeme niyeti araçları ise sk_test_ veya sk_live_ anahtarınızı kullanır.
Harcama korkulukları bir LLM halüsinasyonunun aşırı harcama yapmasını nasıl engeller?
XPayr AI Ticaret Ajanları, zincir üstünde herhangi bir fon hareket etmeden önce sunucu tarafında işlem başı tavanları, günlük hareketli bütçeleri, otomatik onay eşiklerini, zincir/token beyaz listelerini ve insan onay kuyruklarını (/agent-commerce) zorunlu tutar.
XPayr MCP nerede yayınlanmakta ve doğrulanmaktadır?
XPayr MCP; npm (@xpayr/mcp-server@1.0.0), GitHub Container Registry (ghcr.io/xpayrcom/xpayr-mcp-server), Resmi MCP Kayıt Defteri, Glama ve Smithery üzerinde yayınlanmış olup https://mcp.xpayr.com ve /.well-known/mcp.json adreslerinde belgelenmiştir.