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-Dokumentation | 40 Zahlungstools für KI-Agenten

Schnellstart

Lassen Sie Ihren KI-Agenten in unter 5 Minuten Zahlungen ausführen.

MCP-Server installieren

Installieren Sie den BananaCrystal MCP-Server global über npm.

bash

npm install -g @bananacrystal/mcp-server

API-Schlüssel holen

Erstellen Sie in Ihrem Konto-Dashboard einen MCP-API-Schlüssel. Sandbox-Schlüssel beginnen mit bc_test_ und sind kostenlos.

API-Schlüssel holen

Sandbox-Schlüssel: bc_test_...

Claude Desktop konfigurieren

Fügen Sie BananaCrystal zur Konfigurationsdatei von Claude Desktop hinzu.

claude_desktop_config.json

json

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

Fragen Sie Ihren Agenten

Ihr Agent hat jetzt 40 Zahlungstools. Probieren Sie diese Prompts aus:

›"Wie hoch ist mein aktuelles USDb-Guthaben?"

›"Sende 50 USDb an 0.0.654321"

›"Tausche 100 USDb zum aktuellen Kurs in NGNb"

›"Zeige mir meine letzten 10 Transaktionen"

›"Wie ist der aktuelle Wechselkurs von USD zu NGN?"

MCP-Tools

40 produktionsreife Zahlungstools in 6 Kategorien. Lesezugriffe sind immer kostenlos.

Nur Lesen24 Tools

ping

read_onlykostenlos

Statusprüfung: gibt pong zurück

get_server_info

read_onlykostenlos

Gibt grundlegende Serverinformationen zurück

echo

read_onlykostenlos

Gibt die Eingabenachricht an den Aufrufer zurück

get_my_profile

read_onlykostenlos

Vollständiges Profil des authentifizierten Nutzers abrufen

get_balances

read_onlykostenlos

Hedera-Kontoguthaben für alle Plattform-Tokens oder einen bestimmten Token abrufen

get_exchange_rate

read_onlykostenlos

Live-Kauf- und Verkaufskurse für eine Währung abrufen

list_supported_currencies

read_onlykostenlos

Alle unterstützten Währungen mit ihren dynamischen Gebühren auflisten

list_available_tokens

read_onlykostenlos

Alle verfügbaren Hedera-Tokens der Plattform auflisten

get_transaction_history

read_onlykostenlos

Kategorisierten Transaktionsverlauf mit Filtern abrufen

get_my_limits

read_onlykostenlos

Konfigurierte Limits und aktuelle Nutzung des authentifizierten API-Schlüssels abrufen

estimate_swap_fees

read_onlykostenlos

Gebühren für einen Währungstausch vor der Ausführung schätzen

get_agent_config

read_onlykostenlos

Agentenkonfiguration eines anderen Nutzers abrufen

check_approval_status

read_onlykostenlos

Status einer ausstehenden Freigabeanfrage für eine Agententransaktion prüfen

get_kyc_status

read_onlykostenlos

KYC-Verifizierungsstatus eines Nutzers über Sumsub abrufen

get_deposit_status

read_onlykostenlos

Status einer Fiat-Einzahlung anhand der Überweisungs-ID abrufen

get_withdrawal_status

read_onlykostenlos

Auszahlungsanfragen eines Nutzers über Brale abrufen

get_escrow_balances

read_onlykostenlos

Aufschlüsselung des Treuhandguthabens abrufen: gesamt, verfügbar und gesperrt

get_escrow_history

read_onlykostenlos

Vollständigen Treuhand-Transaktionsverlauf abrufen, inklusive Sperren, Freigaben, Gewinnen und Verlusten

list_offers

read_onlykostenlos

Prognosemarkt nach aktiven Angeboten mit Handelsstatistiken durchsuchen

get_offer

read_onlykostenlos

Vollständige Details eines einzelnen Angebots inklusive Handelsstatistiken abrufen

get_my_offers

read_onlykostenlos

Alle Angebote eines bestimmten Nutzers abrufen

list_trades

read_onlykostenlos

Alle Trades auf der Plattform mit Filtern auflisten

get_trade

read_onlykostenlos

Vollständige Details eines einzelnen Trades inklusive Statistiken des zugehörigen Angebots abrufen

get_my_trades

read_onlykostenlos

Alle Trades eines Nutzers abrufen, erstellte und erhaltene

Überweisung2 Tools

request_transfer_otp

transfer0.3%

Schritt 1: OTP-Bestätigungscode an die E-Mail-Adresse des Absenders anfordern

transfer_tokens

transfer0.3%

Schritt 2: Token-Überweisung mit OTP-Verifizierung ausführen

Swap1 Tool

swap_currency

swap0.5%

Zwischen zwei Hedera-Tokens tauschen, Kurs und Gebühren werden automatisch berechnet

Fiat3 Tools

initiate_kyc

fiat

KYC-Verifizierung starten: gibt ein Sumsub-Zugriffstoken für das SDK zurück

initiate_deposit

fiat

Fiat-Einzahlung über Brale veranlassen (KYC erforderlich)

request_withdrawal

fiat

Fiat-Auszahlung über Brale anfordern (KYC erforderlich)

Angebote und Trades6 Tools

create_offer

offers

Angebot auf dem Prognosemarkt erstellen, das den Gesamtbetrag auf Treuhand sperrt

update_offer

offers

Bestehendes Angebot bearbeiten (nur wenn keine Trades vorhanden sind)

delist_offer

offers

Eigenes Angebot vom Marktplatz nehmen und gesperrtes Treuhandguthaben freigeben

delete_offer

offers

Eigenes Angebot dauerhaft löschen (gesperrt, wenn aktive Trades vorhanden sind)

engage_offer

offers

Offenes Angebot annehmen und passendes Treuhandguthaben sperren

cancel_trade

offers

Aktiven Trade stornieren und Ihr gesperrtes Treuhandguthaben freigeben

Agent-zu-Agent3 Tools

request_agent_transaction

transfer

Transaktion im Namen des Agenten eines anderen Nutzers anfordern (erfordert Freigabe per E-Mail)

execute_approved_transaction

transfer

Zuvor freigegebene Agententransaktion mit dem Ausführungstoken ausführen

update_my_agent_settings

read_onlykostenlos

Festlegen, ob Agent-zu-Agent-Transaktionen eine Freigabe per E-Mail und OTP erfordern

Nur Sandbox1 Tool

reset_sandbox_balance

read_onlykostenlos

Sandbox-Guthaben auf die vorab befüllten Standardwerte zurücksetzen (nur Sandbox)

Rate API

Erweiterte Wechselkursfunktionen über REST. Erfordert einen API-Schlüssel mit Rate-Scope.

MCP-Tool oder Rate API: Was ist der Unterschied?

Der MCP-Server enthält bereits get_exchange_rate als read_only-Tool: Ihr Agent kann es direkt aufrufen, um den Kauf- und Verkaufskurs einer Währung gegen USD abzurufen. Das deckt die meisten Anwendungsfälle von Agenten ab.

Die Rate API geht weiter: Umrechnungen zwischen Währungspaaren, Stapelverarbeitung, historische Zeitreihen und statistische Auswertungen. Diese stehen als direkte HTTP-Endpunkte zur Verfügung, authentifiziert mit einem API-Schlüssel mit rate-Scope. Erstellen Sie einen Rate-Schlüssel in Ihrem Konto-Dashboard.

Authentifizierung

Alle Endpunkte der Rate API erfordern einen API-Schlüssel mit rate-Scope im Header x-api-key. Die Sandbox-Entsprechungen finden Sie unter /mcp/sandbox/rate/*; sie nutzen Ihren Sandbox-Schlüssel (bc_test_...) mit festen Testkursen für reproduzierbare Tests.

Basis-URL

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

GET/mcp/rate/currenciesAlle unterstützten Währungen auflisten

Alle unterstützten Währungen auflisten

Beispielanfrage

bash

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

Beispielantwort

json

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

GET/mcp/rate/currentAktuellen Wechselkurs zwischen zwei Währungen abrufen

Aktuellen Wechselkurs zwischen zwei Währungen abrufen

Parameter

Name	Erforderlich	Beschreibung
`from`	erforderlich	Code der Ausgangswährung (z. B. USD)
`to`	erforderlich	Code der Zielwährung (z. B. NGN)

Beispielanfrage

bash

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

Beispielantwort

json

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

GET/mcp/rate/convertEinen Betrag von einer Währung in eine andere umrechnen

Einen Betrag von einer Währung in eine andere umrechnen

Parameter

Name	Erforderlich	Beschreibung
`from`	erforderlich	Code der Ausgangswährung
`to`	erforderlich	Code der Zielwährung
`amount`	erforderlich	Umzurechnender Betrag (Zahl)

Beispielanfrage

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"

Beispielantwort

json

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

POST/mcp/rate/batch-convertMehrere Beträge in einer Anfrage umrechnen (max. 100)

Mehrere Beträge in einer Anfrage umrechnen (max. 100)

Beispielanfrage

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

Beispielantwort

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/historyHistorische Wechselkurse für ein Währungspaar abrufen

Historische Wechselkurse für ein Währungspaar abrufen

Parameter

Name	Erforderlich	Beschreibung
`from`	erforderlich	Code der Ausgangswährung
`to`	erforderlich	Code der Zielwährung
`startDate`	erforderlich	Startdatum (ISO 8601, z. B. 2026-04-01)
`endDate`	erforderlich	Enddatum (ISO 8601, z. B. 2026-04-30)

Beispielanfrage

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"

Beispielantwort

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/statsKursstatistiken (Hoch, Tief, Durchschnitt, Aktuell) für einen Zeitraum abrufen

Kursstatistiken (Hoch, Tief, Durchschnitt, Aktuell) für einen Zeitraum abrufen

Parameter

Name	Erforderlich	Beschreibung
`from`	erforderlich	Code der Ausgangswährung
`to`	erforderlich	Code der Zielwährung
`days`	optional	Zeitraum in Tagen, 1 bis 365 (Standard: 30)

Beispielanfrage

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"

Beispielantwort

json

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

Sandbox-Rate-API

Ersetzen Sie /mcp/rate/ durch /mcp/sandbox/rate/ und verwenden Sie Ihren Sandbox-Schlüssel, um feste Testkurse zu erhalten. Historische Daten werden für realistische Tests mit ±2% Schwankung erzeugt. Es werden keine echten Kursdaten verwendet.

Sandbox-Umgebung

Testen Sie Ihre Integration sicher mit vorab befüllten Guthaben und ohne echtes Geld.

Was ist die Sandbox?

Die Sandbox ist eine vollständig isolierte Testumgebung, die die Produktion exakt abbildet, mit denselben Tools, derselben API und demselben Antwortformat. Es wird kein echtes Geld bewegt. Sandbox-API-Schlüssel beginnen mit bc_test_ und verbinden sich mit dem Hedera Testnet.

Vorab befüllte Guthaben

Jedes Sandbox-Konto startet mit diesen Guthaben. Mit reset_sandbox_balance stellen Sie sie jederzeit wieder her.

Token	Betrag	Währung
`USDb`	10,000	USD
`NGNb`	5,000,000	NGN
`GHSb`	50,000	GHS
`KESb`	1,000,000	KES
`ZARb`	150,000	ZAR

Sandbox und Live im Vergleich

Funktion	Sandbox	Live
Echtes Geld wird bewegt	Nein: nur simuliert	Ja
OTP-Verifizierung	In der API-Antwort enthalten	An Ihre E-Mail-Adresse gesendet
KYC für Fiat erforderlich	Nein	Ja
Ausgabelimits aktiv	Ja (konfigurierbar)	Ja
Präfix des API-Schlüssels	bc_test_...	bc_live_...
Abwicklung auf Hedera	Testnet	Mainnet
Vorab befüllte Guthaben	Ja (jederzeit zurücksetzbar)	Nein
Rate Limits	Gelockert	Je nach Tarif

OTP in der Sandbox

Im Sandbox-Modus wird der OTP-Code direkt in der API-Antwort von request_transfer_otp zurückgegeben, statt per E-Mail gesendet zu werden. So sind automatisierte Tests ohne E-Mail-Zugriff einfach.

Sandbox-Konfiguration

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

Konfiguration

Verbinden Sie BananaCrystal mit Ihrem bevorzugten KI-Tool oder Framework.

claude_desktop_config.json

json

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

Umgebungsvariablen

BANANACRYSTAL_API_KEYerforderlich

Ihr MCP-API-Schlüssel. Sandbox-Schlüssel beginnen mit bc_test_, Live-Schlüssel mit bc_live_.

Standard: N/A

BANANACRYSTAL_API_URLoptional

Überschreibt die URL des MCP-Endpunkts. Verwenden Sie zum Testen die Sandbox-URL.

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

DEBUGoptional

Auf true setzen, um ausführliches Logging von Anfragen und Antworten zu aktivieren.

Standard: false

Variable	Erforderlich	Standard	Beschreibung
`BANANACRYSTAL_API_KEY`	erforderlich	`N/A`	Ihr MCP-API-Schlüssel. Sandbox-Schlüssel beginnen mit bc_test_, Live-Schlüssel mit bc_live_.
`BANANACRYSTAL_API_URL`	optional	`https://agentic.bananacrystal.com/mcp`	Überschreibt die URL des MCP-Endpunkts. Verwenden Sie zum Testen die Sandbox-URL.
`DEBUG`	optional	`false`	Auf true setzen, um ausführliches Logging von Anfragen und Antworten zu aktivieren.

Framework-Integrationen

Sofort lauffähige Beispiele für die beliebtesten KI-Agenten-Frameworks.

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

Jedes MCP-kompatible Framework funktioniert. Wenn Ihr Framework HTTP-basierte MCP-Server unterstützt, verweisen Sie es auf https://agentic.bananacrystal.com/mcp, mit Ihrem API-Schlüssel als Bearer-Token.

Sicherheitsarchitektur

Mehrere Schutzebenen, damit Ihr Agent nur tun kann, was Sie ausdrücklich erlauben.

Scopes für API-Schlüssel

Jeder API-Schlüssel hat ausdrückliche Berechtigungs-Scopes. Ein Agent kann nur Vorgänge innerhalb der Scopes ausführen, die Sie vergeben.

Ausgabelimits

Legen Sie pro API-Schlüssel feste Höchstbeträge pro Transaktion und rollierende Tagesgrenzen über 24 Stunden fest. Diese werden auf Infrastrukturebene durchgesetzt.

OTP-Verifizierung

Jede Token-Überweisung erfordert einen 6-stelligen OTP, der an Ihre registrierte E-Mail-Adresse gesendet wird. Ohne diesen Code von Ihnen kann der Agent keine Überweisung abschließen.

Rate Limiting

Obergrenzen pro Schlüssel und Minute verhindern, dass außer Kontrolle geratene Agenten die API überlasten. Die Limits richten sich nach Ihrem Tarif.

Unveränderlicher Prüfpfad

Jeder Tool-Aufruf wird in die Konsensschicht von Hedera geschrieben. Die Einträge haben einen Zeitstempel, sind manipulationssicher und on-chain öffentlich überprüfbar. Der vollständige Prüfverlauf ist über get_transaction_history verfügbar.

Freigabeablauf für Agenten

Agent-zu-Agent-Transaktionen können vor der Ausführung eine Freigabe per E-Mail durch einen Menschen erfordern. Konfigurieren Sie require_human_approval mit update_my_agent_settings.

Scopes für API-Schlüssel

read_only

Guthaben, Kurse, Verlauf und Limits prüfen, ohne Geld zu bewegen

transfer

Tokens an andere Konten senden (erfordert OTP)

swap

Zwischen Währungs-Stablecoins tauschen

fiat

Fiat-Einzahlungen und -Auszahlungen (erfordert KYC)

offers

Angebote und Trades auf dem Prognosemarkt erstellen und verwalten

rate

Zugriff auf Wechselkurse, historische Daten, Umrechnungen und Kursstatistiken

Scope	Was er erlaubt
read_only	Guthaben, Kurse, Verlauf und Limits prüfen, ohne Geld zu bewegen
transfer	Tokens an andere Konten senden (erfordert OTP)
swap	Zwischen Währungs-Stablecoins tauschen
fiat	Fiat-Einzahlungen und -Auszahlungen (erfordert KYC)
offers	Angebote und Trades auf dem Prognosemarkt erstellen und verwalten
rate	Zugriff auf Wechselkurse, historische Daten, Umrechnungen und Kursstatistiken

Preise

Lesezugriffe sind immer kostenlos. Sie zahlen nur für Transaktionen, die Werte bewegen.

Gebühren pro Vorgang

Lesezugriffe

get_balances, get_exchange_rate, list_trades, …

Kostenlos

Token-Überweisungen

transfer_tokens

0.3%

Währungstausch

swap_currency

0.5%

Fiat-Einzahlungen

initiate_deposit

Je nach Zahlungsweg

Fiat-Auszahlungen

request_withdrawal

Je nach Zahlungsweg

Prognosemarkt

create_offer, engage_offer

Plattformgebühr bei Abrechnung

Vorgang	Tools	Gebühr
Lesezugriffe	get_balances, get_exchange_rate, list_trades, …	Kostenlos
Token-Überweisungen	transfer_tokens	0.3%
Währungstausch	swap_currency	0.5%
Fiat-Einzahlungen	initiate_deposit	Je nach Zahlungsweg
Fiat-Auszahlungen	request_withdrawal	Je nach Zahlungsweg
Prognosemarkt	create_offer, engage_offer	Plattformgebühr bei Abrechnung