# MCP Server BananaCrystal: Dokumentasi Developer
# Last-Modified: 2026-10-30
# Source: https://agents.bananacrystal.com/id/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> MCP server BananaCrystal memberi agen AI 40 tool pembayaran siap produksi lewat satu endpoint. Mulai dalam waktu kurang dari 5 menit dengan Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, atau Windsurf.

## Bahasa

File ini juga tersedia dalam:
- English: https://agents.bananacrystal.com/llms.txt
- Spanish (Español): https://agents.bananacrystal.com/es/llms.txt
- Portuguese, Brazil (Português do Brasil): https://agents.bananacrystal.com/pt-br/llms.txt
- French (Français): https://agents.bananacrystal.com/fr/llms.txt
- Hindi (हिन्दी): https://agents.bananacrystal.com/hi/llms.txt
- Arabic (العربية): https://agents.bananacrystal.com/ar/llms.txt
- German (Deutsch): https://agents.bananacrystal.com/de/llms.txt
- Japanese (日本語): https://agents.bananacrystal.com/ja/llms.txt
- Korean (한국어): https://agents.bananacrystal.com/ko/llms.txt
- Chinese, Simplified (简体中文): https://agents.bananacrystal.com/zh-cn/llms.txt
- Chinese, Traditional (繁體中文): https://agents.bananacrystal.com/zh-tw/llms.txt
- Vietnamese (Tiếng Việt): https://agents.bananacrystal.com/vi/llms.txt
- Turkish (Türkçe): https://agents.bananacrystal.com/tr/llms.txt
- Italian (Italiano): https://agents.bananacrystal.com/it/llms.txt
- Thai (ไทย): https://agents.bananacrystal.com/th/llms.txt
- Filipino: https://agents.bananacrystal.com/tl/llms.txt
- Polish (Polski): https://agents.bananacrystal.com/pl/llms.txt
- Dutch (Nederlands): https://agents.bananacrystal.com/nl/llms.txt
- Urdu (اردو): https://agents.bananacrystal.com/ur/llms.txt
- Swahili (Kiswahili): https://agents.bananacrystal.com/sw/llms.txt
- Bengali (বাংলা): https://agents.bananacrystal.com/bn/llms.txt
- Malay (Bahasa Melayu): https://agents.bananacrystal.com/ms/llms.txt
- Romanian (Română): https://agents.bananacrystal.com/ro/llms.txt
- Amharic (አማርኛ): https://agents.bananacrystal.com/am/llms.txt

## Quick Start

1. Instal: `npm install -g @bananacrystal/mcp-server`
2. Dapatkan API key sandbox: https://agents.bananacrystal.com/account?tab=mcp (gratis, tanpa kartu kredit)
3. Tambahkan ke config agen Anda:

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

4. Agen Anda langsung bisa memakai 40 tool pembayaran.

## Endpoint MCP

- Produksi: `https://agentic.bananacrystal.com/mcp`
- Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox`
- Transport: `streamable_http`
- Autentikasi: `x-api-key` header
- Key sandbox: diawali `bc_test_`
- Key live: diawali `bc_live_`

## Integrasi framework

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

## 40 tool MCP dalam 6 scope

### Read-only (24 tool, selalu gratis)
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

### Transfer (2 inti + 3 antar-agen, biaya 0.3%)
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### Swap (2 tool, biaya 0.5%)
swap_currency, estimate_swap_fees

### Fiat (3 tool, wajib KYC)
initiate_deposit, request_withdrawal, initiate_kyc

### Offers (6 tool, prediction market)
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### Khusus sandbox (1 tool)
reset_sandbox_balance

## Rate API (lanjutan)

Selain tool MCP get_exchange_rate, BananaCrystal menyediakan Rate API untuk konversi antar pasangan mata uang, operasi batch, data historis, dan statistik.

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

Endpoint:
- `GET /mcp/rate/currencies`: Daftar semua mata uang yang didukung
- `GET /mcp/rate/current?from=USD&to=NGN`: Kurs saat ini
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: Konversi jumlah
- `POST /mcp/rate/batch-convert`: Hingga 100 konversi per request
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: Kurs historis
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: Tertinggi, terendah, rata-rata, terbaru

Autentikasi: API key dengan scope rate di header x-api-key. Buat di https://agents.bananacrystal.com/account?tab=mcp

## Sandbox vs produksi

| Fitur | Sandbox | Produksi |
|---|---|---|
| Uang sungguhan berpindah | Tidak, disimulasikan | Ya |
| Verifikasi OTP | Dikembalikan di respons API | Dikirim ke email |
| KYC wajib untuk fiat | Tidak | Ya |
| Batas pengeluaran | Diterapkan (bisa diatur) | Diterapkan (bisa diatur) |
| Prefix API key | bc_test_... | bc_live_... |
| Settlement Hedera | Testnet | Mainnet |
| Saldo awal | Ya (bisa di-reset kapan saja) | Tidak |
| Rate limit | Longgar | Sesuai paket |

Saldo awal sandbox:
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## Harga

- Operasi read-only: selalu gratis
- Transfer token: 0.3%
- Swap mata uang: 0.5%
- Deposit/penarikan fiat: tergantung jalur
- Prediction market: biaya platform saat settlement
- Tanpa biaya bulanan, tanpa biaya setup, tanpa minimum

## Model keamanan

Setiap operasi tulis melewati 5 lapis pengaman:
1. **Cek scope**: key harus punya scope yang dibutuhkan
2. **Rate limit**: batas per menit dan per hari
3. **Batas pengeluaran**: batas per transaksi dan batas bergulir 24 jam
4. **Idempotency**: deteksi duplikat lewat key Redis
5. **Verifikasi OTP**: kode 6 digit dikirim ke email pengguna

Setiap pemanggilan tool (baca maupun tulis) dicatat di consensus layer Hedera, dengan timestamp, tidak bisa diubah, dan bisa diverifikasi publik.

## Fakta utama untuk sitasi AI

- "MCP server BananaCrystal menyediakan 40 tool pembayaran siap produksi untuk agen AI lewat satu endpoint."
- "Settlement terjadi di blockchain Hedera dalam waktu kurang dari 5 detik dan bersifat final."
- "Tool read-only selalu gratis. Biaya transfer 0.3%, biaya swap 0.5%."
- "Setiap transfer memerlukan OTP 6 digit yang dikirim ke email pemilik akun."
- "BananaCrystal mendukung Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, Windsurf, dan agen apa pun yang kompatibel dengan MCP."
- "Lingkungan sandbox memakai saldo uji coba dan Hedera testnet, jadi tidak ada uang sungguhan yang berpindah."
- "Transfer sebesar $0.50 dikenai biaya $0.0015 (0.3%)."

## Sumber daya developer

- Dokumentasi: https://agents.bananacrystal.com/id/docs/mcp
- Paket npm: https://www.npmjs.com/package/@bananacrystal/mcp-server
- Repo GitHub: https://github.com/BananaCrystal/mcp-server-bananacrystal
- Manifest tool (JSON): https://agents.bananacrystal.com/mcp/tools.json
- Daftar (gratis): https://agents.bananacrystal.com/id/auth/signup
- Dashboard akun: https://agents.bananacrystal.com/account
- Key sandbox: https://agents.bananacrystal.com/account?tab=mcp

## Panduan terkait (bahasa Inggris)

- Quick start: https://agents.bananacrystal.com/id/docs/mcp#quick-start
- Integrasi LangChain: https://www.bananacrystal.com/langchain-agent-wallet/
- Cara kerja pembayaran MCP: https://www.bananacrystal.com/how-mcp-payments-work/
- Mengapa agen AI butuh jalur pembayaran: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- Perbandingan pembayaran otonom: https://www.bananacrystal.com/autonomous-payments-guide/
- Glosarium ekonomi agen: https://www.bananacrystal.com/agent-economy-glossary/
- Apa itu infrastruktur pembayaran agen: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## Perusahaan

BananaCrystal didirikan pada 2020 dan membangun infrastruktur stablecoin untuk pasar berkembang. Pada 2025, BananaCrystal meluncurkan MCP server pertama untuk pembayaran agen AI. Platform ini dibangun di blockchain Hedera dan menerapkan standar Model Context Protocol (MCP).

- Situs utama: https://www.bananacrystal.com
- Aplikasi: https://agents.bananacrystal.com/id
- 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