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.

Documentation MCP : 40 outils de paiement IA

Démarrage rapide

Votre agent IA effectue ses premiers paiements en moins de 5 minutes.

Installez le serveur MCP

Installez le serveur MCP de BananaCrystal globalement via npm.

bash

npm install -g @bananacrystal/mcp-server

Obtenez votre API key

Créez une API key MCP depuis le tableau de bord de votre compte. Les clés sandbox commencent par bc_test_ et sont gratuites.

Obtenir une API key

Clés sandbox : bc_test_...

Configurez Claude Desktop

Ajoutez BananaCrystal au fichier de configuration de Claude Desktop.

claude_desktop_config.json

json

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

Demandez à votre agent

Votre agent dispose maintenant de 40 outils de paiement. Essayez ces requêtes :

›"Quel est mon solde USDb actuel ?"

›"Envoie 50 USDb à 0.0.654321"

›"Échange 100 USDb contre des NGNb au taux actuel"

›"Montre-moi mes 10 dernières transactions"

›"Quel est le taux de change actuel USD vers NGN ?"

Outils MCP

40 outils de paiement prêts pour la production, répartis en 6 catégories. Les opérations en lecture seule sont toujours gratuites.

Lecture seule24 outils

ping

read_onlygratuit

Vérification de l’état : renvoie pong

get_server_info

read_onlygratuit

Renvoie les informations de base du serveur

echo

read_onlygratuit

Renvoie le message reçu à l’appelant

get_my_profile

read_onlygratuit

Obtenir le profil complet de l’utilisateur authentifié

get_balances

read_onlygratuit

Obtenir le solde du compte Hedera pour tous les tokens de la plateforme ou un token précis

get_exchange_rate

read_onlygratuit

Obtenir les taux de change achat/vente en direct d’une devise

list_supported_currencies

read_onlygratuit

Lister toutes les devises prises en charge avec leurs frais dynamiques

list_available_tokens

read_onlygratuit

Lister tous les tokens Hedera disponibles sur la plateforme

get_transaction_history

read_onlygratuit

Obtenir l’historique des transactions classé, avec filtres

get_my_limits

read_onlygratuit

Obtenir les limites configurées et l’utilisation en direct de l’API key authentifiée

estimate_swap_fees

read_onlygratuit

Estimer les frais d’un échange de devises avant de l’exécuter

get_agent_config

read_onlygratuit

Consulter la configuration de l’agent d’un autre utilisateur

check_approval_status

read_onlygratuit

Vérifier le statut d’une demande d’approbation de transaction d’agent en attente

get_kyc_status

read_onlygratuit

Obtenir le statut de vérification KYC d’un utilisateur via Sumsub

get_deposit_status

read_onlygratuit

Obtenir le statut d’un dépôt fiat à partir de l’identifiant du transfert

get_withdrawal_status

read_onlygratuit

Obtenir les demandes de retrait d’un utilisateur via Brale

get_escrow_balances

read_onlygratuit

Obtenir le détail du solde en séquestre : montants total, disponible et bloqué

get_escrow_history

read_onlygratuit

Obtenir l’historique complet des transactions en séquestre, y compris blocages, libérations, gains et pertes

list_offers

read_onlygratuit

Parcourir les offres actives du marché de prédiction avec leurs statistiques de trades

get_offer

read_onlygratuit

Obtenir le détail complet d’une offre, y compris ses statistiques de trades

get_my_offers

read_onlygratuit

Obtenir toutes les offres créées par un utilisateur donné

list_trades

read_onlygratuit

Lister tous les trades de la plateforme, avec filtres

get_trade

read_onlygratuit

Obtenir le détail complet d’un trade, y compris les statistiques de l’offre parente

get_my_trades

read_onlygratuit

Obtenir tous les trades d’un utilisateur, créés et reçus

Transfert2 outils

request_transfer_otp

transfer0.3%

Étape 1 : demander un code OTP envoyé à l’e-mail de l’expéditeur

transfer_tokens

transfer0.3%

Étape 2 : exécuter le transfert de tokens avec vérification OTP

Échange1 outil

swap_currency

swap0.5%

Échanger entre deux tokens Hedera, avec taux et frais calculés automatiquement

Fiat3 outils

initiate_kyc

fiat

Lancer la vérification KYC : renvoie un jeton d’accès Sumsub pour le SDK

initiate_deposit

fiat

Lancer un dépôt fiat via Brale (KYC obligatoire)

request_withdrawal

fiat

Demander un retrait fiat via Brale (KYC obligatoire)

Offres et trades6 outils

create_offer

offers

Créer une offre sur le marché de prédiction qui bloque le montant total en séquestre

update_offer

offers

Modifier une offre existante (uniquement s’il n’y a aucun trade)

delist_offer

offers

Retirer votre offre du marché et libérer le séquestre bloqué

delete_offer

offers

Supprimer définitivement votre offre (impossible s’il existe des trades actifs)

engage_offer

offers

Prendre une offre ouverte en bloquant un séquestre équivalent

cancel_trade

offers

Annuler un trade actif et libérer votre séquestre bloqué

Agent à agent3 outils

request_agent_transaction

transfer

Demander une transaction au nom de l’agent d’un autre utilisateur (approbation par e-mail obligatoire)

execute_approved_transaction

transfer

Exécuter une transaction d’agent déjà approuvée avec le jeton d’exécution

update_my_agent_settings

read_onlygratuit

Définir si les transactions agent à agent exigent une approbation par e-mail et un OTP

Sandbox uniquement1 outil

reset_sandbox_balance

read_onlygratuit

Réinitialiser les soldes sandbox à leurs valeurs prédéfinies (sandbox uniquement)

Rate API

Opérations avancées sur les taux de change via REST. Nécessite une API key avec le scope rate.

Outil MCP ou Rate API : quelle différence ?

Le serveur MCP inclut déjà get_exchange_rate comme outil read_only : votre agent peut l’appeler directement pour obtenir le taux achat/vente d’une devise face à l’USD. Cela couvre la plupart des usages d’un agent.

La Rate API va plus loin : conversions entre paires croisées, opérations groupées, séries historiques et statistiques. Elles sont disponibles sous forme d’endpoints HTTP directs, authentifiés par une API key avec le scope rate. Créez une clé rate depuis le tableau de bord de votre compte.

Authentification

Tous les endpoints de la Rate API exigent une API key avec le scope rate, transmise dans l’en-tête x-api-key. Les équivalents sandbox sont disponibles sur /mcp/sandbox/rate/* et utilisent votre clé sandbox (bc_test_...) avec des taux fictifs fixes pour des tests reproductibles.

URL de base

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

GET/mcp/rate/currenciesLister toutes les devises prises en charge

Lister toutes les devises prises en charge

Exemple de requête

bash

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

Exemple de réponse

json

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

GET/mcp/rate/currentObtenir le taux de change actuel entre deux devises

Obtenir le taux de change actuel entre deux devises

Paramètres

Nom	Obligatoire	Description
`from`	obligatoire	Code de la devise source (ex. USD)
`to`	obligatoire	Code de la devise cible (ex. NGN)

Exemple de requête

bash

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

Exemple de réponse

json

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

GET/mcp/rate/convertConvertir un montant d’une devise à une autre

Convertir un montant d’une devise à une autre

Paramètres

Nom	Obligatoire	Description
`from`	obligatoire	Code de la devise source
`to`	obligatoire	Code de la devise cible
`amount`	obligatoire	Montant à convertir (nombre)

Exemple de requête

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"

Exemple de réponse

json

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

POST/mcp/rate/batch-convertConvertir plusieurs montants en une seule requête (100 maximum)

Convertir plusieurs montants en une seule requête (100 maximum)

Exemple de requête

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

Exemple de réponse

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/historyRécupérer l’historique des taux de change d’une paire de devises

Récupérer l’historique des taux de change d’une paire de devises

Paramètres

Nom	Obligatoire	Description
`from`	obligatoire	Code de la devise source
`to`	obligatoire	Code de la devise cible
`startDate`	obligatoire	Date de début (ISO 8601, ex. 2026-04-01)
`endDate`	obligatoire	Date de fin (ISO 8601, ex. 2026-04-30)

Exemple de requête

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"

Exemple de réponse

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/statsObtenir les statistiques de taux (haut, bas, moyenne, dernier) sur une période

Obtenir les statistiques de taux (haut, bas, moyenne, dernier) sur une période

Paramètres

Nom	Obligatoire	Description
`from`	obligatoire	Code de la devise source
`to`	obligatoire	Code de la devise cible
`days`	facultatif	Période en jours, de 1 à 365 (par défaut : 30)

Exemple de requête

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"

Exemple de réponse

json

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

Rate API en sandbox

Remplacez /mcp/rate/ par /mcp/sandbox/rate/ et utilisez votre clé sandbox pour obtenir des taux fictifs fixes. Les données historiques sont générées avec une variation de ±2% pour des tests réalistes. Aucune donnée de change réelle n’est utilisée.

Environnement sandbox

Testez votre intégration en toute sécurité, avec des soldes prédéfinis et sans argent réel.

Qu’est-ce que la sandbox ?

La sandbox est un environnement de test entièrement isolé qui reproduit exactement la production : mêmes outils, même API, même format de réponse. Aucun argent réel ne circule. Les API keys sandbox commencent par bc_test_ et se connectent au testnet Hedera.

Soldes prédéfinis

Chaque compte sandbox démarre avec ces soldes. Utilisez reset_sandbox_balance pour les restaurer à tout moment.

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

Sandbox ou production

Fonctionnalité	Sandbox	Production
Mouvements d’argent réel	Non : simulation uniquement	Oui
Vérification OTP	Renvoyé dans la réponse de l’API	Envoyé à votre e-mail
KYC obligatoire pour la fiat	Non	Oui
Limites de dépenses appliquées	Oui (configurables)	Oui
Préfixe de l’API key	bc_test_...	bc_live_...
Règlement Hedera	Testnet	Mainnet
Soldes prédéfinis	Oui (réinitialisables à tout moment)	Non
Limites de requêtes	Assouplies	Selon le forfait

OTP en sandbox

En mode sandbox, le code OTP est renvoyé directement dans la réponse de l’API request_transfer_otp au lieu d’être envoyé par e-mail. Les tests automatisés sont ainsi simples, sans accès à une boîte e-mail.

Configuration de la 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"
      }
    }
  }
}

Configuration

Connectez BananaCrystal à votre outil ou framework IA préféré.

claude_desktop_config.json

json

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

Variables d’environnement

BANANACRYSTAL_API_KEYobligatoire

Votre API key MCP. Les clés sandbox commencent par bc_test_, les clés de production par bc_live_.

Par défaut : N/A

BANANACRYSTAL_API_URLfacultatif

Remplace l’URL de l’endpoint MCP. Utilisez l’URL sandbox pour vos tests.

Par défaut : https://agentic.bananacrystal.com/mcp

DEBUGfacultatif

Mettez à true pour activer la journalisation détaillée des requêtes et réponses.

Par défaut : false

Variable	Obligatoire	Par défaut	Description
`BANANACRYSTAL_API_KEY`	obligatoire	`N/A`	Votre API key MCP. Les clés sandbox commencent par bc_test_, les clés de production par bc_live_.
`BANANACRYSTAL_API_URL`	facultatif	`https://agentic.bananacrystal.com/mcp`	Remplace l’URL de l’endpoint MCP. Utilisez l’URL sandbox pour vos tests.
`DEBUG`	facultatif	`false`	Mettez à true pour activer la journalisation détaillée des requêtes et réponses.

Intégrations aux frameworks

Des exemples prêts à l’emploi pour les frameworks d’agents IA les plus populaires.

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

Tout framework compatible MCP fonctionne. Si votre framework prend en charge les serveurs MCP via HTTP, pointez-le vers https://agentic.bananacrystal.com/mcp avec votre API key comme Bearer token.

Architecture de sécurité

Plusieurs niveaux de protection : votre agent ne peut faire que ce que vous autorisez explicitement.

Scopes des API keys

Chaque API key possède des scopes de permission explicites. Un agent ne peut effectuer que les opérations comprises dans les scopes que vous accordez.

Limites de dépenses

Fixez des plafonds stricts par transaction et des plafonds glissants sur 24 heures pour chaque API key. Ils sont appliqués au niveau de l’infrastructure.

Vérification OTP

Chaque transfert de tokens exige un OTP à 6 chiffres envoyé à votre e-mail enregistré. L’agent ne peut pas finaliser un transfert sans que vous fournissiez ce code.

Limitation des requêtes

Des plafonds par clé et par minute empêchent un agent incontrôlé de saturer l’API. Les limites évoluent selon votre forfait.

Piste d’audit immuable

Chaque appel d’outil est inscrit sur la couche de consensus de Hedera. Les appels sont horodatés, infalsifiables et vérifiables publiquement on-chain. L’historique d’audit complet est disponible via get_transaction_history.

Flux d’approbation des agents

Les transactions agent à agent peuvent exiger une approbation humaine par e-mail avant exécution. Utilisez update_my_agent_settings pour configurer require_human_approval.

Scopes des API keys

read_only

Consulter soldes, taux, historique et limites sans déplacer de fonds

transfer

Envoyer des tokens vers d’autres comptes (OTP obligatoire)

swap

Échanger entre stablecoins de devises

fiat

Dépôts et retraits fiat (KYC obligatoire)

offers

Créer et gérer les offres et trades du marché de prédiction

rate

Accéder aux taux de change, aux données historiques, aux conversions et aux statistiques de taux

Scope	Ce qu’il permet
read_only	Consulter soldes, taux, historique et limites sans déplacer de fonds
transfer	Envoyer des tokens vers d’autres comptes (OTP obligatoire)
swap	Échanger entre stablecoins de devises
fiat	Dépôts et retraits fiat (KYC obligatoire)
offers	Créer et gérer les offres et trades du marché de prédiction
rate	Accéder aux taux de change, aux données historiques, aux conversions et aux statistiques de taux

Tarifs

Les opérations en lecture seule sont toujours gratuites. Vous ne payez que les transactions qui déplacent de la valeur.

Frais par opération

Opérations en lecture seule

get_balances, get_exchange_rate, list_trades, …

Gratuit

Transferts de tokens

transfer_tokens

0.3%

Échanges de devises

swap_currency

0.5%

Dépôts fiat

initiate_deposit

Selon le réseau

Retraits fiat

request_withdrawal

Selon le réseau

Marché de prédiction

create_offer, engage_offer

Frais de plateforme au règlement

Opération	Outils	Frais
Opérations en lecture seule	get_balances, get_exchange_rate, list_trades, …	Gratuit
Transferts de tokens	transfer_tokens	0.3%
Échanges de devises	swap_currency	0.5%
Dépôts fiat	initiate_deposit	Selon le réseau
Retraits fiat	request_withdrawal	Selon le réseau
Marché de prédiction	create_offer, engage_offer	Frais de plateforme au règlement

Forfaits

Gratuit

$0opérations en lecture seule

Tous les outils en lecture seule sont toujours gratuits. Aucun compte n’est nécessaire pour consulter les taux ou les soldes.

Tous les outils en lecture seule gratuits, pour toujours
Environnement sandbox inclus
get_balances, get_exchange_rate et 22 autres
Support communautaire
Règlement sur le testnet Hedera

Obtenir une API key

Le plus populaire

Paiement à l’usage

Selon l’usagesans abonnement mensuel

Évoluez à votre rythme. Ne payez que ce que vous utilisez.

Appels API illimités
0.3% sur les transferts
0.5% sur les échanges
Réseaux fiat (selon le mode)
Support par e-mail et prioritaire
Règlement sur le mainnet Hedera
Piste d’audit complète

Obtenir une API key

Entreprise

Sur mesurecontactez-nous

Remises sur volume, SLA et infrastructure dédiée.

Paliers de frais sur mesure
Endpoint MCP dédié
Garanties SLA
Limites de dépenses sur mesure
Support dédié
Option sur site

Contacter l’équipe commerciale

FAQ

Questions fréquentes sur BananaCrystal et le serveur MCP.

Prêt à donner un wallet à votre agent ?

Créez votre API key et connectez votre agent à 40 outils de paiement en moins de 5 minutes. Les outils en lecture seule sont toujours gratuits.

Obtenir une API key

Documentation MCP de BananaCrystal

Démarrage rapide

Installez le serveur MCP

Obtenez votre API key

Configurez Claude Desktop

Demandez à votre agent

Outils MCP

Rate API

Outil MCP ou Rate API : quelle différence ?

Authentification

Exemple de requête

Exemple de réponse

Paramètres

Exemple de requête

Exemple de réponse

Paramètres

Exemple de requête

Exemple de réponse

Exemple de requête

Exemple de réponse

Paramètres

Exemple de requête

Exemple de réponse

Paramètres

Exemple de requête

Exemple de réponse

Rate API en sandbox

Environnement sandbox

Qu’est-ce que la sandbox ?

Soldes prédéfinis

Sandbox ou production

OTP en sandbox

Configuration de la sandbox

Configuration

Variables d’environnement

Intégrations aux frameworks

Architecture de sécurité

Scopes des API keys

Limites de dépenses

Vérification OTP

Limitation des requêtes

Piste d’audit immuable

Flux d’approbation des agents

Scopes des API keys

Tarifs

Frais par opération

Forfaits

Gratuit

Paiement à l’usage

Entreprise

FAQ

Prêt à donner un wallet à votre agent ?