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 Alat Pembayaran untuk Ejen AI

Mula Pantas

Biarkan ejen AI anda membuat pembayaran dalam masa kurang daripada 5 minit.

Pasang pelayan MCP

Pasang pelayan MCP BananaCrystal secara global melalui npm.

bash

npm install -g @bananacrystal/mcp-server

Dapatkan kunci API anda

Cipta kunci API MCP daripada papan pemuka akaun anda. Kunci sandbox bermula dengan bc_test_ dan percuma.

Dapatkan Kunci API

Kunci sandbox: bc_test_...

Konfigurasikan Claude Desktop

Tambah BananaCrystal pada fail konfigurasi Claude Desktop anda.

claude_desktop_config.json

json

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

Tanya ejen anda

Ejen anda kini mempunyai 40 alat pembayaran. Cuba arahan ini:

›"Berapakah baki USDb saya sekarang?"

›"Hantar 50 USDb ke 0.0.654321"

›"Tukar 100 USDb kepada NGNb pada kadar semasa"

›"Tunjukkan 10 transaksi terakhir saya"

›"Berapakah kadar pertukaran USD kepada NGN sekarang?"

Alat MCP

40 alat pembayaran sedia produksi merentasi 6 kategori. Operasi baca sahaja sentiasa percuma.

Baca sahaja24 alat

ping

read_onlypercuma

Semakan kesihatan: memulangkan pong

get_server_info

read_onlypercuma

Memulangkan maklumat asas pelayan

echo

read_onlypercuma

Memulangkan semula mesej input kepada pemanggil

get_my_profile

read_onlypercuma

Dapatkan profil penuh pengguna yang disahkan

get_balances

read_onlypercuma

Dapatkan baki akaun Hedera untuk semua token platform atau token tertentu

get_exchange_rate

read_onlypercuma

Dapatkan kadar pertukaran beli/jual semasa bagi sesuatu mata wang

list_supported_currencies

read_onlypercuma

Senaraikan semua mata wang yang disokong berserta yuran dinamiknya

list_available_tokens

read_onlypercuma

Senaraikan semua token Hedera yang tersedia untuk platform

get_transaction_history

read_onlypercuma

Dapatkan sejarah transaksi berkategori dengan penapis

get_my_limits

read_onlypercuma

Dapatkan had yang dikonfigurasi dan penggunaan semasa bagi kunci API yang disahkan

estimate_swap_fees

read_onlypercuma

Anggarkan yuran bagi pertukaran mata wang sebelum melaksanakannya

get_agent_config

read_onlypercuma

Semak konfigurasi ejen pengguna lain

check_approval_status

read_onlypercuma

Semak status permintaan kelulusan transaksi ejen yang belum selesai

get_kyc_status

read_onlypercuma

Dapatkan status pengesahan KYC pengguna melalui Sumsub

get_deposit_status

read_onlypercuma

Dapatkan status deposit fiat mengikut ID pindahan

get_withdrawal_status

read_onlypercuma

Dapatkan permintaan pengeluaran pengguna melalui Brale

get_escrow_balances

read_onlypercuma

Dapatkan pecahan baki escrow: jumlah, tersedia dan dikunci

get_escrow_history

read_onlypercuma

Dapatkan sejarah penuh transaksi escrow termasuk kunci, pelepasan, kemenangan dan kerugian

list_offers

read_onlypercuma

Layari pasaran ramalan untuk tawaran aktif berserta statistik dagangan

get_offer

read_onlypercuma

Dapatkan butiran penuh satu tawaran termasuk statistik dagangan

get_my_offers

read_onlypercuma

Dapatkan semua tawaran yang dicipta oleh pengguna tertentu

list_trades

read_onlypercuma

Senaraikan semua dagangan di platform dengan penapis

get_trade

read_onlypercuma

Dapatkan butiran penuh satu dagangan termasuk statistik tawaran induk

get_my_trades

read_onlypercuma

Dapatkan semua dagangan pengguna, termasuk yang dicipta dan diterima

Pindahan2 alat

request_transfer_otp

transfer0.3%

Langkah 1: Minta kod pengesahan OTP yang dihantar ke e-mel penghantar

transfer_tokens

transfer0.3%

Langkah 2: Laksanakan pindahan token dengan pengesahan OTP

Tukar1 alat

swap_currency

swap0.5%

Tukar antara dua token Hedera dengan kadar dan yuran dikira secara automatik

Fiat3 alat

initiate_kyc

fiat

Mulakan pengesahan KYC: memulangkan token akses Sumsub untuk SDK

initiate_deposit

fiat

Mulakan deposit fiat melalui Brale (KYC diperlukan)

request_withdrawal

fiat

Minta pengeluaran fiat melalui Brale (KYC diperlukan)

Tawaran & Dagangan6 alat

create_offer

offers

Cipta tawaran pasaran ramalan yang mengunci jumlah penuh dalam escrow

update_offer

offers

Sunting tawaran sedia ada (hanya apabila tiada dagangan wujud)

delist_offer

offers

Keluarkan tawaran anda daripada pasaran dan lepaskan escrow yang dikunci

delete_offer

offers

Padam tawaran anda secara kekal (disekat jika ada dagangan aktif)

engage_offer

offers

Sertai tawaran terbuka dengan mengunci escrow yang sepadan

cancel_trade

offers

Batalkan dagangan aktif dan lepaskan escrow anda yang dikunci

Ejen-ke-Ejen3 alat

request_agent_transaction

transfer

Minta transaksi bagi pihak ejen pengguna lain (memerlukan kelulusan e-mel)

execute_approved_transaction

transfer

Laksanakan transaksi ejen yang telah diluluskan menggunakan token pelaksanaan

update_my_agent_settings

read_onlypercuma

Kawal sama ada transaksi ejen-ke-ejen memerlukan kelulusan e-mel dan OTP

Sandbox sahaja1 alat

reset_sandbox_balance

read_onlypercuma

Tetapkan semula baki sandbox kepada nilai lalai pra-isi (sandbox sahaja)

Rate API

Operasi kadar mata wang lanjutan melalui REST. Memerlukan kunci API berskop rate.

Alat MCP berbanding Rate API: apakah bezanya?

Pelayan MCP sudah termasuk get_exchange_rate sebagai alat read_only: ejen anda boleh memanggilnya terus untuk mendapatkan kadar beli/jual bagi satu mata wang berbanding USD. Itu sudah meliputi kebanyakan kes penggunaan ejen.

Rate API pergi lebih jauh: penukaran rentas pasangan, operasi kelompok pukal, data siri masa sejarah dan ringkasan statistik. Ini tersedia sebagai endpoint HTTP terus yang disahkan dengan kunci API berskop rate. Cipta kunci rate daripada papan pemuka akaun anda.

Pengesahan

Semua endpoint Rate API memerlukan kunci API berskop rate yang dihantar sebagai pengepala x-api-key. Setara sandbox tersedia di /mcp/sandbox/rate/* dan menggunakan kunci sandbox anda (bc_test_...) dengan kadar olok-olok tetap untuk ujian yang boleh diulang.

URL Asas

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

GET/mcp/rate/currenciesSenaraikan semua mata wang yang disokong

Senaraikan semua mata wang yang disokong

Contoh permintaan

bash

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

Contoh respons

json

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

GET/mcp/rate/currentDapatkan kadar pertukaran semasa antara dua mata wang

Dapatkan kadar pertukaran semasa antara dua mata wang

Parameter

Nama	Wajib	Keterangan
`from`	wajib	Kod mata wang sumber (cth. USD)
`to`	wajib	Kod mata wang sasaran (cth. NGN)

Contoh permintaan

bash

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

Contoh respons

json

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

GET/mcp/rate/convertTukar jumlah daripada satu mata wang kepada mata wang lain

Tukar jumlah daripada satu mata wang kepada mata wang lain

Parameter

Nama	Wajib	Keterangan
`from`	wajib	Kod mata wang sumber
`to`	wajib	Kod mata wang sasaran
`amount`	wajib	Jumlah untuk ditukar (nombor)

Contoh permintaan

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 respons

json

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

POST/mcp/rate/batch-convertTukar beberapa jumlah mata wang dalam satu permintaan (maks 100)

Tukar beberapa jumlah mata wang dalam satu permintaan (maks 100)

Contoh permintaan

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 respons

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/historyDapatkan kadar pertukaran sejarah bagi pasangan mata wang

Dapatkan kadar pertukaran sejarah bagi pasangan mata wang

Parameter

Nama	Wajib	Keterangan
`from`	wajib	Kod mata wang sumber
`to`	wajib	Kod mata wang sasaran
`startDate`	wajib	Tarikh mula (ISO 8601, cth. 2026-04-01)
`endDate`	wajib	Tarikh akhir (ISO 8601, cth. 2026-04-30)

Contoh permintaan

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 respons

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/statsDapatkan statistik kadar (tertinggi, terendah, purata, terkini) bagi satu tempoh

Dapatkan statistik kadar (tertinggi, terendah, purata, terkini) bagi satu tempoh

Parameter

Nama	Wajib	Keterangan
`from`	wajib	Kod mata wang sumber
`to`	wajib	Kod mata wang sasaran
`days`	pilihan	Tempoh dalam hari, 1 hingga 365 (lalai: 30)

Contoh permintaan

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 respons

json

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

Rate API Sandbox

Gantikan /mcp/rate/ dengan /mcp/sandbox/rate/ dan gunakan kunci sandbox anda untuk mendapatkan kadar olok-olok tetap. Data sejarah dijana dengan variasi ±2% untuk ujian yang realistik. Tiada data pertukaran sebenar digunakan.

Persekitaran Sandbox

Uji integrasi anda dengan selamat menggunakan baki pra-isi dan tanpa wang sebenar.

Apakah sandbox?

Sandbox ialah persekitaran ujian terasing sepenuhnya yang mencerminkan produksi dengan tepat, termasuk alat yang sama, API yang sama dan format respons yang sama. Tiada wang sebenar dipindahkan. Kunci API sandbox bermula dengan bc_test_ dan bersambung ke Hedera testnet.

Baki pra-isi

Setiap akaun sandbox bermula dengan baki ini. Gunakan reset_sandbox_balance untuk memulihkannya pada bila-bila masa.

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

Sandbox berbanding Langsung

Ciri	Sandbox	Langsung
Wang sebenar dipindahkan	Tidak: simulasi sahaja	Ya
Pengesahan OTP	Dikembalikan dalam respons API	Dihantar ke e-mel anda
KYC diperlukan untuk fiat	Tidak	Ya
Had perbelanjaan dikuatkuasakan	Ya (boleh dikonfigurasi)	Ya
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

OTP dalam sandbox

Dalam mod sandbox, kod OTP dipulangkan terus dalam respons API request_transfer_otp dan tidak dihantar melalui e-mel. Ini memudahkan ujian automatik tanpa memerlukan akses e-mel.

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

Sambungkan BananaCrystal kepada alat atau rangka kerja AI pilihan anda.

claude_desktop_config.json

json

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

Pemboleh ubah persekitaran

BANANACRYSTAL_API_KEYwajib

Kunci API MCP anda. Kunci sandbox bermula dengan bc_test_, kunci langsung dengan bc_live_.

Lalai: N/A

BANANACRYSTAL_API_URLpilihan

Gantikan URL endpoint MCP. Gunakan URL sandbox untuk ujian.

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

DEBUGpilihan

Tetapkan kepada true untuk mendayakan pengelogan permintaan/respons terperinci.

Lalai: false

Pemboleh ubah	Wajib	Lalai	Keterangan
`BANANACRYSTAL_API_KEY`	wajib	`N/A`	Kunci API MCP anda. Kunci sandbox bermula dengan bc_test_, kunci langsung dengan bc_live_.
`BANANACRYSTAL_API_URL`	pilihan	`https://agentic.bananacrystal.com/mcp`	Gantikan URL endpoint MCP. Gunakan URL sandbox untuk ujian.
`DEBUG`	pilihan	`false`	Tetapkan kepada true untuk mendayakan pengelogan permintaan/respons terperinci.

Integrasi Rangka Kerja

Contoh sedia dijalankan untuk rangka kerja ejen AI yang paling popular.

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

Mana-mana rangka kerja yang serasi dengan MCP boleh digunakan. Jika rangka kerja anda menyokong pelayan MCP berasaskan HTTP, halakannya ke https://agentic.bananacrystal.com/mcp dengan kunci API anda sebagai token Bearer.

Seni Bina Keselamatan

Pelbagai lapisan perlindungan supaya ejen anda hanya boleh melakukan apa yang anda benarkan secara jelas.

Skop Kunci API

Setiap kunci API mempunyai skop kebenaran yang jelas. Ejen hanya boleh melakukan operasi dalam skop yang anda berikan.

Had Perbelanjaan

Tetapkan had maksimum yang ketat bagi setiap transaksi dan had harian bergulir 24 jam bagi setiap kunci API. Had ini dikuatkuasakan pada peringkat infrastruktur.

Pengesahan OTP

Setiap pindahan token memerlukan OTP 6 digit yang dihantar ke e-mel berdaftar anda. Ejen tidak boleh melengkapkan pindahan tanpa anda memberikan kod tersebut.

Had Kadar

Had kadar seminit bagi setiap kunci menghalang ejen yang tidak terkawal daripada membebankan API. Had meningkat mengikut peringkat pelan anda.

Jejak Audit Kekal

Setiap panggilan alat direkodkan pada lapisan konsensus Hedera. Ia bercap masa, kalis usik dan boleh disahkan secara awam on-chain. Sejarah audit penuh tersedia melalui get_transaction_history.

Aliran Kelulusan Ejen

Transaksi ejen-ke-ejen boleh memerlukan kelulusan manusia melalui e-mel sebelum dilaksanakan. Gunakan update_my_agent_settings untuk mengkonfigurasi require_human_approval.

Skop Kunci API

read_only

Semak baki, kadar, sejarah dan had tanpa memindahkan sebarang dana

transfer

Hantar token ke akaun lain (memerlukan OTP)

swap

Tukar antara stablecoin mata wang

fiat

Deposit dan pengeluaran fiat (memerlukan KYC)

offers

Cipta dan urus tawaran serta dagangan pasaran ramalan

rate

Akses kadar pertukaran mata wang, data sejarah, penukaran dan statistik kadar

Skop	Apa yang dibenarkan
read_only	Semak baki, kadar, sejarah dan had tanpa memindahkan sebarang dana
transfer	Hantar token ke akaun lain (memerlukan OTP)
swap	Tukar antara stablecoin mata wang
fiat	Deposit dan pengeluaran fiat (memerlukan KYC)
offers	Cipta dan urus tawaran serta dagangan pasaran ramalan
rate	Akses kadar pertukaran mata wang, data sejarah, penukaran dan statistik kadar

Harga

Operasi baca sahaja sentiasa percuma. Bayar hanya untuk transaksi yang memindahkan nilai.

Yuran operasi

Operasi baca sahaja

get_balances, get_exchange_rate, list_trades, …

Percuma

Pindahan token

transfer_tokens

0.3%

Pertukaran mata wang

swap_currency

0.5%

Deposit fiat

initiate_deposit

Berbeza mengikut landasan

Pengeluaran fiat

request_withdrawal

Berbeza mengikut landasan

Pasaran ramalan

create_offer, engage_offer

Yuran platform semasa penyelesaian

Operasi	Alat	Yuran
Operasi baca sahaja	get_balances, get_exchange_rate, list_trades, …	Percuma
Pindahan token	transfer_tokens	0.3%
Pertukaran mata wang	swap_currency	0.5%
Deposit fiat	initiate_deposit	Berbeza mengikut landasan
Pengeluaran fiat	request_withdrawal	Berbeza mengikut landasan
Pasaran ramalan	create_offer, engage_offer	Yuran platform semasa penyelesaian