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.

BananaCrystal MCP Dokümantasyonu | Yapay Zeka Ajanları için 40 Ödeme Aracı

Hızlı Başlangıç

Yapay zeka ajanınızın 5 dakikadan kısa sürede ödeme yapmasını sağlayın.

MCP sunucusunu kurun

BananaCrystal MCP sunucusunu npm ile global olarak kurun.

bash

npm install -g @bananacrystal/mcp-server

API anahtarınızı alın

Hesap panelinizden bir MCP API anahtarı oluşturun. Sandbox anahtarları bc_test_ ile başlar ve ücretsizdir.

API Anahtarı Al

Sandbox anahtarları: bc_test_...

Claude Desktop'ı yapılandırın

BananaCrystal'ı Claude Desktop yapılandırma dosyanıza ekleyin.

claude_desktop_config.json

json

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

Ajanınıza sorun

Ajanınızın artık 40 ödeme aracı var. Şu komutları deneyin:

›"Güncel USDb bakiyem nedir?"

›"0.0.654321 adresine 50 USDb gönder"

›"100 USDb'yi güncel kurdan NGNb'ye takas et"

›"Son 10 işlemimi göster"

›"Güncel USD/NGN döviz kuru nedir?"

MCP Araçları

6 kategoride kullanıma hazır 40 ödeme aracı. Salt okunur işlemler her zaman ücretsizdir.

Salt okunur24 araç

ping

read_onlyücretsiz

Sağlık kontrolü: pong döndürür

get_server_info

read_onlyücretsiz

Temel sunucu bilgilerini döndürür

echo

read_onlyücretsiz

Girdi mesajını çağırana geri döndürür

get_my_profile

read_onlyücretsiz

Kimliği doğrulanmış kullanıcının tam profilini getirir

get_balances

read_onlyücretsiz

Tüm platform token'ları veya belirli bir token için Hedera hesap bakiyesini getirir

get_exchange_rate

read_onlyücretsiz

Bir para birimi için canlı alış/satış kurlarını getirir

list_supported_currencies

read_onlyücretsiz

Desteklenen tüm para birimlerini dinamik ücretleriyle listeler

list_available_tokens

read_onlyücretsiz

Platformdaki tüm Hedera token'larını listeler

get_transaction_history

read_onlyücretsiz

Filtrelerle kategorilere ayrılmış işlem geçmişini getirir

get_my_limits

read_onlyücretsiz

Kimliği doğrulanmış API anahtarı için yapılandırılmış limitleri ve canlı kullanımı getirir

estimate_swap_fees

read_onlyücretsiz

Gerçekleştirmeden önce bir para birimi takasının ücretlerini tahmin eder

get_agent_config

read_onlyücretsiz

Başka bir kullanıcının ajan yapılandırmasını sorgular

check_approval_status

read_onlyücretsiz

Bekleyen bir ajan işlem onay isteğinin durumunu kontrol eder

get_kyc_status

read_onlyücretsiz

Sumsub üzerinden bir kullanıcının KYC doğrulama durumunu getirir

get_deposit_status

read_onlyücretsiz

Transfer ID ile bir fiat yatırma işleminin durumunu getirir

get_withdrawal_status

read_onlyücretsiz

Brale üzerinden bir kullanıcının çekim taleplerini getirir

get_escrow_balances

read_onlyücretsiz

Emanet bakiyesi dökümünü getirir: toplam, kullanılabilir ve kilitli tutarlar

get_escrow_history

read_onlyücretsiz

Kilitler, serbest bırakmalar, kazançlar ve kayıplar dahil tüm emanet işlem geçmişini getirir

list_offers

read_onlyücretsiz

Tahmin piyasasındaki aktif teklifleri işlem istatistikleriyle listeler

get_offer

read_onlyücretsiz

Tek bir teklifin işlem istatistikleri dahil tüm ayrıntılarını getirir

get_my_offers

read_onlyücretsiz

Belirli bir kullanıcının oluşturduğu tüm teklifleri getirir

list_trades

read_onlyücretsiz

Platformdaki tüm işlemleri filtrelerle listeler

get_trade

read_onlyücretsiz

Tek bir işlemin, üst teklif istatistikleri dahil tüm ayrıntılarını getirir

get_my_trades

read_onlyücretsiz

Bir kullanıcının oluşturduğu ve aldığı tüm işlemleri getirir

Transfer2 araç

request_transfer_otp

transfer0.3%

1. Adım: Gönderenin e-postasına gönderilecek bir OTP doğrulama kodu ister

transfer_tokens

transfer0.3%

2. Adım: Token transferini OTP doğrulamasıyla gerçekleştirir

Takas1 araç

swap_currency

swap0.5%

Kur ve ücretler otomatik hesaplanarak iki Hedera token'ı arasında takas yapar

Fiat3 araç

initiate_kyc

fiat

KYC doğrulamasını başlatır: SDK için bir Sumsub erişim token'ı döndürür

initiate_deposit

fiat

Brale üzerinden fiat yatırma başlatır (KYC gerekli)

request_withdrawal

fiat

Brale üzerinden fiat çekim talep eder (KYC gerekli)

Teklifler ve İşlemler6 araç

create_offer

offers

Toplam tutarı emanete kilitleyen bir tahmin piyasası teklifi oluşturur

update_offer

offers

Mevcut bir teklifi düzenler (yalnızca işlem yoksa)

delist_offer

offers

Teklifinizi pazar yerinden kaldırır ve kilitli emaneti serbest bırakır

delete_offer

offers

Teklifinizi kalıcı olarak siler (aktif işlem varsa engellenir)

engage_offer

offers

Eşleşen emaneti kilitleyerek açık bir teklife katılır

cancel_trade

offers

Aktif bir işlemi iptal eder ve kilitli emanetinizi serbest bırakır

Ajandan Ajana3 araç

request_agent_transaction

transfer

Başka bir kullanıcının ajanı adına işlem talep eder (e-posta onayı gerekir)

execute_approved_transaction

transfer

Daha önce onaylanmış bir ajan işlemini yürütme token'ıyla gerçekleştirir

update_my_agent_settings

read_onlyücretsiz

Ajandan ajana işlemlerin e-posta onayı ve OTP gerektirip gerektirmediğini kontrol eder

Yalnızca sandbox1 araç

reset_sandbox_balance

read_onlyücretsiz

Sandbox bakiyelerini önceden yüklenmiş varsayılanlara sıfırlar (yalnızca sandbox)

Kur API'si

REST üzerinden gelişmiş kur işlemleri. Rate kapsamlı bir API anahtarı gerektirir.

MCP aracı ile Kur API'si arasındaki fark nedir?

MCP sunucusu get_exchange_rate aracını zaten bir read_only araç olarak içerir: ajanınız tek bir para biriminin USD karşısındaki alış/satış kurunu almak için onu doğrudan çağırabilir. Bu, ajan kullanım senaryolarının çoğunu karşılar.

Kur API'si daha ileri gider: çapraz parite dönüşümleri, toplu işlemler, geçmiş zaman serisi verileri ve istatistiksel özetler. Bunlar, rate kapsamlı bir API anahtarıyla kimliği doğrulanan doğrudan HTTP uç noktaları olarak sunulur. Hesap panelinizden bir rate anahtarı oluşturun.

Kimlik Doğrulama

Tüm Kur API'si uç noktaları, x-api-key başlığında gönderilen rate kapsamlı bir API anahtarı gerektirir. Sandbox karşılıkları /mcp/sandbox/rate/* adresindedir ve tekrarlanabilir testler için sabit mock kurlarla sandbox anahtarınızı (bc_test_...) kullanır.

Temel URL

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

GET/mcp/rate/currenciesDesteklenen tüm para birimlerini listeler

Desteklenen tüm para birimlerini listeler

Örnek istek

bash

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

Örnek yanıt

json

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

GET/mcp/rate/currentİki para birimi arasındaki güncel döviz kurunu getirir

İki para birimi arasındaki güncel döviz kurunu getirir

Parametreler

Ad	Zorunlu	Açıklama
`from`	zorunlu	Kaynak para birimi kodu (ör. USD)
`to`	zorunlu	Hedef para birimi kodu (ör. NGN)

Örnek istek

bash

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

Örnek yanıt

json

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

GET/mcp/rate/convertBir tutarı bir para biriminden diğerine dönüştürür

Bir tutarı bir para biriminden diğerine dönüştürür

Parametreler

Ad	Zorunlu	Açıklama
`from`	zorunlu	Kaynak para birimi kodu
`to`	zorunlu	Hedef para birimi kodu
`amount`	zorunlu	Dönüştürülecek tutar (sayı)

Örnek istek

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"

Örnek yanıt

json

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

POST/mcp/rate/batch-convertTek bir istekte birden fazla tutarı dönüştürür (en fazla 100)

Tek bir istekte birden fazla tutarı dönüştürür (en fazla 100)

Örnek istek

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

Örnek yanıt

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/historyBir parite için geçmiş döviz kurlarını getirir

Bir parite için geçmiş döviz kurlarını getirir

Parametreler

Ad	Zorunlu	Açıklama
`from`	zorunlu	Kaynak para birimi kodu
`to`	zorunlu	Hedef para birimi kodu
`startDate`	zorunlu	Başlangıç tarihi (ISO 8601, ör. 2026-04-01)
`endDate`	zorunlu	Bitiş tarihi (ISO 8601, ör. 2026-04-30)

Örnek istek

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"

Örnek yanıt

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/statsBir dönem için kur istatistiklerini (en yüksek, en düşük, ortalama, en son) getirir

Bir dönem için kur istatistiklerini (en yüksek, en düşük, ortalama, en son) getirir

Parametreler

Ad	Zorunlu	Açıklama
`from`	zorunlu	Kaynak para birimi kodu
`to`	zorunlu	Hedef para birimi kodu
`days`	isteğe bağlı	Gün cinsinden dönem, 1 ila 365 (varsayılan: 30)

Örnek istek

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"

Örnek yanıt

json

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

Sandbox Kur API'si

Sabit mock kurlar almak için /mcp/rate/ yerine /mcp/sandbox/rate/ kullanın ve sandbox anahtarınızı kullanın. Geçmiş veriler, gerçekçi testler için ±2% sapmayla üretilir. Gerçek kur verisi kullanılmaz.

Sandbox Ortamı

Entegrasyonunuzu önceden yüklenmiş bakiyelerle ve gerçek para olmadan güvenle test edin.

Sandbox nedir?

Sandbox, canlı ortamı birebir yansıtan tamamen izole bir test ortamıdır: aynı araçlar, aynı API ve aynı yanıt formatı. Gerçek para hareket etmez. Sandbox API anahtarları bc_test_ ile başlar ve Hedera testnet'e bağlanır.

Önceden yüklenmiş bakiyeler

Her sandbox hesabı bu bakiyelerle başlar. İstediğiniz zaman geri yüklemek için reset_sandbox_balance kullanın.

Token	Tutar	Para Birimi
`USDb`	10,000	USD
`NGNb`	5,000,000	NGN
`GHSb`	50,000	GHS
`KESb`	1,000,000	KES
`ZARb`	150,000	ZAR

Sandbox ve Canlı Karşılaştırması

Özellik	Sandbox	Canlı
Gerçek para hareketi	Hayır: yalnızca simülasyon	Evet
OTP doğrulaması	API yanıtında döner	E-postanıza gönderilir
Fiat için KYC gerekli	Hayır	Evet
Harcama limitleri uygulanır	Evet (yapılandırılabilir)	Evet
API anahtarı öneki	bc_test_...	bc_live_...
Hedera mutabakatı	Testnet	Mainnet
Önceden yüklenmiş bakiyeler	Evet (istediğiniz zaman sıfırlanır)	Hayır
İstek limitleri	Esnek	Plana göre

Sandbox'ta OTP

Sandbox modunda OTP kodu e-postayla gönderilmek yerine doğrudan request_transfer_otp API yanıtında döner. Bu, e-posta erişimine gerek kalmadan otomatik testi kolaylaştırır.

Sandbox yapılandırması

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"
      }
    }
  }
}

Yapılandırma

BananaCrystal'ı tercih ettiğiniz yapay zeka aracına veya framework'e bağlayın.

claude_desktop_config.json

json

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

Ortam değişkenleri

BANANACRYSTAL_API_KEYzorunlu

MCP API anahtarınız. Sandbox anahtarları bc_test_, canlı anahtarlar bc_live_ ile başlar.

Varsayılan: N/A

BANANACRYSTAL_API_URListeğe bağlı

MCP uç noktası URL'sini geçersiz kılar. Test için sandbox URL'sini kullanın.

Varsayılan: https://agentic.bananacrystal.com/mcp

DEBUGisteğe bağlı

Ayrıntılı istek/yanıt kaydını etkinleştirmek için true olarak ayarlayın.

Varsayılan: false

Değişken	Zorunlu	Varsayılan	Açıklama
`BANANACRYSTAL_API_KEY`	zorunlu	`N/A`	MCP API anahtarınız. Sandbox anahtarları bc_test_, canlı anahtarlar bc_live_ ile başlar.
`BANANACRYSTAL_API_URL`	isteğe bağlı	`https://agentic.bananacrystal.com/mcp`	MCP uç noktası URL'sini geçersiz kılar. Test için sandbox URL'sini kullanın.
`DEBUG`	isteğe bağlı	`false`	Ayrıntılı istek/yanıt kaydını etkinleştirmek için true olarak ayarlayın.

Framework Entegrasyonları

En popüler yapay zeka ajan framework'leri için çalıştırmaya hazır örnekler.

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

MCP uyumlu her framework çalışır. Framework'ünüz HTTP tabanlı MCP sunucularını destekliyorsa, API anahtarınızı Bearer token olarak kullanarak https://agentic.bananacrystal.com/mcp adresine yönlendirin.

Güvenlik Mimarisi

Ajanınızın yalnızca açıkça yetkilendirdiğiniz işlemleri yapabilmesi için birden fazla koruma katmanı.

API Anahtarı Kapsamları

Her API anahtarının açık izin kapsamları vardır. Bir ajan yalnızca verdiğiniz kapsamlar dahilinde işlem yapabilir.

Harcama Limitleri

API anahtarı başına kesin işlem maksimumları ve 24 saatlik kayan günlük sınırlar belirleyin. Bunlar altyapı seviyesinde uygulanır.

OTP Doğrulaması

Her token transferi, kayıtlı e-postanıza gönderilen 6 haneli bir OTP gerektirir. Siz bu kodu vermeden ajan transferi tamamlayamaz.

İstek Sınırlama

Anahtar başına, dakika başına istek sınırları, kontrolden çıkan ajanların API'yi aşırı yüklemesini önler. Limitler plan seviyenize göre ölçeklenir.

Değiştirilemez Denetim Kaydı

Her araç çağrısı Hedera konsensüs katmanına yazılır. Kayıtlar zaman damgalı, değiştirilemez ve zincir üstünde herkes tarafından doğrulanabilir. Tüm denetim geçmişi get_transaction_history ile kullanılabilir.

Ajan Onay Akışı

Ajandan ajana işlemler, gerçekleştirilmeden önce insan e-posta onayı gerektirebilir. require_human_approval ayarı için update_my_agent_settings kullanın.

API Anahtarı Kapsamları

read_only

Hiçbir fon hareket ettirmeden bakiyeleri, kurları, geçmişi ve limitleri sorgulama

transfer

Diğer hesaplara token gönderme (OTP gerekir)

swap

Para birimi stablecoin'leri arasında takas

fiat

Fiat yatırma ve çekme (KYC gerekir)

offers

Tahmin piyasası teklifleri ve işlemleri oluşturma ve yönetme

rate

Döviz kurlarına, geçmiş verilere, dönüşümlere ve kur istatistiklerine erişim

Kapsam	İzin verdiği işlemler
read_only	Hiçbir fon hareket ettirmeden bakiyeleri, kurları, geçmişi ve limitleri sorgulama
transfer	Diğer hesaplara token gönderme (OTP gerekir)
swap	Para birimi stablecoin'leri arasında takas
fiat	Fiat yatırma ve çekme (KYC gerekir)
offers	Tahmin piyasası teklifleri ve işlemleri oluşturma ve yönetme
rate	Döviz kurlarına, geçmiş verilere, dönüşümlere ve kur istatistiklerine erişim

Fiyatlandırma

Salt okunur işlemler her zaman ücretsizdir. Yalnızca değer taşıyan işlemler için ödersiniz.

İşlem ücretleri

Salt okunur işlemler

get_balances, get_exchange_rate, list_trades, …

Ücretsiz

Token transferleri

transfer_tokens

0.3%

Para birimi takasları

swap_currency

0.5%

Fiat yatırma

initiate_deposit

Kanala göre değişir

Fiat çekme

request_withdrawal

Kanala göre değişir

Tahmin piyasası

create_offer, engage_offer

Sonuçlandırmada platform ücreti

İşlem	Araçlar	Ücret
Salt okunur işlemler	get_balances, get_exchange_rate, list_trades, …	Ücretsiz
Token transferleri	transfer_tokens	0.3%
Para birimi takasları	swap_currency	0.5%
Fiat yatırma	initiate_deposit	Kanala göre değişir
Fiat çekme	request_withdrawal	Kanala göre değişir
Tahmin piyasası	create_offer, engage_offer	Sonuçlandırmada platform ücreti