فوری آغاز
5 منٹ سے کم میں اپنے AI ایجنٹ سے ادائیگیاں شروع کروائیں۔
MCP سرور انسٹال کریں
npm کے ذریعے BananaCrystal MCP سرور گلوبلی انسٹال کریں۔
npm install -g @bananacrystal/mcp-serverاپنی API key حاصل کریں
اپنے اکاؤنٹ ڈیش بورڈ سے MCP API key بنائیں۔ سینڈ باکس keys 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 ٹولز
6 زمروں میں 40 تیار ادائیگی ٹولز۔ صرف پڑھنے والے آپریشنز ہمیشہ مفت ہیں۔
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_balanceریٹ API
REST کے ذریعے کرنسی ریٹ کے ایڈوانسڈ آپریشنز۔ rate دائرے والی API key ضروری ہے۔
MCP ٹول بمقابلہ ریٹ API: کیا فرق ہے؟
MCP سرور میں پہلے سے get_exchange_rate ایک read_only ٹول کے طور پر شامل ہے: آپ کا ایجنٹ کسی ایک کرنسی کا USD کے مقابلے میں خرید/فروخت ریٹ حاصل کرنے کے لیے اسے براہ راست کال کر سکتا ہے۔ یہ ایجنٹس کی زیادہ تر ضروریات پوری کرتا ہے۔
ریٹ API اس سے آگے جاتی ہے: کراس پیئر تبادلے، بڑی تعداد میں بیچ آپریشنز، تاریخی ٹائم سیریز ڈیٹا اور شماریاتی خلاصے۔ یہ براہ راست HTTP اینڈ پوائنٹس کے طور پر دستیاب ہیں جن کی تصدیق rate دائرے والی API key سے ہوتی ہے۔ اپنے اکاؤنٹ ڈیش بورڈ سے rate key بنائیں۔
تصدیق
تمام ریٹ API اینڈ پوائنٹس کے لیے x-api-key ہیڈر میں rate دائرے والی API key بھیجنا ضروری ہے۔ سینڈ باکس متبادل /mcp/sandbox/rate/* پر دستیاب ہیں اور آپ کی سینڈ باکس key (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
}سینڈ باکس ریٹ API
/mcp/rate/ کو /mcp/sandbox/rate/ سے بدلیں اور مقررہ فرضی ریٹس حاصل کرنے کے لیے اپنی سینڈ باکس key استعمال کریں۔ حقیقت سے قریب ٹیسٹنگ کے لیے تاریخی ڈیٹا ±2% فرق کے ساتھ بنایا جاتا ہے۔ کوئی اصل ایکسچینج ڈیٹا استعمال نہیں ہوتا۔
سینڈ باکس ماحول
پہلے سے موجود بیلنس کے ساتھ اور اصل رقم کے بغیر اپنی انٹیگریشن محفوظ طریقے سے ٹیسٹ کریں۔
سینڈ باکس کیا ہے؟
سینڈ باکس ایک مکمل طور پر الگ ٹیسٹ ماحول ہے جو پروڈکشن کی بالکل نقل ہے، وہی ٹولز، وہی API اور وہی جواب کا فارمیٹ۔ کوئی اصل رقم منتقل نہیں ہوتی۔ سینڈ باکس API keys bc_test_ سے شروع ہوتی ہیں اور Hedera testnet سے جڑتی ہیں۔
پہلے سے موجود بیلنس
ہر سینڈ باکس اکاؤنٹ ان بیلنسز کے ساتھ شروع ہوتا ہے۔ انہیں کسی بھی وقت بحال کرنے کے لیے 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 |
سینڈ باکس بمقابلہ لائیو
| خصوصیت | سینڈ باکس | لائیو |
|---|---|---|
| اصل رقم منتقل ہوتی ہے | نہیں: صرف فرضی | ہاں |
| OTP تصدیق | API جواب میں واپس آتا ہے | آپ کے ای میل پر بھیجا جاتا ہے |
| فیاٹ کے لیے KYC ضروری | نہیں | ہاں |
| خرچ کی حدیں نافذ | ہاں (قابل ترتیب) | ہاں |
| API key کا سابقہ | bc_test_... | bc_live_... |
| Hedera سیٹلمنٹ | Testnet | Mainnet |
| پہلے سے موجود بیلنس | ہاں (کسی بھی وقت ری سیٹ کریں) | نہیں |
| ریٹ کی حدیں | نرم | پلان کے مطابق |
سینڈ باکس میں OTP
سینڈ باکس موڈ میں OTP کوڈ ای میل کے بجائے براہ راست request_transfer_otp API جواب میں واپس آتا ہے۔ اس سے ای میل تک رسائی کے بغیر خودکار ٹیسٹنگ آسان ہو جاتی ہے۔
سینڈ باکس کنفیگریشن
{
"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 کو اپنے پسندیدہ AI ٹول یا فریم ورک سے جوڑیں۔
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "your_api_key_here"
}
}
}
}انوائرمنٹ ویری ایبلز
BANANACRYSTAL_API_KEYضروریآپ کی MCP API key۔ سینڈ باکس keys bc_test_ سے اور لائیو keys bc_live_ سے شروع ہوتی ہیں۔
ڈیفالٹ: N/A
BANANACRYSTAL_API_URLاختیاریMCP اینڈ پوائنٹ URL تبدیل کریں۔ ٹیسٹنگ کے لیے سینڈ باکس URL استعمال کریں۔
ڈیفالٹ: https://agentic.bananacrystal.com/mcp
DEBUGاختیاریدرخواست/جواب کی تفصیلی لاگنگ فعال کرنے کے لیے true پر سیٹ کریں۔
ڈیفالٹ: false
| ویری ایبل | ضروری | ڈیفالٹ | تفصیل |
|---|---|---|---|
BANANACRYSTAL_API_KEY | ضروری | N/A | آپ کی MCP API key۔ سینڈ باکس keys bc_test_ سے اور لائیو keys bc_live_ سے شروع ہوتی ہیں۔ |
BANANACRYSTAL_API_URL | اختیاری | https://agentic.bananacrystal.com/mcp | MCP اینڈ پوائنٹ URL تبدیل کریں۔ ٹیسٹنگ کے لیے سینڈ باکس URL استعمال کریں۔ |
DEBUG | اختیاری | false | درخواست/جواب کی تفصیلی لاگنگ فعال کرنے کے لیے true پر سیٹ کریں۔ |
فریم ورک انٹیگریشنز
سب سے مقبول AI ایجنٹ فریم ورکس کے لیے چلانے کے لیے تیار مثالیں۔
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 مطابقت رکھنے والا فریم ورک کام کرتا ہے۔ اگر آپ کا فریم ورک HTTP پر مبنی MCP سرورز سپورٹ کرتا ہے تو اسے اپنی API key کو Bearer ٹوکن کے طور پر استعمال کرتے ہوئے https://agentic.bananacrystal.com/mcp پر سیٹ کریں۔
سیکیورٹی آرکیٹیکچر
تحفظ کی متعدد تہیں تاکہ آپ کا ایجنٹ صرف وہی کر سکے جس کی آپ واضح اجازت دیں۔
API key کے دائرے
ہر API key کے واضح اجازتی دائرے ہوتے ہیں۔ ایجنٹ صرف آپ کے دیے گئے دائروں میں ہی آپریشنز کر سکتا ہے۔
خرچ کی حدیں
ہر API key کے لیے فی ٹرانزیکشن سخت زیادہ سے زیادہ حد اور 24 گھنٹے کی رولنگ روزانہ حد مقرر کریں۔ یہ انفراسٹرکچر کی سطح پر نافذ ہوتی ہیں۔
OTP تصدیق
ہر ٹوکن ٹرانسفر کے لیے آپ کے رجسٹرڈ ای میل پر بھیجا گیا 6 ہندسوں کا OTP ضروری ہے۔ آپ کے کوڈ دیے بغیر ایجنٹ ٹرانسفر مکمل نہیں کر سکتا۔
ریٹ کی حد بندی
فی key، فی منٹ کی حدیں بے قابو ایجنٹس کو API پر بوجھ ڈالنے سے روکتی ہیں۔ حدیں آپ کے پلان کے درجے کے ساتھ بڑھتی ہیں۔
ناقابل تبدیل آڈٹ ٹریل
ہر ٹول کال Hedera کی کنسینسس لیئر پر درج ہوتی ہے۔ یہ ٹائم اسٹیمپ شدہ، ناقابل تبدیل اور آن چین عوامی طور پر قابل تصدیق ہیں۔ مکمل آڈٹ ہسٹری get_transaction_history کے ذریعے دستیاب ہے۔
ایجنٹ منظوری کا عمل
ایجنٹ سے ایجنٹ ٹرانزیکشنز کے لیے عمل درآمد سے پہلے انسانی ای میل منظوری لازمی کی جا سکتی ہے۔ require_human_approval ترتیب دینے کے لیے update_my_agent_settings استعمال کریں۔
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 | سیٹلمنٹ پر پلیٹ فارم فیس |
پلانز
مفت
تمام صرف پڑھنے والے ٹولز ہمیشہ مفت ہیں۔ ریٹس یا بیلنس چیک کرنے کے لیے اکاؤنٹ کی ضرورت نہیں۔
- تمام صرف پڑھنے والے ٹولز ہمیشہ کے لیے مفت
- سینڈ باکس ماحول شامل
- get_balances، get_exchange_rate اور 22 مزید
- کمیونٹی سپورٹ
- Hedera testnet سیٹلمنٹ
استعمال کے مطابق ادائیگی
جیسے جیسے آپ بڑھیں، اسکیل کریں۔ صرف اتنی ادائیگی کریں جتنا استعمال کریں۔
- لامحدود API کالز
- ٹرانسفرز پر 0.3%
- سواپس پر 0.5%
- فیاٹ ریلز (طریقے کے مطابق مختلف)
- ای میل + ترجیحی سپورٹ
- Hedera mainnet سیٹلمنٹ
- مکمل آڈٹ ٹریل
انٹرپرائز
حجم پر رعایتیں، SLAs اور مخصوص انفراسٹرکچر۔
- حسب ضرورت فیس کے درجے
- مخصوص MCP اینڈ پوائنٹ
- SLA کی ضمانتیں
- حسب ضرورت خرچ کی حدیں
- مخصوص سپورٹ
- آن پریمائز آپشن
عام سوالات
BananaCrystal اور MCP سرور کے بارے میں عام سوالات۔
اپنے ایجنٹ کو والیٹ دینے کے لیے تیار ہیں؟
اپنی API key بنائیں اور 5 منٹ سے کم میں اپنے ایجنٹ کو 40 ادائیگی ٹولز سے جوڑیں۔ صرف پڑھنے والے ٹولز ہمیشہ مفت ہیں۔
API key حاصل کریں