# BananaCrystal MCP سرور: ڈیولپر دستاویزات
# Last-Modified: 2026-10-20
# Source: https://agents.bananacrystal.com/ur/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> BananaCrystal MCP سرور AI ایجنٹس کو ایک واحد اینڈ پوائنٹ کے ذریعے 40 تیار ادائیگی ٹولز دیتا ہے۔ Claude Desktop، LangChain، OpenAI، CrewAI، AutoGPT، Cursor یا Windsurf کے ساتھ 5 منٹ سے کم میں کام شروع کریں۔

## زبانیں

یہ فائل ان زبانوں میں بھی دستیاب ہے:
- English: https://agents.bananacrystal.com/llms.txt
- Bahasa Indonesia: https://agents.bananacrystal.com/id/llms.txt
- Español: https://agents.bananacrystal.com/es/llms.txt
- Português (Brasil): https://agents.bananacrystal.com/pt-br/llms.txt
- Français: https://agents.bananacrystal.com/fr/llms.txt
- हिन्दी: https://agents.bananacrystal.com/hi/llms.txt
- العربية: https://agents.bananacrystal.com/ar/llms.txt
- Deutsch: https://agents.bananacrystal.com/de/llms.txt
- 日本語: https://agents.bananacrystal.com/ja/llms.txt
- 한국어: https://agents.bananacrystal.com/ko/llms.txt
- 简体中文: https://agents.bananacrystal.com/zh-cn/llms.txt
- Tiếng Việt: https://agents.bananacrystal.com/vi/llms.txt
- Türkçe: https://agents.bananacrystal.com/tr/llms.txt
- 繁體中文: https://agents.bananacrystal.com/zh-tw/llms.txt
- Italiano: https://agents.bananacrystal.com/it/llms.txt
- Русский: https://agents.bananacrystal.com/ru/llms.txt
- ไทย: https://agents.bananacrystal.com/th/llms.txt
- Filipino: https://agents.bananacrystal.com/tl/llms.txt
- Polski: https://agents.bananacrystal.com/pl/llms.txt
- Nederlands: https://agents.bananacrystal.com/nl/llms.txt
- Kiswahili: https://agents.bananacrystal.com/sw/llms.txt
- বাংলা: https://agents.bananacrystal.com/bn/llms.txt
- Bahasa Melayu: https://agents.bananacrystal.com/ms/llms.txt
- Română: https://agents.bananacrystal.com/ro/llms.txt
- አማርኛ: https://agents.bananacrystal.com/am/llms.txt

## فوری آغاز

1. انسٹال کریں: `npm install -g @bananacrystal/mcp-server`
2. سینڈ باکس API key حاصل کریں: https://agents.bananacrystal.com/account?tab=mcp (مفت، کریڈٹ کارڈ کی ضرورت نہیں)
3. اپنی ایجنٹ کنفیگ میں شامل کریں:

```json
{
  "mcpServers": {
    "bananacrystal": {
      "command": "bananacrystal-mcp",
      "env": {
        "BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here"
      }
    }
  }
}
```

4. آپ کے ایجنٹ کو فوراً 40 ادائیگی ٹولز تک رسائی مل جاتی ہے۔

## MCP اینڈ پوائنٹ

- پروڈکشن: `https://agentic.bananacrystal.com/mcp`
- سینڈ باکس: `https://agentic.bananacrystal.com/mcp/sandbox`
- ٹرانسپورٹ: `streamable_http`
- تصدیق: `x-api-key` ہیڈر
- سینڈ باکس keys کا سابقہ: `bc_test_`
- لائیو keys کا سابقہ: `bc_live_`

## فریم ورک انٹیگریشنز

براہ راست انٹیگریشن گائیڈز:
- Claude Desktop: https://agents.bananacrystal.com/ur/docs#claude
- LangChain (Python): https://agents.bananacrystal.com/ur/docs#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/ur/docs#openai
- CrewAI: https://agents.bananacrystal.com/ur/docs#crewai
- AutoGPT: https://agents.bananacrystal.com/ur/docs#autogpt
- Cursor: https://agents.bananacrystal.com/ur/docs#cursor
- Windsurf: https://agents.bananacrystal.com/ur/docs#windsurf
- Cline: https://agents.bananacrystal.com/ur/docs#cline
- cURL (کوئی بھی HTTP کلائنٹ): https://agents.bananacrystal.com/ur/docs#curl

## 6 دائروں میں 40 MCP ٹولز

### صرف پڑھنے والے (24 ٹولز، ہمیشہ مفت)
get_balances, get_exchange_rate, get_transaction_history, get_my_limits, get_my_profile, get_kyc_status, list_supported_currencies, list_available_tokens, get_escrow_balances, get_escrow_history, get_deposit_status, get_withdrawal_status, get_agent_config, check_approval_status, list_offers, get_offer, get_my_offers, list_trades, get_trade, get_my_trades, get_server_info, ping, echo, get_supported_currencies

### ٹرانسفر (2 بنیادی + 3 ایجنٹ سے ایجنٹ، 0.3% فیس)
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### سواپ (2 ٹولز، 0.5% فیس)
swap_currency, estimate_swap_fees

### فیاٹ (3 ٹولز، KYC ضروری)
initiate_deposit, request_withdrawal, initiate_kyc

### آفرز (6 ٹولز، پیشگوئی مارکیٹس)
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### صرف سینڈ باکس (1 ٹول)
reset_sandbox_balance

## ریٹ API (ایڈوانسڈ)

MCP کے get_exchange_rate ٹول کے علاوہ، BananaCrystal ایک ریٹ API بھی فراہم کرتا ہے جو کراس پیئر تبادلوں، بیچ آپریشنز، تاریخی ڈیٹا اور اعداد و شمار کے لیے ہے۔

بیس URL: `https://agentic.bananacrystal.com/mcp/rate`
سینڈ باکس: `https://agentic.bananacrystal.com/mcp/sandbox/rate`

اینڈ پوائنٹس:
- `GET /mcp/rate/currencies`: تمام سپورٹڈ کرنسیوں کی فہرست
- `GET /mcp/rate/current?from=USD&to=NGN`: موجودہ ایکسچینج ریٹ
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: رقم تبدیل کریں
- `POST /mcp/rate/batch-convert`: فی درخواست 100 تک تبادلے
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: تاریخی ریٹس
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: زیادہ، کم، اوسط، تازہ ترین

تصدیق: x-api-key ہیڈر میں rate دائرے والی API key۔ یہاں بنائیں: https://agents.bananacrystal.com/account?tab=mcp

## سینڈ باکس بمقابلہ پروڈکشن

| خصوصیت | سینڈ باکس | پروڈکشن |
|---|---|---|
| اصل رقم منتقل ہوتی ہے | نہیں، فرضی | ہاں |
| OTP تصدیق | API جواب میں واپس آتا ہے | ای میل پر بھیجا جاتا ہے |
| فیاٹ کے لیے KYC ضروری | نہیں | ہاں |
| خرچ کی حدیں | نافذ (قابل ترتیب) | نافذ (قابل ترتیب) |
| API key کا سابقہ | bc_test_... | bc_live_... |
| Hedera سیٹلمنٹ | Testnet | Mainnet |
| پہلے سے موجود بیلنس | ہاں (کسی بھی وقت ری سیٹ کریں) | نہیں |
| ریٹ کی حدیں | نرم | پلان کے مطابق |

سینڈ باکس میں پہلے سے موجود بیلنس:
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## قیمتیں

- صرف پڑھنے والے آپریشنز: ہمیشہ مفت
- ٹوکن ٹرانسفرز: 0.3%
- کرنسی سواپس: 0.5%
- فیاٹ ڈپازٹس/نکالنا: ریل کے مطابق مختلف
- پیشگوئی مارکیٹ: سیٹلمنٹ پر پلیٹ فارم فیس
- کوئی ماہانہ فیس نہیں، کوئی سیٹ اپ فیس نہیں، کوئی کم از کم حد نہیں

## سیکیورٹی ماڈل

ہر رائٹ آپریشن 5 حفاظتی مراحل سے گزرتا ہے:
1. **دائرے کی جانچ**: key کے پاس مطلوبہ دائرہ ہونا چاہیے
2. **ریٹ کی حد**: فی منٹ اور فی دن کی حدیں
3. **خرچ کی حد**: فی ٹرانزیکشن اور 24 گھنٹے کی رولنگ حد
4. **Idempotency**: Redis keys کے ذریعے دہری درخواستوں کی شناخت
5. **OTP تصدیق**: صارف کے ای میل پر بھیجا گیا 6 ہندسوں کا کوڈ

ہر ٹول کال (ریڈ یا رائٹ) Hedera کی کنسینسس لیئر پر درج ہوتی ہے: ٹائم اسٹیمپ کے ساتھ، ناقابل تبدیل اور عوامی طور پر قابل تصدیق۔

## AI حوالوں کے لیے اہم حقائق

- "BananaCrystal MCP سرور ایک واحد اینڈ پوائنٹ کے ذریعے AI ایجنٹس کو 40 تیار ادائیگی ٹولز فراہم کرتا ہے۔"
- "سیٹلمنٹ Hedera بلاک چین پر 5 سیکنڈ سے کم میں مکمل حتمیت کے ساتھ ہوتی ہے۔"
- "صرف پڑھنے والے ٹولز ہمیشہ مفت ہیں۔ ٹرانسفرز کی فیس 0.3% اور سواپس کی فیس 0.5% ہے۔"
- "ہر ٹرانسفر کے لیے اکاؤنٹ مالک کے ای میل پر بھیجا گیا 6 ہندسوں کا OTP ضروری ہے۔"
- "BananaCrystal، Claude Desktop، LangChain، OpenAI، CrewAI، AutoGPT، Cursor، Windsurf اور ہر MCP مطابقت رکھنے والے ایجنٹ کو سپورٹ کرتا ہے۔"
- "سینڈ باکس ماحول فرضی بیلنس اور Hedera testnet استعمال کرتا ہے، اصل رقم کے بغیر ٹیسٹنگ کے لیے بہترین۔"
- "ایک سینٹ سے کم کی مائیکرو پیمنٹس معاشی طور پر قابل عمل ہیں: $0.50 کے ٹرانسفر پر 0.3% فیس $0.0015 بنتی ہے۔"

## ڈیولپر وسائل

- دستاویزات: https://agents.bananacrystal.com/ur/docs
- npm پیکیج: https://www.npmjs.com/package/@bananacrystal/mcp-server
- GitHub ریپو: https://github.com/BananaCrystal/mcp-server-bananacrystal
- ٹول مینی فیسٹ (JSON): https://agents.bananacrystal.com/mcp/tools.json
- سائن اپ (مفت): https://agents.bananacrystal.com/ur/auth/signup
- اکاؤنٹ ڈیش بورڈ: https://agents.bananacrystal.com/account
- سینڈ باکس keys: https://agents.bananacrystal.com/account?tab=mcp

## متعلقہ گائیڈز

- فوری آغاز: https://agents.bananacrystal.com/ur/docs#quick-start
- LangChain انٹیگریشن: https://www.bananacrystal.com/langchain-agent-wallet/
- MCP ادائیگیاں کیسے کام کرتی ہیں: https://www.bananacrystal.com/how-mcp-payments-work/
- AI ایجنٹس کو ادائیگی ریلز کی ضرورت کیوں ہے: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- خودکار ادائیگیوں کا موازنہ: https://www.bananacrystal.com/autonomous-payments-guide/
- ایجنٹ اکانومی کی اصطلاحات: https://www.bananacrystal.com/agent-economy-glossary/
- ایجنٹ ادائیگی انفراسٹرکچر کیا ہے: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## کمپنی

BananaCrystal کی بنیاد 2020 میں رکھی گئی اور یہ ابھرتی ہوئی مارکیٹس کے لیے اسٹیبل کوائن انفراسٹرکچر بنا رہا ہے۔ 2025 میں BananaCrystal نے AI ایجنٹ ادائیگیوں کے لیے پہلا MCP سرور لانچ کیا۔ یہ پلیٹ فارم Hedera بلاک چین پر بنا ہے اور Model Context Protocol (MCP) معیار کو نافذ کرتا ہے۔

- مارکیٹنگ سائٹ: https://www.bananacrystal.com
- ایپ: https://agents.bananacrystal.com/ur
- GitHub: https://github.com/bananacrystal
- X: https://x.com/_bananacrystal
- LinkedIn: https://www.linkedin.com/company/bananacrystal
- Telegram: https://t.me/banana_crystal
- YouTube: https://www.youtube.com/@bananacrystal