What is BananaCrystal MCP?

BananaCrystal MCP is a Model Context Protocol server that gives AI agents the ability to check balances, transfer stablecoins, swap currencies, and handle fiat through a single endpoint settled on Hedera blockchain.

How fast are agent transactions?

Transactions settle in under 5 seconds on the Hedera consensus layer, providing instant finality for autonomous agent operations.

Dokumentasi MCP BananaCrystal | 40 Tool Pembayaran untuk AI Agent

Quick Start

Buat agen AI Anda mulai melakukan pembayaran dalam waktu kurang dari 5 menit.

Pasang MCP server

Pasang MCP server BananaCrystal secara global lewat npm.

bash

npm install -g @bananacrystal/mcp-server

Dapatkan API key Anda

Buat API key MCP dari dashboard akun Anda. Key sandbox diawali bc_test_ dan gratis.

Dapatkan API Key

Key sandbox: bc_test_...

Konfigurasi Claude Desktop

Tambahkan BananaCrystal ke file konfigurasi Claude Desktop Anda.

claude_desktop_config.json

json

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

Tanyakan ke agen Anda

Agen Anda sekarang punya 40 tool pembayaran. Coba prompt berikut:

›"Berapa saldo USDb saya sekarang?"

›"Kirim 50 USDb ke 0.0.654321"

›"Tukar 100 USDb ke NGNb dengan kurs saat ini"

›"Tampilkan 10 transaksi terakhir saya"

›"Berapa kurs USD ke NGN saat ini?"

Tool MCP

40 tool pembayaran siap produksi dalam 6 kategori. Operasi read-only selalu gratis.

Read-only24 tool

ping

read_onlygratis

Health check: mengembalikan pong

get_server_info

read_onlygratis

Mengembalikan informasi dasar server

echo

read_onlygratis

Mengembalikan pesan input ke pemanggil

get_my_profile

read_onlygratis

Ambil profil lengkap pengguna yang terautentikasi

get_balances

read_onlygratis

Ambil saldo akun Hedera untuk semua token platform atau token tertentu

get_exchange_rate

read_onlygratis

Ambil kurs beli/jual live untuk sebuah mata uang

list_supported_currencies

read_onlygratis

Tampilkan semua mata uang yang didukung beserta biaya dinamisnya

list_available_tokens

read_onlygratis

Tampilkan semua token Hedera yang tersedia di platform

get_transaction_history

read_onlygratis

Ambil riwayat transaksi berkategori dengan filter

get_my_limits

read_onlygratis

Ambil limit yang dikonfigurasi dan pemakaian live untuk API key yang terautentikasi

estimate_swap_fees

read_onlygratis

Perkirakan biaya swap mata uang sebelum dijalankan

get_agent_config

read_onlygratis

Lihat konfigurasi agen milik pengguna lain

check_approval_status

read_onlygratis

Cek status permintaan persetujuan transaksi agen yang tertunda

get_kyc_status

read_onlygratis

Ambil status verifikasi KYC pengguna lewat Sumsub

get_deposit_status

read_onlygratis

Ambil status deposit fiat berdasarkan transfer ID

get_withdrawal_status

read_onlygratis

Ambil permintaan penarikan pengguna lewat Brale

get_escrow_balances

read_onlygratis

Ambil rincian saldo escrow: total, tersedia, dan terkunci

get_escrow_history

read_onlygratis

Ambil riwayat transaksi escrow lengkap, termasuk penguncian, pelepasan, menang, dan kalah

list_offers

read_onlygratis

Telusuri penawaran aktif di prediction market beserta statistik trade

get_offer

read_onlygratis

Ambil detail lengkap satu penawaran, termasuk statistik trade

get_my_offers

read_onlygratis

Ambil semua penawaran yang dibuat oleh pengguna tertentu

list_trades

read_onlygratis

Tampilkan semua trade di platform dengan filter

get_trade

read_onlygratis

Ambil detail lengkap satu trade, termasuk statistik penawaran induknya

get_my_trades

read_onlygratis

Ambil semua trade milik pengguna, baik yang dibuat maupun yang diterima

Transfer2 tool

request_transfer_otp

transfer0.3%

Langkah 1: Minta kode verifikasi OTP yang dikirim ke email pengirim

transfer_tokens

transfer0.3%

Langkah 2: Jalankan transfer token dengan verifikasi OTP

Swap1 tool

swap_currency

swap0.5%

Tukar antara dua token Hedera, kurs dan biaya dihitung otomatis

Fiat3 tool

initiate_kyc

fiat

Mulai verifikasi KYC: mengembalikan access token Sumsub untuk SDK

initiate_deposit

fiat

Mulai deposit fiat lewat Brale (wajib KYC)

request_withdrawal

fiat

Ajukan penarikan fiat lewat Brale (wajib KYC)

Penawaran & Trade6 tool

create_offer

offers

Buat penawaran prediction market yang mengunci jumlah total di escrow

update_offer

offers

Ubah penawaran yang ada (hanya jika belum ada trade)

delist_offer

offers

Tarik penawaran Anda dari marketplace dan lepaskan escrow yang terkunci

delete_offer

offers

Hapus penawaran Anda secara permanen (diblokir jika ada trade aktif)

engage_offer

offers

Ambil penawaran terbuka dengan mengunci escrow yang sepadan

cancel_trade

offers

Batalkan trade aktif dan lepaskan escrow Anda yang terkunci

Antar-agen3 tool

request_agent_transaction

transfer

Minta transaksi atas nama agen milik pengguna lain (perlu persetujuan email)

execute_approved_transaction

transfer

Jalankan transaksi agen yang sudah disetujui menggunakan execution token

update_my_agent_settings

read_onlygratis

Atur apakah transaksi antar-agen memerlukan persetujuan email dan OTP

Khusus sandbox1 tool

reset_sandbox_balance

read_onlygratis

Kembalikan saldo sandbox ke nilai awal (khusus sandbox)

Rate API

Operasi kurs mata uang tingkat lanjut lewat REST. Memerlukan API key dengan scope rate.

Tool MCP atau Rate API: apa bedanya?

MCP server sudah menyertakan get_exchange_rate sebagai tool read_only: agen Anda bisa memanggilnya langsung untuk mendapatkan kurs beli/jual satu mata uang terhadap USD. Itu sudah mencakup sebagian besar kebutuhan agen.

Rate API menyediakan lebih banyak: konversi antar-pasangan, operasi batch massal, data historis time-series, dan ringkasan statistik. Semua tersedia sebagai endpoint HTTP langsung yang diautentikasi dengan API key ber-scope rate. Buat rate key dari dashboard akun Anda.

Autentikasi

Semua endpoint Rate API memerlukan API key ber-scope rate yang dikirim lewat header x-api-key. Versi sandbox tersedia di /mcp/sandbox/rate/* dan memakai key sandbox Anda (bc_test_...) dengan kurs tiruan tetap agar pengujian bisa diulang.

Base URL

https://agentic.bananacrystal.com/mcp/rate

GET/mcp/rate/currenciesTampilkan semua mata uang yang didukung

Tampilkan semua mata uang yang didukung

Contoh request

bash

curl "https://agentic.bananacrystal.com/mcp/rate/currencies" \
  -H "x-api-key: bc_live_your_rate_key_here"

Contoh response

json

{
  "count": 11,
  "currencies": ["EGP", "EUR", "GBP", "GHS", "KES", "NGN", "TZS", "UGX", "USD", "XOF", "ZAR"]
}

GET/mcp/rate/currentAmbil kurs saat ini antara dua mata uang

Ambil kurs saat ini antara dua mata uang

Parameter

Nama	Wajib	Deskripsi
`from`	wajib	Kode mata uang asal (mis. USD)
`to`	wajib	Kode mata uang tujuan (mis. NGN)

Contoh request

bash

curl "https://agentic.bananacrystal.com/mcp/rate/current?from=USD&to=NGN" \
  -H "x-api-key: bc_live_your_rate_key_here"

Contoh response

json

{
  "from": "USD",
  "to": "NGN",
  "rate": 1584.75,
  "buyRate": 1590.0,
  "sellRate": 1579.5,
  "timestamp": "2026-04-30T10:22:00.000Z"
}

GET/mcp/rate/convertKonversi jumlah dari satu mata uang ke mata uang lain

Konversi jumlah dari satu mata uang ke mata uang lain

Parameter

Nama	Wajib	Deskripsi
`from`	wajib	Kode mata uang asal
`to`	wajib	Kode mata uang tujuan
`amount`	wajib	Jumlah yang dikonversi (angka)

Contoh request

bash

curl "https://agentic.bananacrystal.com/mcp/rate/convert?from=USD&to=NGN&amount=100" \
  -H "x-api-key: bc_live_your_rate_key_here"

Contoh response

json

{
  "from": "USD",
  "to": "NGN",
  "amount": 100,
  "converted": 158475.0,
  "rate": 1584.75,
  "timestamp": "2026-04-30T10:22:00.000Z"
}

POST/mcp/rate/batch-convertKonversi beberapa jumlah mata uang dalam satu request (maks. 100)

Konversi beberapa jumlah mata uang dalam satu request (maks. 100)

Contoh request

bash

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 }
    ]
  }'

Contoh response

json

[
  { "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": "..." }
]

GET/mcp/rate/historyAmbil kurs historis untuk sebuah pasangan mata uang

Ambil kurs historis untuk sebuah pasangan mata uang

Parameter

Nama	Wajib	Deskripsi
`from`	wajib	Kode mata uang asal
`to`	wajib	Kode mata uang tujuan
`startDate`	wajib	Tanggal mulai (ISO 8601, mis. 2026-04-01)
`endDate`	wajib	Tanggal akhir (ISO 8601, mis. 2026-04-30)

Contoh request

bash

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"

Contoh response

json

[
  { "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 }
]

GET/mcp/rate/statsAmbil statistik kurs (tertinggi, terendah, rata-rata, terbaru) dalam satu periode

Ambil statistik kurs (tertinggi, terendah, rata-rata, terbaru) dalam satu periode

Parameter

Nama	Wajib	Deskripsi
`from`	wajib	Kode mata uang asal
`to`	wajib	Kode mata uang tujuan
`days`	opsional	Periode dalam hari, 1 sampai 365 (default: 30)

Contoh request

bash

curl "https://agentic.bananacrystal.com/mcp/rate/stats?from=USD&to=NGN&days=30" \
  -H "x-api-key: bc_live_your_rate_key_here"

Contoh response

json

{
  "from": "USD",
  "to": "NGN",
  "period": "30d",
  "high": 1598.0,
  "low": 1560.0,
  "avg": 1581.4,
  "latest": 1584.75,
  "count": 30
}

Rate API Sandbox

Ganti /mcp/rate/ dengan /mcp/sandbox/rate/ dan pakai key sandbox Anda untuk mendapatkan kurs tiruan tetap. Data historis dibuat dengan variasi ±2% agar pengujian terasa realistis. Tidak ada data kurs sungguhan yang dipakai.

Lingkungan Sandbox

Uji integrasi Anda dengan aman, dengan saldo awal dan tanpa uang sungguhan.

Apa itu sandbox?

Sandbox adalah lingkungan uji yang sepenuhnya terisolasi dan sama persis dengan production, termasuk tool, API, dan format response yang sama. Tidak ada uang sungguhan yang berpindah. API key sandbox diawali bc_test_ dan terhubung ke Hedera testnet.

Saldo awal

Setiap akun sandbox dimulai dengan saldo berikut. Pakai reset_sandbox_balance untuk mengembalikannya kapan saja.

Token	Jumlah	Mata uang
`USDb`	10,000	USD
`NGNb`	5,000,000	NGN
`GHSb`	50,000	GHS
`KESb`	1,000,000	KES
`ZARb`	150,000	ZAR

Sandbox vs Live

Fitur	Sandbox	Live
Uang sungguhan berpindah	Tidak: hanya simulasi	Ya
Verifikasi OTP	Dikembalikan di response API	Dikirim ke email Anda
Wajib KYC untuk fiat	Tidak	Ya
Limit pengeluaran diterapkan	Ya (bisa diatur)	Ya
Prefix API key	bc_test_...	bc_live_...
Penyelesaian Hedera	Testnet	Mainnet
Saldo awal	Ya (bisa direset kapan saja)	Tidak
Rate limit	Longgar	Sesuai paket

OTP di sandbox

Di mode sandbox, kode OTP dikembalikan langsung di response API request_transfer_otp, bukan dikirim lewat email. Jadi pengujian otomatis tetap mudah tanpa perlu akses email.

Konfigurasi sandbox

claude_desktop_config.json

json

{
  "mcpServers": {
    "bananacrystal": {
      "command": "bananacrystal-mcp",
      "env": {
        "BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here",
        "BANANACRYSTAL_API_URL": "https://agentic.bananacrystal.com/mcp/sandbox"
      }
    }
  }
}

Konfigurasi

Hubungkan BananaCrystal ke tool AI atau framework pilihan Anda.

claude_desktop_config.json

json

{
  "mcpServers": {
    "bananacrystal": {
      "command": "bananacrystal-mcp",
      "env": {
        "BANANACRYSTAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Environment variable

BANANACRYSTAL_API_KEYwajib

API key MCP Anda. Key sandbox diawali bc_test_, key live diawali bc_live_.

Default: N/A

BANANACRYSTAL_API_URLopsional

Ganti URL endpoint MCP. Pakai URL sandbox untuk pengujian.

Default: https://agentic.bananacrystal.com/mcp

DEBUGopsional

Isi dengan true untuk mengaktifkan log request/response yang lebih detail.

Default: false

Variable	Wajib	Default	Deskripsi
`BANANACRYSTAL_API_KEY`	wajib	`N/A`	API key MCP Anda. Key sandbox diawali bc_test_, key live diawali bc_live_.
`BANANACRYSTAL_API_URL`	opsional	`https://agentic.bananacrystal.com/mcp`	Ganti URL endpoint MCP. Pakai URL sandbox untuk pengujian.
`DEBUG`	opsional	`false`	Isi dengan true untuk mengaktifkan log request/response yang lebih detail.

Integrasi Framework

Contoh siap jalan untuk framework agen AI paling populer.

langchain_agent.py

python

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())

Framework apa pun yang kompatibel dengan MCP bisa dipakai. Jika framework Anda mendukung MCP server berbasis HTTP, arahkan ke https://agentic.bananacrystal.com/mcp dengan API key Anda sebagai Bearer token.

Arsitektur Keamanan

Beberapa lapis perlindungan, jadi agen Anda hanya bisa melakukan apa yang Anda izinkan secara eksplisit.

Scope API Key

Setiap API key punya scope izin yang eksplisit. Agen hanya bisa menjalankan operasi di dalam scope yang Anda berikan.

Limit Pengeluaran

Tetapkan batas maksimum per transaksi dan batas harian bergulir 24 jam untuk setiap API key. Batas ini diterapkan di level infrastruktur.

Verifikasi OTP

Setiap transfer token memerlukan OTP 6 digit yang dikirim ke email terdaftar Anda. Agen tidak bisa menyelesaikan transfer tanpa kode dari Anda.

Rate Limiting

Batas rate per key per menit mencegah agen yang lepas kendali membanjiri API. Batasnya naik sesuai tingkat paket Anda.

Jejak Audit yang Tidak Bisa Diubah

Setiap pemanggilan tool dicatat di consensus layer Hedera. Semuanya diberi timestamp, tahan manipulasi, dan bisa diverifikasi publik on-chain. Riwayat audit lengkap tersedia lewat get_transaction_history.

Alur Persetujuan Agen

Transaksi antar-agen bisa diwajibkan mendapat persetujuan manusia lewat email sebelum dijalankan. Pakai update_my_agent_settings untuk mengatur require_human_approval.

Scope API Key

read_only

Cek saldo, kurs, riwayat, dan limit tanpa memindahkan dana

transfer

Kirim token ke akun lain (wajib OTP)

swap

Tukar antar stablecoin mata uang

fiat

Deposit dan penarikan fiat (wajib KYC)

offers

Buat dan kelola penawaran serta trade prediction market

rate

Akses kurs mata uang, data historis, konversi, dan statistik kurs

Scope	Yang diizinkan
read_only	Cek saldo, kurs, riwayat, dan limit tanpa memindahkan dana
transfer	Kirim token ke akun lain (wajib OTP)
swap	Tukar antar stablecoin mata uang
fiat	Deposit dan penarikan fiat (wajib KYC)
offers	Buat dan kelola penawaran serta trade prediction market
rate	Akses kurs mata uang, data historis, konversi, dan statistik kurs

Harga

Operasi read-only selalu gratis. Anda hanya membayar transaksi yang memindahkan nilai.

Biaya operasi

Operasi read-only

get_balances, get_exchange_rate, list_trades, …

Gratis

Transfer token

transfer_tokens

0.3%

Swap mata uang

swap_currency

0.5%

Deposit fiat

initiate_deposit

Tergantung jalur

Penarikan fiat

request_withdrawal

Tergantung jalur

Prediction market

create_offer, engage_offer

Biaya platform saat penyelesaian

Operasi	Tool	Biaya
Operasi read-only	get_balances, get_exchange_rate, list_trades, …	Gratis
Transfer token	transfer_tokens	0.3%
Swap mata uang	swap_currency	0.5%
Deposit fiat	initiate_deposit	Tergantung jalur
Penarikan fiat	request_withdrawal	Tergantung jalur
Prediction market	create_offer, engage_offer	Biaya platform saat penyelesaian