@xpayr/mcp-server v1.0.0 · السجل: io.github.xpayrcom/xpayr-mcp-server · 21 أداة

خادم Model Context Protocol (MCP) للتجارة الرقمية غير الوصائية بالكريبتو.

امنح وكلاء Claude Desktop وCursor وVS Code Copilot وWindsurf وCline وn8n وصولاً أصلياً محمياً بالسياسات إلى 21 أداة XPayr قوية الأنواع — لإنشاء جلسات دفع USDT/USDC متعددة السلاسل، والتحقق من إشعارات ويب هوك HMAC، وإرسال نوايا دفع مستقلة، ونمذجة تقسيمات التسوية بنسبة 99.5% / 0.5% بدقة حتمية.

⚡ شغّل ساحة تجربة MCP الحية بـ 21 أداة 🌐 افتح بوابة mcp.xpayr.com 📦 حزمة npm: @xpayr/mcp-server 📄 /.well-known/mcp.json
21 أداةتشمل الدفع، والويب هوك، ووكلاء الذكاء الاصطناعي، وخزينة التاجر.
وسيلتا نقلJSON-RPC 2.0 بعيد (/api/mcp) + محلي عبر npx Stdio.
6 مجموعات وحداتخصّص نوافذ السياق عبر --suite flagship أو all.
ضوابط الإنفاقسقوف لكل معاملة، وميزانيات يومية، وطوابير اعتماد بشري.

إعداد عملاء الوكلاء وبيئات التطوير IDE بنقرة واحدة


        


        

            
اختبار مباشر من المتصفح ← POST /api/mcp

            
أرسل طلب JSON-RPC 2.0 حقيقيًا إلى نقطة نهاية Streamable HTTP MCP المباشرة الخاصة بـ XPayr مباشرةً من هذه الصفحة.

            

                
                
            

            
// Click "Run tools/list" or "Run Fee Split ($250 USDC)" to inspect live JSON-RPC 2.0 output from https://xpayr.com/api/mcp

        

    


    

        
جميع أدوات MCP الرسمية الـ 21

        

            
            
            
            
            
            
        


        

                                            

                    

                        xpayr_health_check
                        
فحص سلامة بوابة API

                        
تحقق من السلامة التشغيلية وإصدار وطابع وقت الخادم لواجهة XPayr Gateway API v1.

                    

                    

                        GET /health
                        عام (بدون مفتاح)
                    

                

                                            

                    

                        xpayr_create_payment_session
                        
إنشاء جلسة دفع بالعملات الرقمية (الدفع المزدوج)

                        
أنشئ جلسة دفع غير وصائية بالعملات الرقمية تدعم دفع Web3 بنقرة واحدة، وتحويل رمز QR المباشر من المنصات، والروابط متعددة الشبكات، والروابط القابلة لإعادة الاستخدام لمدة عام، وإرسال الفواتير التلقائي بصيغة HTML عبر البريد الإلكتروني.

                    

                    

                        POST /payments
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_get_payment_session
                        
جلب تفاصيل جلسة الدفع

                        
استرجع التفاصيل الكاملة والبيانات الوصفية ومبالغ تقسيم التسوية ووضع الدفع ومُعرّف المعاملة على السلسلة لجلسة الدفع.

                    

                    

                        GET /payments/{session_id}
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_list_payment_sessions
                        
عرض جلسات دفع التاجر

                        
اعرض جلسات دفع العملات الرقمية للتاجر مع التصفية حسب الحالة والعملة والشبكة وتقسيم الصفحات.

                    

                    

                        GET /payments
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_get_public_payment_status
                        
استعلام الحالة العامة للدفع على السلسلة

                        
استعلم في الوقت الفعلي عن حالة الدفع العامة وقيمة tx_hash على السلسلة وعنوان محفظة المُرسِل وتأكيدات الكتل وطابع وقت paid_at دون الحاجة إلى مفتاح API.

                    

                    

                        GET /payments/{session_id}/status
                        عام (بدون مفتاح)
                    

                

                                            

                    

                        xpayr_apply_payment_coupon
                        
تطبيق قسيمة خصم عند الدفع

                        
تحقق من رمز قسيمة الخصم الترويجية الخاصة بالتاجر وطبّقه على جلسة دفع معلّقة نشطة.

                    

                    

                        POST /payments/{session_id}/coupon
                        عام (بدون مفتاح)
                    

                

                                            

                    

                        xpayr_get_merchant_profile
                        
جلب ملف التاجر ومحفظة التسوية

                        
استرجع ملف التاجر المُصادق عليه وعنوان محفظة التسوية ومعدل العمولة بالنقاط الأساسية (50 bps = 0.5%) ومفاتيح API النشطة.

                    

                    

                        GET /me
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_get_merchant_balance
                        
جلب حجم ورصيد التسوية متعدد الشبكات

                        
استعلم عن حجم التسوية غير الوصائية المؤكدة وعدد المعاملات ورسوم المنصة مجمّعةً حسب العملة وشبكة البلوكتشين.

                    

                    

                        GET /me/balance
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_get_supported_networks
                        
عرض الشبكات والسلاسل والرموز المدعومة

                        
اعرض جميع شبكات البلوكتشين النشطة على EVM وTRON وSolana وArc Mainnet/Testnet ومعرّفات السلاسل ونقاط نهاية RPC وعقود التقسيم والرموز المدعومة.

                    

                    

                        GET /me/networks
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_get_webhook_config
                        
جلب إعدادات وأحداث الويب هوك

                        
افحص عنوان URL لاستدعاء الويب هوك الخاص بالتاجر وسر التوقيع المقنّع HMAC-SHA256 وأحداث دورة حياة الدفع المشترك بها.

                    

                    

                        GET /webhooks
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_set_webhook_endpoint
                        
تهيئة نقطة نهاية الويب هوك عبر HTTPS

                        
قم بتهيئة أو تحديث عنوان URL لمستقبِل الويب هوك عبر HTTPS للتاجر وتوليد سر توقيع HMAC-SHA256 جديد بحجم 32 بايت.

                    

                    

                        POST /webhooks
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_send_test_webhook
                        
إرسال حدث ويب هوك تجريبي موقّع

                        
أرسل حمولة test.webhook موقّعة مع ترويسات HMAC-SHA256 للتحقق من صحة فحص توقيع الويب هوك لدى التاجر.

                    

                    

                        POST /webhooks/test
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_create_ai_agent
                        
إنشاء وكيل تجارة بالذكاء الاصطناعي خاضع للسياسات

                        
أنشئ هوية وكيل تجارة ذكاء اصطناعي جديدة يديرها التاجر مع بيانات اعتماد محددة النطاق وضوابط إنفاق قابلة للبرمجة.

                    

                    

                        POST /agents
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_list_ai_agents
                        
عرض وكلاء التجارة بالذكاء الاصطناعي للتاجر

                        
اعرض جميع وكلاء التجارة بالذكاء الاصطناعي الذين يديرهم التاجر إلى جانب حالتهم والمحافظ المعيّنة لهم وسياسات الإنفاق الخاصة بهم.

                    

                    

                        GET /agents
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_update_ai_agent_policy
                        
تحديث ضوابط إنفاق وكيل الذكاء الاصطناعي

                        
قم بتهيئة ضوابط سياسة الإنفاق لوكيل الذكاء الاصطناعي (الحد الأقصى بالدولار USD لكل معاملة، السقف اليومي، عتبة الموافقة التلقائية، الشبكات/الرموز المسموح بها).

                    

                    

                        PUT /agents/{agent_id}/policy
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_submit_agent_payment_intent
                        
إرسال نية دفع ذاتية لوكيل الذكاء الاصطناعي

                        
أرسل نية دفع ذاتية لوكيل الذكاء الاصطناعي يتم تقييمها لحظيًا وفق قواعد سياسة التاجر (approved أو pending_approval أو rejected).

                    

                    

                        POST /agent-intents
                        Bearer agk_test / agk_live
                    

                

                                            

                    

                        xpayr_list_agent_payment_intents
                        
عرض نوايا دفع وكلاء الذكاء الاصطناعي وسجلات التدقيق

                        
اعرض نوايا دفع وكلاء الذكاء الاصطناعي وقرارات تقييم السياسات وسجلات مسار التدقيق الخاصة بالتاجر.

                    

                    

                        GET /agent-intents
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_bridge_agent_intent_to_checkout
                        
ربط نية الوكيل المعتمدة بجلسة دفع

                        
حوّل نية دفع معتمدة لوكيل الذكاء الاصطناعي إلى جلسة دفع XPayr حية قابلة للتنفيذ مع رابط دفع مستضاف وتحقق على السلسلة.

                    

                    

                        POST /agent-intents/{intent_id}/bridge
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_approve_agent_intent
                        
الموافقة على نية وكيل الذكاء الاصطناعي المعلّقة (بإشراف بشري)

                        
وافق على نية دفع معلّقة لوكيل الذكاء الاصطناعي من قائمة انتظار موافقات التاجر واربطها بجلسة الدفع.

                    

                    

                        POST /agent-approvals/{intent_id}/approve
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_reject_agent_intent
                        
رفض نية وكيل الذكاء الاصطناعي المعلّقة

                        
ارفض نية دفع معلّقة لوكيل الذكاء الاصطناعي في قائمة انتظار موافقات التاجر مع تسجيل سبب للتدقيق.

                    

                    

                        POST /agent-approvals/{intent_id}/reject
                        Bearer sk_test / sk_live
                    

                

                                            

                    

                        xpayr_calculate_gateway_fee_and_split
                        
حاسبة تقسيم رسوم البوابة 0.5% وتسامح سحب المنصات

                        
احسب بشكل حتمي تقسيم رسوم بوابة XPayr الثابتة البالغة 0.5% (50 bps)، وصافي التسوية في محفظة التاجر، وتسامح سحب المنصات بنسبة 1% (بحد أقصى $0.50)، والوفورات مقارنةً بـ BitPay وCoinbase Commerce وStripe.

                    

                    

                        LOCAL /tools/crypto-payment-fee-calculator
                        دون اتصال / عام
                    

                

                    

    


    

        
الأسئلة الشائعة حول خادم XPayr MCP

                    

                هل يجب الاتصال عبر Streamable HTTP البعيد (/api/mcp) أم محلياً عبر npx (@xpayr/mcp-server)؟
                
يوفّر كلاهما جميع أدوات XPayr الـ 21 بنفس المخططات تماماً. لا يتطلب Streamable HTTP البعيد (https://xpayr.com/api/mcp) أي بيئة Node.js محلية ويعمل فوراً في الوكلاء السحابيين وn8n وبيئات التطوير الحديثة؛ بينما يعمل الأمر npx -y @xpayr/mcp-server@1.0.0 محلياً عبر stdio ويدعم تخصيص الوحدات (--suite flagship,checkout).

            

                    

                هل يمكن لوكلاء الذكاء الاصطناعي استدعاء أدوات MCP العامة بدون مفتاح API؟
                
نعم. تعمل أدوات الاكتشاف العام، وفحص سلامة البوابة (xpayr_health_check)، وحساب تقسيم الرسوم الحتمي بنسبة 0.5% (xpayr_calculate_gateway_fee_and_split)، والاستعلام عن حالة الجلسات العامة بدون بيانات اعتماد. أما أدوات إنشاء جلسات الدفع المصادقة ونوايا دفع الوكلاء فتستخدم مفتاح sk_test_ أو sk_live_ الخاص بك.

            

                    

                كيف تمنع ضوابط الإنفاق هلوسات نماذج LLM من التسبب في إنفاق مفرط؟
                
تفرض وكلاء التجارة الذكية في XPayr على جانب الخادم سقوفاً لكل معاملة، وميزانيات يومية متجددة، وعتبات اعتماد تلقائي، وقوائم بيضاء للشبكات والرموز، وطوابير اعتماد بشري (/agent-commerce) قبل تحرك أي أموال على السلسلة.

            

                    

                أين يُنشر خادم XPayr MCP ويتم توثيقه؟
                
يُنشر XPayr MCP على npm (@xpayr/mcp-server@1.0.0)، وسجل حاويات GitHub (ghcr.io/xpayrcom/xpayr-mcp-server)، وسجل MCP الرسمي، ومنصتَي Glama وSmithery، وهو موثّق عبر https://mcp.xpayr.com و/.well-known/mcp.json.