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.

Documentație MCP BananaCrystal | 40 de instrumente de plată pentru agenți AI

Pornire rapidă

Agentul AI poate face plăți în mai puțin de 5 minute.

Instalați serverul MCP

Instalați global serverul MCP BananaCrystal prin npm.

bash

npm install -g @bananacrystal/mcp-server

Obțineți cheia API

Creați o cheie API MCP din panoul contului. Cheile sandbox încep cu bc_test_ și sunt gratuite.

Obțineți cheia API

Chei sandbox: bc_test_...

Configurați Claude Desktop

Adăugați BananaCrystal în fișierul de configurare Claude Desktop.

claude_desktop_config.json

json

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

Întrebați agentul

Agentul are acum 40 de instrumente de plată. Încercați aceste solicitări:

›"Care este soldul meu curent în USDb?"

›"Trimite 50 USDb către 0.0.654321"

›"Schimbă 100 USDb în NGNb la cursul curent"

›"Arată-mi ultimele 10 tranzacții"

›"Care este cursul de schimb curent USD în NGN?"

Instrumente MCP

40 de instrumente de plată gata de producție în 6 categorii. Operațiunile doar de citire sunt mereu gratuite.

Doar citire24 de instrumente

ping

read_onlygratuit

Verificare de funcționare: returnează pong

get_server_info

read_onlygratuit

Returnează informații de bază despre server

echo

read_onlygratuit

Returnează apelantului mesajul primit

get_my_profile

read_onlygratuit

Obține profilul complet al utilizatorului autentificat

get_balances

read_onlygratuit

Obține soldul contului Hedera pentru toate tokenurile platformei sau pentru un anumit token

get_exchange_rate

read_onlygratuit

Obține cursurile de schimb live de cumpărare/vânzare pentru o monedă

list_supported_currencies

read_onlygratuit

Listează toate monedele acceptate, cu comisioanele lor dinamice

list_available_tokens

read_onlygratuit

Listează toate tokenurile Hedera disponibile pe platformă

get_transaction_history

read_onlygratuit

Obține istoricul tranzacțiilor pe categorii, cu filtre

get_my_limits

read_onlygratuit

Obține limitele configurate și utilizarea curentă pentru cheia API autentificată

estimate_swap_fees

read_onlygratuit

Estimează comisioanele unui schimb valutar înainte de executare

get_agent_config

read_onlygratuit

Caută configurația agentului altui utilizator

check_approval_status

read_onlygratuit

Verifică starea unei cereri de aprobare a unei tranzacții de agent în așteptare

get_kyc_status

read_onlygratuit

Obține starea verificării KYC a unui utilizator prin Sumsub

get_deposit_status

read_onlygratuit

Obține starea unei depuneri fiat după ID-ul transferului

get_withdrawal_status

read_onlygratuit

Obține cererile de retragere ale unui utilizator prin Brale

get_escrow_balances

read_onlygratuit

Obține detalierea soldului escrow: total, disponibil și blocat

get_escrow_history

read_onlygratuit

Obține istoricul complet al tranzacțiilor escrow, inclusiv blocări, eliberări, câștiguri și pierderi

list_offers

read_onlygratuit

Explorează piața de predicții pentru oferte active, cu statistici de tranzacționare

get_offer

read_onlygratuit

Obține detaliile complete ale unei oferte, inclusiv statisticile de tranzacționare

get_my_offers

read_onlygratuit

Obține toate ofertele create de un anumit utilizator

list_trades

read_onlygratuit

Listează toate tranzacțiile de pe platformă, cu filtre

get_trade

read_onlygratuit

Obține detaliile complete ale unei tranzacții, inclusiv statisticile ofertei părinte

get_my_trades

read_onlygratuit

Obține toate tranzacțiile unui utilizator, atât create, cât și primite

Transfer2 instrumente

request_transfer_otp

transfer0.3%

Pasul 1: solicită un cod de verificare OTP trimis pe emailul expeditorului

transfer_tokens

transfer0.3%

Pasul 2: execută transferul de tokenuri cu verificare OTP

Schimb1 instrument

swap_currency

swap0.5%

Schimbă între două tokenuri Hedera, cu cursul și comisioanele calculate automat

Fiat3 instrumente

initiate_kyc

fiat

Inițiază verificarea KYC: returnează un token de acces Sumsub pentru SDK

initiate_deposit

fiat

Inițiază o depunere fiat prin Brale (necesită KYC)

request_withdrawal

fiat

Solicită o retragere fiat prin Brale (necesită KYC)

Oferte și tranzacții6 instrumente

create_offer

offers

Creează o ofertă pe piața de predicții care blochează suma totală în escrow

update_offer

offers

Editează o ofertă existentă (doar dacă nu există tranzacții)

delist_offer

offers

Retrage oferta din piață și eliberează escrow-ul blocat

delete_offer

offers

Șterge definitiv oferta (blocat dacă există tranzacții active)

engage_offer

offers

Participă la o ofertă deschisă prin blocarea unui escrow corespunzător

cancel_trade

offers

Anulează o tranzacție activă și eliberează escrow-ul blocat

De la agent la agent3 instrumente

request_agent_transaction

transfer

Solicită o tranzacție în numele agentului altui utilizator (necesită aprobare prin email)

execute_approved_transaction

transfer

Execută o tranzacție de agent aprobată anterior folosind tokenul de execuție

update_my_agent_settings

read_onlygratuit

Controlează dacă tranzacțiile de la agent la agent necesită aprobare prin email și OTP

Doar sandbox1 instrument

reset_sandbox_balance

read_onlygratuit

Resetează soldurile sandbox la valorile implicite prealimentate (doar sandbox)

Rate API

Operațiuni avansate cu cursuri valutare prin REST. Necesită o cheie API cu domeniul rate.

Instrumentul MCP sau Rate API: care este diferența?

Serverul MCP include deja get_exchange_rate ca instrument read_only: agentul îl poate apela direct pentru a obține cursul de cumpărare/vânzare al unei monede față de USD. Acesta acoperă majoritatea cazurilor de utilizare ale agenților.

Rate API merge mai departe: conversii între perechi, operațiuni în lot, serii istorice și rezumate statistice. Acestea sunt disponibile ca endpointuri HTTP directe, autentificate cu o cheie API cu domeniul rate. Creați o cheie rate din panoul contului.

Autentificare

Toate endpointurile Rate API necesită o cheie API cu domeniul rate, transmisă în antetul x-api-key. Echivalentele sandbox sunt disponibile la /mcp/sandbox/rate/* și folosesc cheia sandbox (bc_test_...) cu cursuri simulate fixe pentru teste reproductibile.

URL de bază

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

GET/mcp/rate/currenciesListează toate monedele acceptate

Listează toate monedele acceptate

Exemplu de cerere

bash

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

Exemplu de răspuns

json

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

GET/mcp/rate/currentObține cursul de schimb curent între două monede

Obține cursul de schimb curent între două monede

Parametri

Nume	Obligatoriu	Descriere
`from`	obligatoriu	Codul monedei sursă (de ex. USD)
`to`	obligatoriu	Codul monedei țintă (de ex. NGN)

Exemplu de cerere

bash

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

Exemplu de răspuns

json

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

GET/mcp/rate/convertConvertește o sumă dintr-o monedă în alta

Convertește o sumă dintr-o monedă în alta

Parametri

Nume	Obligatoriu	Descriere
`from`	obligatoriu	Codul monedei sursă
`to`	obligatoriu	Codul monedei țintă
`amount`	obligatoriu	Suma de convertit (număr)

Exemplu de cerere

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"

Exemplu de răspuns

json

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

POST/mcp/rate/batch-convertConvertește mai multe sume într-o singură cerere (max. 100)

Convertește mai multe sume într-o singură cerere (max. 100)

Exemplu de cerere

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

Exemplu de răspuns

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/historyObține cursurile de schimb istorice pentru o pereche de monede

Obține cursurile de schimb istorice pentru o pereche de monede

Parametri

Nume	Obligatoriu	Descriere
`from`	obligatoriu	Codul monedei sursă
`to`	obligatoriu	Codul monedei țintă
`startDate`	obligatoriu	Data de început (ISO 8601, de ex. 2026-04-01)
`endDate`	obligatoriu	Data de sfârșit (ISO 8601, de ex. 2026-04-30)

Exemplu de cerere

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"

Exemplu de răspuns

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/statsObține statistici ale cursului (maxim, minim, medie, cel mai recent) pe o perioadă

Obține statistici ale cursului (maxim, minim, medie, cel mai recent) pe o perioadă

Parametri

Nume	Obligatoriu	Descriere
`from`	obligatoriu	Codul monedei sursă
`to`	obligatoriu	Codul monedei țintă
`days`	opțional	Perioada în zile, de la 1 la 365 (implicit: 30)

Exemplu de cerere

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"

Exemplu de răspuns

json

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

Rate API în sandbox

Înlocuiți /mcp/rate/ cu /mcp/sandbox/rate/ și folosiți cheia sandbox pentru a obține cursuri simulate fixe. Datele istorice sunt generate cu o variație de ±2% pentru teste realiste. Nu se folosesc date reale de schimb.

Mediul sandbox

Testați integrarea în siguranță, cu solduri prealimentate și fără bani reali.

Ce este sandboxul?

Sandboxul este un mediu de testare complet izolat care reproduce exact producția, cu aceleași instrumente, același API și același format de răspuns. Nu se mișcă bani reali. Cheile API sandbox încep cu bc_test_ și se conectează la Hedera testnet.

Solduri prealimentate

Fiecare cont sandbox pornește cu aceste solduri. Folosiți reset_sandbox_balance pentru a le restabili oricând.

Token	Sumă	Monedă
`USDb`	10,000	USD
`NGNb`	5,000,000	NGN
`GHSb`	50,000	GHS
`KESb`	1,000,000	KES
`ZARb`	150,000	ZAR

Sandbox comparat cu live

Funcție	Sandbox	Live
Se mișcă bani reali	Nu: doar simulat	Da
Verificare OTP	Returnat în răspunsul API	Trimis pe email
KYC obligatoriu pentru fiat	Nu	Da
Limite de cheltuieli aplicate	Da (configurabile)	Da
Prefix cheie API	bc_test_...	bc_live_...
Decontare Hedera	Testnet	Mainnet
Solduri prealimentate	Da (resetabile oricând)	Nu
Limite de rată	Relaxate	În funcție de plan

OTP în sandbox

În modul sandbox, codul OTP este returnat direct în răspunsul API request_transfer_otp, în loc să fie trimis pe email. Astfel, testarea automată este ușoară, fără acces la email.

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

Configurare

Conectați BananaCrystal la instrumentul sau frameworkul AI preferat.

claude_desktop_config.json

json

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

Variabile de mediu

BANANACRYSTAL_API_KEYobligatoriu

Cheia dvs. API MCP. Cheile sandbox încep cu bc_test_, cheile live cu bc_live_.

Implicit: N/A

BANANACRYSTAL_API_URLopțional

Suprascrie URL-ul endpointului MCP. Folosiți URL-ul sandbox pentru testare.

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

DEBUGopțional

Setați la true pentru a activa jurnalizarea detaliată a cererilor și răspunsurilor.

Implicit: false

Variabilă	Obligatoriu	Implicit	Descriere
`BANANACRYSTAL_API_KEY`	obligatoriu	`N/A`	Cheia dvs. API MCP. Cheile sandbox încep cu bc_test_, cheile live cu bc_live_.
`BANANACRYSTAL_API_URL`	opțional	`https://agentic.bananacrystal.com/mcp`	Suprascrie URL-ul endpointului MCP. Folosiți URL-ul sandbox pentru testare.
`DEBUG`	opțional	`false`	Setați la true pentru a activa jurnalizarea detaliată a cererilor și răspunsurilor.

Integrări cu frameworkuri

Exemple gata de rulat pentru cele mai populare frameworkuri de agenți AI.

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

Funcționează orice framework compatibil MCP. Dacă frameworkul dvs. acceptă servere MCP bazate pe HTTP, direcționați-l către https://agentic.bananacrystal.com/mcp cu cheia API ca token Bearer.

Arhitectura de securitate

Mai multe straturi de protecție, astfel încât agentul să poată face doar ce autorizați explicit.

Domeniile cheilor API

Fiecare cheie API are domenii de permisiuni explicite. Un agent poate efectua doar operațiuni din domeniile pe care le acordați.

Limite de cheltuieli

Setați maxime stricte per tranzacție și plafoane zilnice glisante pe 24 de ore pentru fiecare cheie API. Acestea sunt aplicate la nivelul infrastructurii.

Verificare OTP

Fiecare transfer de tokenuri necesită un OTP din 6 cifre trimis pe emailul înregistrat. Agentul nu poate finaliza un transfer fără ca dvs. să furnizați acel cod.

Limitarea ratei

Plafoanele de rată per cheie și pe minut împiedică agenții scăpați de sub control să suprasolicite API-ul. Limitele cresc odată cu nivelul planului.

Istoric de audit imuabil

Fiecare apel de instrument este scris în stratul de consens Hedera. Apelurile au marcaj temporal, nu pot fi falsificate și pot fi verificate public on-chain. Istoricul complet de audit este disponibil prin get_transaction_history.

Flux de aprobare pentru agenți

Tranzacțiile de la agent la agent pot necesita aprobare umană prin email înainte de executare. Folosiți update_my_agent_settings pentru a configura require_human_approval.

Domeniile cheilor API

read_only

Verificarea soldurilor, cursurilor, istoricului și limitelor fără a muta fonduri

transfer

Trimiterea de tokenuri către alte conturi (necesită OTP)

swap

Schimbul între stablecoinuri în diferite monede

fiat

Depuneri și retrageri fiat (necesită KYC)

offers

Crearea și gestionarea ofertelor și tranzacțiilor pe piața de predicții

rate

Acces la cursuri de schimb, date istorice, conversii și statistici ale cursurilor

Domeniu	Ce permite
read_only	Verificarea soldurilor, cursurilor, istoricului și limitelor fără a muta fonduri
transfer	Trimiterea de tokenuri către alte conturi (necesită OTP)
swap	Schimbul între stablecoinuri în diferite monede
fiat	Depuneri și retrageri fiat (necesită KYC)
offers	Crearea și gestionarea ofertelor și tranzacțiilor pe piața de predicții
rate	Acces la cursuri de schimb, date istorice, conversii și statistici ale cursurilor

Prețuri

Operațiunile doar de citire sunt mereu gratuite. Plătiți doar pentru tranzacțiile care mută valoare.

Comisioane pe operațiune

Operațiuni doar de citire

get_balances, get_exchange_rate, list_trades, …

Gratuit

Transferuri de tokenuri

transfer_tokens

0.3%

Schimburi valutare

swap_currency

0.5%

Depuneri fiat

initiate_deposit

Variază în funcție de canal

Retrageri fiat

request_withdrawal

Variază în funcție de canal

Piața de predicții

create_offer, engage_offer

Comision de platformă la decontare

Operațiune	Instrumente	Comision
Operațiuni doar de citire	get_balances, get_exchange_rate, list_trades, …	Gratuit
Transferuri de tokenuri	transfer_tokens	0.3%
Schimburi valutare	swap_currency	0.5%
Depuneri fiat	initiate_deposit	Variază în funcție de canal
Retrageri fiat	request_withdrawal	Variază în funcție de canal
Piața de predicții	create_offer, engage_offer	Comision de platformă la decontare