البدء السريع
اجعل وكيل الذكاء الاصطناعي يجري المدفوعات في أقل من 5 دقائق.
ثبّت خادم MCP
ثبّت خادم MCP من BananaCrystal على مستوى النظام عبر npm.
npm install -g @bananacrystal/mcp-serverاحصل على API key
أنشئ MCP API key من لوحة تحكم حسابك. مفاتيح sandbox تبدأ بـ bc_test_ وهي مجانية.
bc_test_...اضبط Claude Desktop
أضف BananaCrystal إلى ملف إعدادات Claude Desktop.
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here"
}
}
}
}اسأل وكيلك
أصبح لدى وكيلك الآن 40 أداة دفع. جرّب هذه الطلبات:
أدوات MCP
40 أداة دفع جاهزة للإنتاج ضمن 6 فئات. عمليات القراءة فقط مجانية دائمًا.
pingget_server_infoechoget_my_profileget_balancesget_exchange_ratelist_supported_currencieslist_available_tokensget_transaction_historyget_my_limitsestimate_swap_feesget_agent_configcheck_approval_statusget_kyc_statusget_deposit_statusget_withdrawal_statusget_escrow_balancesget_escrow_historylist_offersget_offerget_my_offerslist_tradesget_tradeget_my_tradesrequest_transfer_otptransfer_tokensswap_currencyinitiate_kycinitiate_depositrequest_withdrawalcreate_offerupdate_offerdelist_offerdelete_offerengage_offercancel_traderequest_agent_transactionexecute_approved_transactionupdate_my_agent_settingsreset_sandbox_balanceRate API
عمليات متقدمة لأسعار العملات عبر REST. تتطلب API key بنطاق rate.
أداة MCP أم Rate API: ما الفرق؟
يتضمن خادم MCP أداة get_exchange_rate كأداة read_only: يستطيع وكيلك استدعاءها مباشرة لجلب سعر الشراء والبيع لعملة واحدة مقابل USD. وهذا يغطي معظم استخدامات الوكلاء.
يقدم Rate API المزيد: تحويلات بين أي زوج عملات، وعمليات مجمعة، وبيانات تاريخية متسلسلة، وملخصات إحصائية. تتوفر هذه الخدمات كنقاط HTTP مباشرة موثّقة بـ API key بنطاق rate. أنشئ مفتاح rate من لوحة تحكم حسابك.
المصادقة
تتطلب جميع نقاط Rate API مفتاح API key بنطاق rate يُرسل في الترويسة x-api-key. نظائرها في sandbox متاحة على /mcp/sandbox/rate/* وتستخدم مفتاح sandbox (bc_test_...) مع أسعار تجريبية ثابتة لاختبارات قابلة للتكرار.
/mcp/rate/currenciesعرض جميع العملات المدعومة
مثال على الطلب
curl "https://agentic.bananacrystal.com/mcp/rate/currencies" \
-H "x-api-key: bc_live_your_rate_key_here"مثال على الاستجابة
{
"count": 11,
"currencies": ["EGP", "EUR", "GBP", "GHS", "KES", "NGN", "TZS", "UGX", "USD", "XOF", "ZAR"]
}/mcp/rate/currentجلب سعر الصرف الحالي بين عملتين
المعاملات
| الاسم | مطلوب | الوصف |
|---|---|---|
from | مطلوب | رمز العملة المصدر (مثل USD) |
to | مطلوب | رمز العملة الهدف (مثل NGN) |
مثال على الطلب
curl "https://agentic.bananacrystal.com/mcp/rate/current?from=USD&to=NGN" \
-H "x-api-key: bc_live_your_rate_key_here"مثال على الاستجابة
{
"from": "USD",
"to": "NGN",
"rate": 1584.75,
"buyRate": 1590.0,
"sellRate": 1579.5,
"timestamp": "2026-04-30T10:22:00.000Z"
}/mcp/rate/convertتحويل مبلغ من عملة إلى أخرى
المعاملات
| الاسم | مطلوب | الوصف |
|---|---|---|
from | مطلوب | رمز العملة المصدر |
to | مطلوب | رمز العملة الهدف |
amount | مطلوب | المبلغ المراد تحويله (رقم) |
مثال على الطلب
curl "https://agentic.bananacrystal.com/mcp/rate/convert?from=USD&to=NGN&amount=100" \
-H "x-api-key: bc_live_your_rate_key_here"مثال على الاستجابة
{
"from": "USD",
"to": "NGN",
"amount": 100,
"converted": 158475.0,
"rate": 1584.75,
"timestamp": "2026-04-30T10:22:00.000Z"
}/mcp/rate/batch-convertتحويل عدة مبالغ في طلب واحد (100 كحد أقصى)
مثال على الطلب
curl -X POST "https://agentic.bananacrystal.com/mcp/rate/batch-convert" \
-H "x-api-key: bc_live_your_rate_key_here" \
-H "Content-Type: application/json" \
-d '{
"conversions": [
{ "from": "USD", "to": "NGN", "amount": 100 },
{ "from": "USD", "to": "GHS", "amount": 50 },
{ "from": "EUR", "to": "GBP", "amount": 200 }
]
}'مثال على الاستجابة
[
{ "from": "USD", "to": "NGN", "amount": 100, "converted": 158475.0, "rate": 1584.75, "timestamp": "..." },
{ "from": "USD", "to": "GHS", "amount": 50, "converted": 800.0, "rate": 16.0, "timestamp": "..." },
{ "from": "EUR", "to": "GBP", "amount": 200, "converted": 172.0, "rate": 0.86, "timestamp": "..." }
]/mcp/rate/historyجلب أسعار الصرف التاريخية لزوج عملات
المعاملات
| الاسم | مطلوب | الوصف |
|---|---|---|
from | مطلوب | رمز العملة المصدر |
to | مطلوب | رمز العملة الهدف |
startDate | مطلوب | تاريخ البداية (ISO 8601، مثل 2026-04-01) |
endDate | مطلوب | تاريخ النهاية (ISO 8601، مثل 2026-04-30) |
مثال على الطلب
curl "https://agentic.bananacrystal.com/mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30" \
-H "x-api-key: bc_live_your_rate_key_here"مثال على الاستجابة
[
{ "date": "2026-04-01T00:00:00.000Z", "from": "USD", "to": "NGN", "buyRate": 1580.0, "sellRate": 1575.0, "midRate": 1577.5 },
{ "date": "2026-04-02T00:00:00.000Z", "from": "USD", "to": "NGN", "buyRate": 1582.0, "sellRate": 1577.0, "midRate": 1579.5 }
]/mcp/rate/statsجلب إحصاءات السعر (الأعلى والأدنى والمتوسط والأحدث) خلال فترة
المعاملات
| الاسم | مطلوب | الوصف |
|---|---|---|
from | مطلوب | رمز العملة المصدر |
to | مطلوب | رمز العملة الهدف |
days | اختياري | الفترة بالأيام، من 1 إلى 365 (الافتراضي: 30) |
مثال على الطلب
curl "https://agentic.bananacrystal.com/mcp/rate/stats?from=USD&to=NGN&days=30" \
-H "x-api-key: bc_live_your_rate_key_here"مثال على الاستجابة
{
"from": "USD",
"to": "NGN",
"period": "30d",
"high": 1598.0,
"low": 1560.0,
"avg": 1581.4,
"latest": 1584.75,
"count": 30
}Rate API في Sandbox
استبدل /mcp/rate/ بـ /mcp/sandbox/rate/ واستخدم مفتاح sandbox للحصول على أسعار تجريبية ثابتة. تُولَّد البيانات التاريخية بتفاوت ±2% لاختبار واقعي. لا تُستخدم بيانات صرف حقيقية.
بيئة Sandbox
اختبر تكاملك بأمان بأرصدة معبأة مسبقًا ومن دون أموال حقيقية.
ما هي sandbox؟
sandbox بيئة اختبار معزولة تمامًا تطابق بيئة الإنتاج: الأدوات نفسها، وAPI نفسه، وصيغة الاستجابة نفسها. لا تنتقل أي أموال حقيقية. تبدأ مفاتيح sandbox بـ bc_test_ وتتصل بشبكة Hedera التجريبية.
أرصدة معبأة مسبقًا
يبدأ كل حساب sandbox بهذه الأرصدة. استخدم reset_sandbox_balance لاستعادتها في أي وقت.
| الرمز | المبلغ | العملة |
|---|---|---|
USDb | 10,000 | USD |
NGNb | 5,000,000 | NGN |
GHSb | 50,000 | GHS |
KESb | 1,000,000 | KES |
ZARb | 150,000 | ZAR |
Sandbox مقابل البيئة الحية
| الميزة | Sandbox | الحية |
|---|---|---|
| انتقال أموال حقيقية | لا: محاكاة فقط | نعم |
| التحقق عبر OTP | يُعاد في استجابة API | يُرسل إلى بريدك الإلكتروني |
| KYC مطلوب للعملات الورقية | لا | نعم |
| تطبيق حدود الإنفاق | نعم (قابلة للضبط) | نعم |
| بادئة API key | bc_test_... | bc_live_... |
| التسوية على Hedera | الشبكة التجريبية | الشبكة الرئيسية |
| أرصدة معبأة مسبقًا | نعم (إعادة تعيين في أي وقت) | لا |
| حدود معدل الطلبات | مخففة | حسب الخطة |
OTP في sandbox
في وضع sandbox، يُعاد رمز OTP مباشرة في استجابة request_transfer_otp بدل إرساله عبر البريد الإلكتروني. هذا يسهّل الاختبار الآلي دون الحاجة إلى الوصول إلى البريد.
إعداد sandbox
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here",
"BANANACRYSTAL_API_URL": "https://agentic.bananacrystal.com/mcp/sandbox"
}
}
}
}الإعداد
اربط BananaCrystal بأداة أو إطار الذكاء الاصطناعي الذي تفضله.
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "your_api_key_here"
}
}
}
}متغيرات البيئة
BANANACRYSTAL_API_KEYمطلوبمفتاح MCP API key الخاص بك. مفاتيح sandbox تبدأ بـ bc_test_ والمفاتيح الحية بـ bc_live_.
الافتراضي: N/A
BANANACRYSTAL_API_URLاختياريتجاوز عنوان نقطة MCP. استخدم عنوان sandbox للاختبار.
الافتراضي: https://agentic.bananacrystal.com/mcp
DEBUGاختيارياضبطه على true لتفعيل سجل مفصل للطلبات والاستجابات.
الافتراضي: false
| المتغير | مطلوب | الافتراضي | الوصف |
|---|---|---|---|
BANANACRYSTAL_API_KEY | مطلوب | N/A | مفتاح MCP API key الخاص بك. مفاتيح sandbox تبدأ بـ bc_test_ والمفاتيح الحية بـ bc_live_. |
BANANACRYSTAL_API_URL | اختياري | https://agentic.bananacrystal.com/mcp | تجاوز عنوان نقطة MCP. استخدم عنوان sandbox للاختبار. |
DEBUG | اختياري | false | اضبطه على true لتفعيل سجل مفصل للطلبات والاستجابات. |
التكامل مع أطر العمل
أمثلة جاهزة للتشغيل لأشهر أطر عمل وكلاء الذكاء الاصطناعي.
import asyncio
from langchain_mcp_adapters.client import MultiServerMCPClient
from langchain.agents import create_tool_calling_agent, AgentExecutor
from langchain_anthropic import ChatAnthropic
from langchain_core.prompts import ChatPromptTemplate
async def main():
# Connect to BananaCrystal MCP server
client = MultiServerMCPClient({
"bananacrystal": {
"url": "https://agentic.bananacrystal.com/mcp",
"transport": "streamable_http",
"headers": {
"Authorization": "Bearer your_api_key_here"
}
}
})
# Get all 40 payment tools
tools = await client.get_tools()
# Create an agent with payment capabilities
llm = ChatAnthropic(model="claude-3-5-sonnet-20241022")
prompt = ChatPromptTemplate.from_messages([
("system", "You are a payment agent. Use the BananaCrystal tools to help users manage their finances."),
("human", "{input}"),
("placeholder", "{agent_scratchpad}"),
])
agent = create_tool_calling_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
# Run the agent
result = await executor.ainvoke({
"input": "What is my current USDb balance?"
})
print(result["output"])
asyncio.run(main())يعمل أي إطار متوافق مع MCP. إذا كان إطارك يدعم خوادم MCP عبر HTTP، فوجّهه إلى https://agentic.bananacrystal.com/mcp مع API key كـ Bearer token.
بنية الأمان
طبقات حماية متعددة حتى لا يفعل وكيلك إلا ما تأذن به صراحةً.
نطاقات API Key
لكل API key نطاقات صلاحيات محددة. لا يستطيع الوكيل تنفيذ عمليات خارج النطاقات التي تمنحها.
حدود الإنفاق
حدد سقفًا صارمًا لكل معاملة وسقفًا يوميًا متجددًا كل 24 ساعة لكل API key. تُطبَّق هذه الحدود على مستوى البنية التحتية.
التحقق عبر OTP
يتطلب كل تحويل للرموز رمز OTP من 6 أرقام يُرسل إلى بريدك المسجل. لا يستطيع الوكيل إتمام التحويل دون أن تقدم هذا الرمز.
تحديد معدل الطلبات
حدود لكل مفتاح وكل دقيقة تمنع الوكلاء الخارجين عن السيطرة من إغراق API بالطلبات. تزداد الحدود حسب مستوى خطتك.
سجل تدقيق غير قابل للتعديل
يُكتب كل استدعاء أداة في طبقة الإجماع على Hedera. كل استدعاء مختوم بالوقت، ومحمي من التلاعب، ويمكن التحقق منه علنًا على السلسلة. سجل التدقيق الكامل متاح عبر get_transaction_history.
مسار موافقة الوكيل
يمكن أن تتطلب المعاملات بين الوكلاء موافقة بشرية عبر البريد الإلكتروني قبل التنفيذ. استخدم update_my_agent_settings لضبط require_human_approval.
نطاقات API Key
التحقق من الأرصدة والأسعار والسجل والحدود دون نقل أي أموال
إرسال الرموز إلى حسابات أخرى (يتطلب OTP)
التبديل بين العملات المستقرة
الإيداع والسحب بالعملات الورقية (يتطلب KYC)
إنشاء عروض وصفقات سوق التنبؤات وإدارتها
الوصول إلى أسعار صرف العملات والبيانات التاريخية والتحويلات وإحصاءات الأسعار
| النطاق | ما يسمح به |
|---|---|
| read_only | التحقق من الأرصدة والأسعار والسجل والحدود دون نقل أي أموال |
| transfer | إرسال الرموز إلى حسابات أخرى (يتطلب OTP) |
| swap | التبديل بين العملات المستقرة |
| fiat | الإيداع والسحب بالعملات الورقية (يتطلب KYC) |
| offers | إنشاء عروض وصفقات سوق التنبؤات وإدارتها |
| rate | الوصول إلى أسعار صرف العملات والبيانات التاريخية والتحويلات وإحصاءات الأسعار |
الأسعار
عمليات القراءة فقط مجانية دائمًا. ادفع فقط مقابل المعاملات التي تنقل قيمة.
رسوم العمليات
عمليات القراءة فقط
get_balances, get_exchange_rate, list_trades, …
تحويلات الرموز
transfer_tokens
تبديل العملات
swap_currency
الإيداع بالعملات الورقية
initiate_deposit
السحب بالعملات الورقية
request_withdrawal
سوق التنبؤات
create_offer, engage_offer
| العملية | الأدوات | الرسوم |
|---|---|---|
| عمليات القراءة فقط | get_balances, get_exchange_rate, list_trades, … | مجانًا |
| تحويلات الرموز | transfer_tokens | 0.3% |
| تبديل العملات | swap_currency | 0.5% |
| الإيداع بالعملات الورقية | initiate_deposit | تختلف حسب القناة |
| السحب بالعملات الورقية | request_withdrawal | تختلف حسب القناة |
| سوق التنبؤات | create_offer, engage_offer | رسوم المنصة عند التسوية |
الخطط
مجانية
جميع أدوات القراءة فقط مجانية دائمًا. لا حاجة إلى حساب للتحقق من الأسعار أو الأرصدة.
- جميع أدوات القراءة فقط مجانية للأبد
- بيئة sandbox مشمولة
- get_balances وget_exchange_rate و22 أداة أخرى
- دعم المجتمع
- التسوية على شبكة Hedera التجريبية
الدفع حسب الاستخدام
توسّع مع نموك. ادفع فقط مقابل ما تستخدمه.
- استدعاءات API غير محدودة
- 0.3% على التحويلات
- 0.5% على التبديل
- قنوات العملات الورقية (تختلف حسب الطريقة)
- دعم عبر البريد الإلكتروني ودعم ذو أولوية
- التسوية على شبكة Hedera الرئيسية
- سجل تدقيق كامل
المؤسسات
خصومات على الحجم، واتفاقيات مستوى الخدمة، وبنية تحتية مخصصة.
- مستويات رسوم مخصصة
- نقطة MCP مخصصة
- ضمانات اتفاقية مستوى الخدمة
- حدود إنفاق مخصصة
- دعم مخصص
- خيار التشغيل في مقرك
الأسئلة الشائعة
أسئلة شائعة عن BananaCrystal وخادم MCP.
هل أنت مستعد لمنح وكيلك محفظة؟
أنشئ API key واربط وكيلك بـ 40 أداة دفع في أقل من 5 دقائق. أدوات القراءة فقط مجانية دائمًا.
احصل على API key