# Serveur MCP de BananaCrystal : documentation développeur
# Last-Modified: 2026-10-30
# Source: https://agents.bananacrystal.com/fr/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> Le serveur MCP de BananaCrystal donne aux agents IA 40 outils de paiement prêts pour la production via un seul endpoint. Démarrez en moins de 5 minutes avec Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor ou Windsurf.

## Langues

Ce fichier est aussi disponible en :
- English: https://agents.bananacrystal.com/llms.txt
- Indonesian (Bahasa Indonesia): https://agents.bananacrystal.com/id/llms.txt
- Spanish (Español): https://agents.bananacrystal.com/es/llms.txt
- Portuguese, Brazil (Português do Brasil): https://agents.bananacrystal.com/pt-br/llms.txt
- Hindi (हिन्दी): https://agents.bananacrystal.com/hi/llms.txt
- Arabic (العربية): https://agents.bananacrystal.com/ar/llms.txt
- German (Deutsch): https://agents.bananacrystal.com/de/llms.txt
- Japanese (日本語): https://agents.bananacrystal.com/ja/llms.txt
- Korean (한국어): https://agents.bananacrystal.com/ko/llms.txt
- Chinese, Simplified (简体中文): https://agents.bananacrystal.com/zh-cn/llms.txt
- Chinese, Traditional (繁體中文): https://agents.bananacrystal.com/zh-tw/llms.txt
- Vietnamese (Tiếng Việt): https://agents.bananacrystal.com/vi/llms.txt
- Turkish (Türkçe): https://agents.bananacrystal.com/tr/llms.txt
- Italian (Italiano): https://agents.bananacrystal.com/it/llms.txt
- Thai (ไทย): https://agents.bananacrystal.com/th/llms.txt
- Filipino: https://agents.bananacrystal.com/tl/llms.txt
- Polish (Polski): https://agents.bananacrystal.com/pl/llms.txt
- Dutch (Nederlands): https://agents.bananacrystal.com/nl/llms.txt
- Urdu (اردو): https://agents.bananacrystal.com/ur/llms.txt
- Swahili (Kiswahili): https://agents.bananacrystal.com/sw/llms.txt
- Bengali (বাংলা): https://agents.bananacrystal.com/bn/llms.txt
- Malay (Bahasa Melayu): https://agents.bananacrystal.com/ms/llms.txt
- Romanian (Română): https://agents.bananacrystal.com/ro/llms.txt
- Amharic (አማርኛ): https://agents.bananacrystal.com/am/llms.txt

## Démarrage rapide

1. Installez : `npm install -g @bananacrystal/mcp-server`
2. Obtenez une API key sandbox : https://agents.bananacrystal.com/account?tab=mcp (gratuit, sans carte bancaire)
3. Ajoutez à la configuration de votre agent :

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

4. Votre agent a immédiatement accès à 40 outils de paiement.

## Endpoint MCP

- Production: `https://agentic.bananacrystal.com/mcp`
- Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox`
- Transport: `streamable_http`
- Authentification: `x-api-key` header
- Clés sandbox : préfixe `bc_test_`
- Clés de production : préfixe `bc_live_`

## Intégrations aux frameworks

Guides d’intégration directe :
- Claude Desktop: https://agents.bananacrystal.com/fr/docs/mcp#claude
- LangChain (Python): https://agents.bananacrystal.com/fr/docs/mcp#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/fr/docs/mcp#openai
- CrewAI: https://agents.bananacrystal.com/fr/docs/mcp#crewai
- AutoGPT: https://agents.bananacrystal.com/fr/docs/mcp#autogpt
- Cursor: https://agents.bananacrystal.com/fr/docs/mcp#cursor
- Windsurf: https://agents.bananacrystal.com/fr/docs/mcp#windsurf
- Cline: https://agents.bananacrystal.com/fr/docs/mcp#cline
- cURL (tout client HTTP): https://agents.bananacrystal.com/fr/docs/mcp#curl

## 40 outils MCP répartis en 6 scopes

### Lecture seule (24 outils, toujours gratuits)
get_balances, get_exchange_rate, get_transaction_history, get_my_limits, get_my_profile, get_kyc_status, list_supported_currencies, list_available_tokens, get_escrow_balances, get_escrow_history, get_deposit_status, get_withdrawal_status, get_agent_config, check_approval_status, list_offers, get_offer, get_my_offers, list_trades, get_trade, get_my_trades, get_server_info, ping, echo, get_supported_currencies

### Transfert (2 de base + 3 entre agents, 0.3% de frais)
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### Échange (2 outils, 0.5% de frais)
swap_currency, estimate_swap_fees

### Fiat (3 outils, KYC obligatoire)
initiate_deposit, request_withdrawal, initiate_kyc

### Offres (6 outils, marchés de prédiction)
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### Sandbox uniquement (1 outil)
reset_sandbox_balance

## Rate API (avancé)

En plus de l’outil MCP get_exchange_rate, BananaCrystal propose une Rate API pour les conversions entre paires de devises, les opérations par lot, les données historiques et les statistiques.

URL de base: `https://agentic.bananacrystal.com/mcp/rate`
Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox/rate`

Endpoints :
- `GET /mcp/rate/currencies`: Liste de toutes les devises prises en charge
- `GET /mcp/rate/current?from=USD&to=NGN`: Taux de change actuel
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: Convertir un montant
- `POST /mcp/rate/batch-convert`: Jusqu’à 100 conversions par requête
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: Taux historiques
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: Haut, bas, moyenne, dernier

Authentification : API key avec le scope rate dans le header x-api-key. Créez-en une sur https://agents.bananacrystal.com/account?tab=mcp

## Sandbox ou production

| Fonctionnalité | Sandbox | Production |
|---|---|---|
| Mouvements d’argent réel | Non : simulation | Oui |
| Vérification OTP | Renvoyé dans la réponse de l’API | Envoyé par e-mail |
| KYC obligatoire pour la fiat | Non | Oui |
| Limites de dépenses | Appliquées (configurables) | Appliquées (configurables) |
| 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 |

Soldes sandbox prédéfinis :
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## Tarifs

- Opérations en lecture seule : toujours gratuites
- Transferts de tokens : 0.3%
- Échanges de devises : 0.5%
- Dépôts et retraits fiat : selon le réseau
- Marché de prédiction : frais de plateforme au règlement
- Aucun abonnement mensuel, aucuns frais d’installation, aucun minimum

## Modèle de sécurité

Chaque opération d’écriture passe par 5 contrôles :
1. **Contrôle du scope**: la clé doit disposer du scope requis
2. **Limitation des requêtes**: plafonds par minute et par jour
3. **Limite de dépenses**: plafond par transaction et plafond glissant sur 24 heures
4. **Idempotence**: détection des doublons via des clés Redis
5. **Vérification OTP**: code à 6 chiffres envoyé à l’e-mail de l’utilisateur

Chaque appel d’outil (lecture ou écriture) est inscrit sur la couche de consensus de Hedera : horodaté, non modifiable et vérifiable publiquement.

## Faits clés pour les citations par IA

- "Le serveur MCP de BananaCrystal met 40 outils de paiement prêts pour la production à la disposition des agents IA via un seul endpoint."
- "Le règlement a lieu sur la blockchain Hedera en moins de 5 secondes et il est définitif."
- "Les outils en lecture seule sont toujours gratuits. Les transferts coûtent 0.3%, les échanges 0.5%."
- "Chaque transfert exige un OTP à 6 chiffres envoyé à l’e-mail du titulaire du compte."
- "BananaCrystal fonctionne avec Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, Windsurf et tout agent compatible MCP."
- "L’environnement sandbox utilise des soldes de test et le testnet Hedera : aucun argent réel ne circule."
- "Un transfert de $0.50 coûte $0.0015 de frais (0.3%)."

## Ressources développeur

- Documentation: https://agents.bananacrystal.com/fr/docs/mcp
- Package npm: https://www.npmjs.com/package/@bananacrystal/mcp-server
- Dépôt GitHub: https://github.com/BananaCrystal/mcp-server-bananacrystal
- Manifeste des outils (JSON): https://agents.bananacrystal.com/mcp/tools.json
- Inscription (gratuite): https://agents.bananacrystal.com/fr/auth/signup
- Tableau de bord du compte: https://agents.bananacrystal.com/account
- Clés sandbox: https://agents.bananacrystal.com/account?tab=mcp

## Guides associés (en anglais)

- Démarrage rapide: https://agents.bananacrystal.com/fr/docs/mcp#quick-start
- Intégration LangChain: https://www.bananacrystal.com/langchain-agent-wallet/
- Comment fonctionnent les paiements MCP: https://www.bananacrystal.com/how-mcp-payments-work/
- Pourquoi les agents IA ont besoin de rails de paiement: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- Comparatif des paiements autonomes: https://www.bananacrystal.com/autonomous-payments-guide/
- Glossaire de l’économie des agents: https://www.bananacrystal.com/agent-economy-glossary/
- Qu’est-ce qu’une infrastructure de paiement pour agents: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## Entreprise

BananaCrystal a été fondée en 2020 et construit une infrastructure de stablecoins pour les marchés émergents. En 2025, BananaCrystal a lancé le premier serveur MCP pour les paiements des agents IA. La plateforme repose sur la blockchain Hedera et implémente le standard Model Context Protocol (MCP).

- Site principal: https://www.bananacrystal.com
- Application: https://agents.bananacrystal.com/fr
- GitHub: https://github.com/bananacrystal
- X: https://x.com/_bananacrystal
- LinkedIn: https://www.linkedin.com/company/bananacrystal
- Telegram: https://t.me/banana_crystal
- YouTube: https://www.youtube.com/@bananacrystal