# Pelayan MCP BananaCrystal: Dokumentasi Pembangun
# Last-Modified: 2026-10-20
# Source: https://agents.bananacrystal.com/ms/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> Pelayan MCP BananaCrystal memberikan ejen AI 40 alat pembayaran sedia produksi melalui satu endpoint. Mula beroperasi dalam masa kurang daripada 5 minit dengan Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor atau Windsurf.

## Bahasa

Fail ini juga tersedia dalam:
- 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
- اردو: https://agents.bananacrystal.com/ur/llms.txt
- Kiswahili: https://agents.bananacrystal.com/sw/llms.txt
- বাংলা: https://agents.bananacrystal.com/bn/llms.txt
- Română: https://agents.bananacrystal.com/ro/llms.txt
- አማርኛ: https://agents.bananacrystal.com/am/llms.txt

## Mula Pantas

1. Pasang: `npm install -g @bananacrystal/mcp-server`
2. Dapatkan kunci API sandbox: https://agents.bananacrystal.com/account?tab=mcp (percuma, tanpa kad kredit)
3. Tambah pada konfigurasi ejen anda:

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

4. Ejen anda terus mendapat akses kepada 40 alat pembayaran.

## Endpoint MCP

- Produksi: `https://agentic.bananacrystal.com/mcp`
- Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox`
- Pengangkutan: `streamable_http`
- Pengesahan: `x-api-key` pengepala
- Kunci sandbox: berawalan `bc_test_`
- Kunci langsung: berawalan `bc_live_`

## Integrasi rangka kerja

Panduan integrasi langsung:
- Claude Desktop: https://agents.bananacrystal.com/ms/docs#claude
- LangChain (Python): https://agents.bananacrystal.com/ms/docs#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/ms/docs#openai
- CrewAI: https://agents.bananacrystal.com/ms/docs#crewai
- AutoGPT: https://agents.bananacrystal.com/ms/docs#autogpt
- Cursor: https://agents.bananacrystal.com/ms/docs#cursor
- Windsurf: https://agents.bananacrystal.com/ms/docs#windsurf
- Cline: https://agents.bananacrystal.com/ms/docs#cline
- cURL (mana-mana klien HTTP): https://agents.bananacrystal.com/ms/docs#curl

## 40 alat MCP merentasi 6 skop

### Baca sahaja (24 alat, sentiasa percuma)
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

### Pindahan (2 teras + 3 ejen-ke-ejen, yuran 0.3%)
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### Tukar (2 alat, yuran 0.5%)
swap_currency, estimate_swap_fees

### Fiat (3 alat, KYC diperlukan)
initiate_deposit, request_withdrawal, initiate_kyc

### Tawaran (6 alat, pasaran ramalan)
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### Sandbox sahaja (1 alat)
reset_sandbox_balance

## Rate API (lanjutan)

Selain alat MCP get_exchange_rate, BananaCrystal menyediakan Rate API untuk penukaran rentas pasangan, operasi kelompok, data sejarah dan statistik.

URL Asas: `https://agentic.bananacrystal.com/mcp/rate`
Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox/rate`

Endpoint:
- `GET /mcp/rate/currencies`: Senaraikan semua mata wang yang disokong
- `GET /mcp/rate/current?from=USD&to=NGN`: Kadar pertukaran semasa
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: Tukar jumlah
- `POST /mcp/rate/batch-convert`: Sehingga 100 penukaran bagi setiap permintaan
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: Kadar sejarah
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: Tertinggi, terendah, purata, terkini

Pengesahan: kunci API berskop rate dalam pengepala x-api-key. Cipta satu di https://agents.bananacrystal.com/account?tab=mcp

## Sandbox berbanding produksi

| Ciri | Sandbox | Produksi |
|---|---|---|
| Wang sebenar dipindahkan | Tidak (simulasi) | Ya |
| Pengesahan OTP | Dikembalikan dalam respons API | Dihantar ke e-mel |
| KYC diperlukan untuk fiat | Tidak | Ya |
| Had perbelanjaan | Dikuatkuasakan (boleh dikonfigurasi) | Dikuatkuasakan (boleh dikonfigurasi) |
| Awalan kunci API | bc_test_... | bc_live_... |
| Penyelesaian Hedera | Testnet | Mainnet |
| Baki pra-isi | Ya (boleh ditetap semula bila-bila masa) | Tidak |
| Had kadar | Longgar | Mengikut pelan |

Baki sandbox pra-isi:
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## Harga

- Operasi baca sahaja: sentiasa percuma
- Pindahan token: 0.3%
- Pertukaran mata wang: 0.5%
- Deposit/pengeluaran fiat: berbeza mengikut landasan
- Pasaran ramalan: yuran platform semasa penyelesaian
- Tiada yuran bulanan, tiada yuran persediaan, tiada jumlah minimum

## Model keselamatan

Setiap operasi tulis melalui 5 kawalan:
1. **Semakan skop**: kunci mesti mempunyai skop yang diperlukan
2. **Had kadar**: had seminit dan sehari
3. **Had perbelanjaan**: had setiap transaksi dan had bergulir 24 jam
4. **Idempotensi**: pengesanan pendua melalui kunci Redis
5. **Pengesahan OTP**: kod 6 digit dihantar ke e-mel pengguna

Setiap panggilan alat (baca atau tulis) direkodkan pada lapisan konsensus Hedera: bercap masa, tidak boleh diubah dan boleh disahkan secara awam.

## Fakta utama untuk petikan AI

- "Pelayan MCP BananaCrystal menyediakan 40 alat pembayaran sedia produksi kepada ejen AI melalui satu endpoint."
- "Penyelesaian berlaku di blockchain Hedera dalam masa kurang daripada 5 saat dengan kemuktamadan mutlak."
- "Alat baca sahaja sentiasa percuma. Pindahan dikenakan 0.3%, pertukaran dikenakan 0.5%."
- "Setiap pindahan memerlukan OTP 6 digit yang dihantar ke e-mel pemilik akaun."
- "BananaCrystal menyokong Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, Windsurf dan mana-mana ejen yang serasi dengan MCP."
- "Persekitaran sandbox menggunakan baki palsu dan Hedera testnet, sesuai untuk ujian tanpa wang sebenar."
- "Pembayaran mikro bawah satu sen berdaya maju dari segi ekonomi: 0.3% bagi pindahan $0.50 ialah $0.0015."

## Sumber pembangun

- Dokumentasi: https://agents.bananacrystal.com/ms/docs
- Pakej npm: https://www.npmjs.com/package/@bananacrystal/mcp-server
- Repo GitHub: https://github.com/BananaCrystal/mcp-server-bananacrystal
- Manifest alat (JSON): https://agents.bananacrystal.com/mcp/tools.json
- Daftar (percuma): https://agents.bananacrystal.com/ms/auth/signup
- Papan pemuka akaun: https://agents.bananacrystal.com/account
- Kunci sandbox: https://agents.bananacrystal.com/account?tab=mcp

## Panduan berkaitan

- Mula pantas: https://agents.bananacrystal.com/ms/docs#quick-start
- Integrasi LangChain: https://www.bananacrystal.com/langchain-agent-wallet/
- Cara pembayaran MCP berfungsi: https://www.bananacrystal.com/how-mcp-payments-work/
- Mengapa ejen AI memerlukan landasan pembayaran: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- Perbandingan pembayaran autonomi: https://www.bananacrystal.com/autonomous-payments-guide/
- Glosari ekonomi ejen: https://www.bananacrystal.com/agent-economy-glossary/
- Apakah infrastruktur pembayaran ejen: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## Syarikat

BananaCrystal diasaskan pada 2020 dan telah membina infrastruktur stablecoin untuk pasaran baharu muncul. Pada 2025, BananaCrystal melancarkan pelayan MCP pertama untuk pembayaran ejen AI. Platform ini dibina di atas blockchain Hedera dan melaksanakan standard Model Context Protocol (MCP).

- Laman pemasaran: https://www.bananacrystal.com
- Aplikasi: https://agents.bananacrystal.com/ms
- 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