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-documentatie | 40 betaaltools voor AI-agents

Snel aan de slag

Laat uw AI-agent binnen 5 minuten betalingen doen.

Installeer de MCP-server

Installeer de BananaCrystal MCP-server globaal via npm.

bash

npm install -g @bananacrystal/mcp-server

Vraag uw API-sleutel aan

Maak een MCP-API-sleutel aan in uw accountdashboard. Sandboxsleutels beginnen met bc_test_ en zijn gratis.

API-sleutel aanvragen

Sandboxsleutels: bc_test_...

Configureer Claude Desktop

Voeg BananaCrystal toe aan het configuratiebestand van Claude Desktop.

claude_desktop_config.json

json

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

Vraag het uw agent

Uw agent heeft nu 40 betaaltools. Probeer deze prompts:

›"Wat is mijn huidige USDb-saldo?"

›"Stuur 50 USDb naar 0.0.654321"

›"Wissel 100 USDb naar NGNb tegen de huidige koers"

›"Toon mijn laatste 10 transacties"

›"Wat is de huidige wisselkoers van USD naar NGN?"

MCP-tools

40 productieklare betaaltools in 6 categorieën. Alleen-lezen bewerkingen zijn altijd gratis.

Alleen lezen24 tools

ping

read_onlygratis

Statuscontrole: geeft pong terug

get_server_info

read_onlygratis

Geeft basisinformatie over de server terug

echo

read_onlygratis

Stuurt het invoerbericht terug naar de aanroeper

get_my_profile

read_onlygratis

Haal het volledige profiel van de geauthenticeerde gebruiker op

get_balances

read_onlygratis

Haal het Hedera-accountsaldo op voor alle platformtokens of een specifieke token

get_exchange_rate

read_onlygratis

Haal live aankoop-/verkoopkoersen voor een valuta op

list_supported_currencies

read_onlygratis

Toon alle ondersteunde valuta met hun dynamische kosten

list_available_tokens

read_onlygratis

Toon alle beschikbare Hedera-tokens voor het platform

get_transaction_history

read_onlygratis

Haal gecategoriseerde transactiegeschiedenis op met filters

get_my_limits

read_onlygratis

Haal ingestelde limieten en actueel gebruik op voor de geauthenticeerde API-sleutel

estimate_swap_fees

read_onlygratis

Schat de kosten van een valutawissel vóór uitvoering

get_agent_config

read_onlygratis

Zoek de agentconfiguratie van een andere gebruiker op

check_approval_status

read_onlygratis

Controleer de status van een openstaand goedkeuringsverzoek voor een agenttransactie

get_kyc_status

read_onlygratis

Haal de KYC-verificatiestatus van een gebruiker op via Sumsub

get_deposit_status

read_onlygratis

Haal de status van een fiat-storting op via transfer-ID

get_withdrawal_status

read_onlygratis

Haal opnameverzoeken van een gebruiker op via Brale

get_escrow_balances

read_onlygratis

Haal de opbouw van het escrowsaldo op: totaal, beschikbaar en vastgezet

get_escrow_history

read_onlygratis

Haal de volledige escrowgeschiedenis op, inclusief vastzettingen, vrijgaven, winsten en verliezen

list_offers

read_onlygratis

Bekijk actieve aanbiedingen op de voorspellingsmarkt met transactiestatistieken

get_offer

read_onlygratis

Haal de volledige details van één aanbod op, inclusief transactiestatistieken

get_my_offers

read_onlygratis

Haal alle aanbiedingen op die door een specifieke gebruiker zijn gemaakt

list_trades

read_onlygratis

Toon alle transacties op het platform met filters

get_trade

read_onlygratis

Haal de volledige details van één transactie op, inclusief statistieken van het bovenliggende aanbod

get_my_trades

read_onlygratis

Haal alle transacties van een gebruiker op, zowel aangemaakt als ontvangen

Overmaken2 tools

request_transfer_otp

transfer0.3%

Stap 1: vraag een OTP-verificatiecode aan die naar het e-mailadres van de afzender wordt gestuurd

transfer_tokens

transfer0.3%

Stap 2: voer de tokenoverboeking uit met OTP-verificatie

Wisselen1 tool

swap_currency

swap0.5%

Wissel tussen twee Hedera-tokens waarbij koers en kosten automatisch worden berekend

Fiat3 tools

initiate_kyc

fiat

Start KYC-verificatie: geeft een Sumsub-toegangstoken voor de SDK terug

initiate_deposit

fiat

Start een fiat-storting via Brale (KYC vereist)

request_withdrawal

fiat

Vraag een fiat-opname aan via Brale (KYC vereist)

Aanbiedingen en transacties6 tools

create_offer

offers

Maak een aanbod op de voorspellingsmarkt dat het totaalbedrag in escrow vastzet

update_offer

offers

Bewerk een bestaand aanbod (alleen als er geen transacties zijn)

delist_offer

offers

Haal uw aanbod van de marktplaats en geef vastgezet escrow vrij

delete_offer

offers

Verwijder uw aanbod definitief (geblokkeerd als er actieve transacties zijn)

engage_offer

offers

Ga in op een open aanbod door een gelijk bedrag in escrow vast te zetten

cancel_trade

offers

Annuleer een actieve transactie en geef uw vastgezette escrow vrij

Agent-naar-agent3 tools

request_agent_transaction

transfer

Vraag een transactie aan namens de agent van een andere gebruiker (vereist goedkeuring per e-mail)

execute_approved_transaction

transfer

Voer een eerder goedgekeurde agenttransactie uit met de uitvoeringstoken

update_my_agent_settings

read_onlygratis

Bepaal of agent-naar-agenttransacties goedkeuring per e-mail en OTP vereisen

Alleen sandbox1 tool

reset_sandbox_balance

read_onlygratis

Zet sandboxsaldi terug naar vooraf ingestelde standaardwaarden (alleen sandbox)

Rate API

Geavanceerde koersbewerkingen via REST. Vereist een API-sleutel met rate-scope.

MCP-tool versus Rate API: wat is het verschil?

De MCP-server bevat al get_exchange_rate als read_only-tool: uw agent kan deze direct aanroepen om de aankoop-/verkoopkoers van één valuta ten opzichte van USD op te halen. Dat dekt de meeste toepassingen van agents.

De Rate API gaat verder: omrekeningen tussen paren, batchbewerkingen, historische tijdreeksen en statistische samenvattingen. Deze zijn beschikbaar als directe HTTP-endpoints, geauthenticeerd met een API-sleutel met rate-scope. Maak een rate-sleutel aan in uw accountdashboard.

Authenticatie

Alle Rate API-endpoints vereisen een API-sleutel met rate-scope in de header x-api-key. De sandboxvarianten zijn beschikbaar op /mcp/sandbox/rate/* en gebruiken uw sandboxsleutel (bc_test_...) met vaste nepkoersen voor reproduceerbare tests.

Basis-URL

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

GET/mcp/rate/currenciesToon alle ondersteunde valuta

Toon alle ondersteunde valuta

Voorbeeldverzoek

bash

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

Voorbeeldantwoord

json

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

GET/mcp/rate/currentHaal de huidige wisselkoers tussen twee valuta op

Haal de huidige wisselkoers tussen twee valuta op

Parameters

Naam	Verplicht	Omschrijving
`from`	verplicht	Code bronvaluta (bijv. USD)
`to`	verplicht	Code doelvaluta (bijv. NGN)

Voorbeeldverzoek

bash

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

Voorbeeldantwoord

json

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

GET/mcp/rate/convertReken een bedrag om van de ene valuta naar de andere

Reken een bedrag om van de ene valuta naar de andere

Parameters

Naam	Verplicht	Omschrijving
`from`	verplicht	Code bronvaluta
`to`	verplicht	Code doelvaluta
`amount`	verplicht	Om te rekenen bedrag (getal)

Voorbeeldverzoek

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"

Voorbeeldantwoord

json

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

POST/mcp/rate/batch-convertReken meerdere bedragen in één verzoek om (max. 100)

Reken meerdere bedragen in één verzoek om (max. 100)

Voorbeeldverzoek

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

Voorbeeldantwoord

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/historyHaal historische wisselkoersen voor een valutapaar op

Haal historische wisselkoersen voor een valutapaar op

Parameters

Naam	Verplicht	Omschrijving
`from`	verplicht	Code bronvaluta
`to`	verplicht	Code doelvaluta
`startDate`	verplicht	Begindatum (ISO 8601, bijv. 2026-04-01)
`endDate`	verplicht	Einddatum (ISO 8601, bijv. 2026-04-30)

Voorbeeldverzoek

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"

Voorbeeldantwoord

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/statsHaal koersstatistieken (hoogste, laagste, gemiddelde, laatste) over een periode op

Haal koersstatistieken (hoogste, laagste, gemiddelde, laatste) over een periode op

Parameters

Naam	Verplicht	Omschrijving
`from`	verplicht	Code bronvaluta
`to`	verplicht	Code doelvaluta
`days`	optioneel	Periode in dagen, 1 tot 365 (standaard: 30)

Voorbeeldverzoek

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"

Voorbeeldantwoord

json

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

Sandbox Rate API

Vervang /mcp/rate/ door /mcp/sandbox/rate/ en gebruik uw sandboxsleutel voor vaste nepkoersen. Historische gegevens worden gegenereerd met ±2% variatie voor realistische tests. Er worden geen echte koersgegevens gebruikt.

Sandboxomgeving

Test uw integratie veilig met vooraf gevulde saldi en zonder echt geld.

Wat is de sandbox?

De sandbox is een volledig geïsoleerde testomgeving die precies gelijk is aan productie, met dezelfde tools, dezelfde API en hetzelfde antwoordformaat. Er wordt geen echt geld verplaatst. Sandbox-API-sleutels beginnen met bc_test_ en maken verbinding met het Hedera-testnet.

Vooraf gevulde saldi

Elk sandboxaccount begint met deze saldi. Gebruik reset_sandbox_balance om ze op elk moment te herstellen.

Token	Bedrag	Valuta
`USDb`	10,000	USD
`NGNb`	5,000,000	NGN
`GHSb`	50,000	GHS
`KESb`	1,000,000	KES
`ZARb`	150,000	ZAR

Sandbox versus live

Functie	Sandbox	Live
Echt geld wordt verplaatst	Nee: alleen gesimuleerd	Ja
OTP-verificatie	Teruggegeven in API-antwoord	Verstuurd naar uw e-mail
KYC vereist voor fiat	Nee	Ja
Bestedingslimieten afgedwongen	Ja (instelbaar)	Ja
Voorvoegsel API-sleutel	bc_test_...	bc_live_...
Afwikkeling op Hedera	Testnet	Mainnet
Vooraf gevulde saldi	Ja (altijd te resetten)	Nee
Rate limits	Ruim	Per abonnement

OTP in de sandbox

In sandboxmodus wordt de OTP-code direct teruggegeven in het API-antwoord van request_transfer_otp in plaats van per e-mail verstuurd. Zo is geautomatiseerd testen eenvoudig, zonder toegang tot e-mail.

Sandboxconfiguratie

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

Configuratie

Koppel BananaCrystal aan uw favoriete AI-tool of -framework.

claude_desktop_config.json

json

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

Omgevingsvariabelen

BANANACRYSTAL_API_KEYverplicht

Uw MCP-API-sleutel. Sandboxsleutels beginnen met bc_test_, livesleutels met bc_live_.

Standaard: N/A

BANANACRYSTAL_API_URLoptioneel

Overschrijf de URL van het MCP-endpoint. Gebruik de sandbox-URL om te testen.

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

DEBUGoptioneel

Stel in op true voor uitgebreide logging van verzoeken en antwoorden.

Standaard: false

Variabele	Verplicht	Standaard	Omschrijving
`BANANACRYSTAL_API_KEY`	verplicht	`N/A`	Uw MCP-API-sleutel. Sandboxsleutels beginnen met bc_test_, livesleutels met bc_live_.
`BANANACRYSTAL_API_URL`	optioneel	`https://agentic.bananacrystal.com/mcp`	Overschrijf de URL van het MCP-endpoint. Gebruik de sandbox-URL om te testen.
`DEBUG`	optioneel	`false`	Stel in op true voor uitgebreide logging van verzoeken en antwoorden.

Framework-integraties

Direct bruikbare voorbeelden voor de populairste frameworks voor AI-agents.

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

Elk MCP-compatibel framework werkt. Als uw framework HTTP-gebaseerde MCP-servers ondersteunt, verwijs het dan naar https://agentic.bananacrystal.com/mcp met uw API-sleutel als Bearer-token.

Beveiligingsarchitectuur

Meerdere beschermingslagen, zodat uw agent alleen kan doen wat u uitdrukkelijk toestaat.

Scopes van API-sleutels

Elke API-sleutel heeft expliciete toegangsscopes. Een agent kan alleen bewerkingen uitvoeren binnen de scopes die u toekent.

Bestedingslimieten

Stel per API-sleutel harde maxima per transactie en voortschrijdende daglimieten over 24 uur in. Deze worden op infrastructuurniveau afgedwongen.

OTP-verificatie

Elke tokenoverboeking vereist een 6-cijferige OTP die naar uw geregistreerde e-mailadres wordt gestuurd. De agent kan geen overboeking voltooien zonder dat u die code geeft.

Rate limiting

Limieten per sleutel en per minuut voorkomen dat ontspoorde agents de API overbelasten. Limieten groeien mee met uw abonnement.

Onveranderlijk audittrail

Elke toolaanroep wordt vastgelegd in de consensuslaag van Hedera. Met tijdstempel, fraudebestendig en openbaar on-chain verifieerbaar. Volledige auditgeschiedenis beschikbaar via get_transaction_history.

Goedkeuringsflow voor agents

Agent-naar-agenttransacties kunnen goedkeuring per e-mail door een mens vereisen vóór uitvoering. Gebruik update_my_agent_settings om require_human_approval in te stellen.

Scopes van API-sleutels

read_only

Saldi, koersen, geschiedenis en limieten controleren zonder tegoed te verplaatsen

transfer

Tokens naar andere accounts versturen (vereist OTP)

swap

Wisselen tussen stablecoins van valuta

fiat

Fiat-stortingen en -opnames (vereist KYC)

offers

Aanbiedingen en transacties op de voorspellingsmarkt maken en beheren

rate

Toegang tot wisselkoersen, historische gegevens, omrekeningen en koersstatistieken

Scope	Wat het toestaat
read_only	Saldi, koersen, geschiedenis en limieten controleren zonder tegoed te verplaatsen
transfer	Tokens naar andere accounts versturen (vereist OTP)
swap	Wisselen tussen stablecoins van valuta
fiat	Fiat-stortingen en -opnames (vereist KYC)
offers	Aanbiedingen en transacties op de voorspellingsmarkt maken en beheren
rate	Toegang tot wisselkoersen, historische gegevens, omrekeningen en koersstatistieken

Prijzen

Alleen-lezen bewerkingen zijn altijd gratis. U betaalt alleen voor transacties die waarde verplaatsen.

Kosten per bewerking

Alleen-lezen bewerkingen

get_balances, get_exchange_rate, list_trades, …

Gratis

Tokenoverboekingen

transfer_tokens

0.3%

Valutawissels

swap_currency

0.5%

Fiat-stortingen

initiate_deposit

Verschilt per kanaal

Fiat-opnames

request_withdrawal

Verschilt per kanaal

Voorspellingsmarkt

create_offer, engage_offer

Platformkosten bij afwikkeling

Bewerking	Tools	Kosten
Alleen-lezen bewerkingen	get_balances, get_exchange_rate, list_trades, …	Gratis
Tokenoverboekingen	transfer_tokens	0.3%
Valutawissels	swap_currency	0.5%
Fiat-stortingen	initiate_deposit	Verschilt per kanaal
Fiat-opnames	request_withdrawal	Verschilt per kanaal
Voorspellingsmarkt	create_offer, engage_offer	Platformkosten bij afwikkeling