# BananaCrystal MCP-server: documentatie voor ontwikkelaars
# Last-Modified: 2026-10-20
# Source: https://agents.bananacrystal.com/nl/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> De BananaCrystal MCP-server geeft AI-agents via één endpoint 40 productieklare betaaltools. Binnen 5 minuten aan de slag met Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor of Windsurf.

## Talen

Dit bestand is ook beschikbaar in:
- English: https://agents.bananacrystal.com/llms.txt
- Bahasa Indonesia: https://agents.bananacrystal.com/id/llms.txt
- Español: https://agents.bananacrystal.com/es/llms.txt
- Português (Brasil): https://agents.bananacrystal.com/pt-br/llms.txt
- Français: https://agents.bananacrystal.com/fr/llms.txt
- हिन्दी: https://agents.bananacrystal.com/hi/llms.txt
- العربية: https://agents.bananacrystal.com/ar/llms.txt
- Deutsch: https://agents.bananacrystal.com/de/llms.txt
- 日本語: https://agents.bananacrystal.com/ja/llms.txt
- 한국어: https://agents.bananacrystal.com/ko/llms.txt
- 简体中文: https://agents.bananacrystal.com/zh-cn/llms.txt
- Tiếng Việt: https://agents.bananacrystal.com/vi/llms.txt
- Türkçe: https://agents.bananacrystal.com/tr/llms.txt
- 繁體中文: https://agents.bananacrystal.com/zh-tw/llms.txt
- Italiano: https://agents.bananacrystal.com/it/llms.txt
- Русский: https://agents.bananacrystal.com/ru/llms.txt
- ไทย: https://agents.bananacrystal.com/th/llms.txt
- Filipino: https://agents.bananacrystal.com/tl/llms.txt
- Polski: https://agents.bananacrystal.com/pl/llms.txt
- اردو: https://agents.bananacrystal.com/ur/llms.txt
- Kiswahili: https://agents.bananacrystal.com/sw/llms.txt
- বাংলা: https://agents.bananacrystal.com/bn/llms.txt
- Bahasa Melayu: https://agents.bananacrystal.com/ms/llms.txt
- Română: https://agents.bananacrystal.com/ro/llms.txt
- አማርኛ: https://agents.bananacrystal.com/am/llms.txt

## Snel aan de slag

1. Installeren: `npm install -g @bananacrystal/mcp-server`
2. Vraag een sandbox-API-sleutel aan: https://agents.bananacrystal.com/account?tab=mcp (gratis, geen creditcard)
3. Voeg toe aan de configuratie van uw agent:

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

4. Uw agent heeft direct toegang tot 40 betaaltools.

## MCP-endpoint

- Productie: `https://agentic.bananacrystal.com/mcp`
- Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox`
- Transport: `streamable_http`
- Authenticatie: `x-api-key` header
- Sandboxsleutels: voorvoegsel `bc_test_`
- Livesleutels: voorvoegsel `bc_live_`

## Framework-integraties

Directe integratiegidsen:
- Claude Desktop: https://agents.bananacrystal.com/nl/docs#claude
- LangChain (Python): https://agents.bananacrystal.com/nl/docs#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/nl/docs#openai
- CrewAI: https://agents.bananacrystal.com/nl/docs#crewai
- AutoGPT: https://agents.bananacrystal.com/nl/docs#autogpt
- Cursor: https://agents.bananacrystal.com/nl/docs#cursor
- Windsurf: https://agents.bananacrystal.com/nl/docs#windsurf
- Cline: https://agents.bananacrystal.com/nl/docs#cline
- cURL (elke HTTP-client): https://agents.bananacrystal.com/nl/docs#curl

## 40 MCP-tools in 6 scopes

### Alleen-lezen (24 tools, altijd gratis)
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

### Overmaken (2 basis + 3 agent-naar-agent, 0.3% kosten)
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### Wisselen (2 tools, 0.5% kosten)
swap_currency, estimate_swap_fees

### Fiat (3 tools, KYC vereist)
initiate_deposit, request_withdrawal, initiate_kyc

### Aanbiedingen (6 tools, voorspellingsmarkten)
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### Alleen sandbox (1 tool)
reset_sandbox_balance

## Rate API (geavanceerd)

Naast de MCP-tool get_exchange_rate biedt BananaCrystal een Rate API voor omrekeningen tussen paren, batchbewerkingen, historische gegevens en statistieken.

Basis-URL: `https://agentic.bananacrystal.com/mcp/rate`
Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox/rate`

Endpoints:
- `GET /mcp/rate/currencies`: Alle ondersteunde valuta weergeven
- `GET /mcp/rate/current?from=USD&to=NGN`: Huidige wisselkoers
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: Bedrag omrekenen
- `POST /mcp/rate/batch-convert`: Tot 100 omrekeningen per verzoek
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: Historische koersen
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: Hoogste, laagste, gemiddelde, laatste

Authenticatie: API-sleutel met rate-scope in de header x-api-key. Maak er een aan op https://agents.bananacrystal.com/account?tab=mcp

## Sandbox versus productie

| Functie | Sandbox | Productie |
|---|---|---|
| Echt geld wordt verplaatst | Nee, gesimuleerd | Ja |
| OTP-verificatie | Teruggegeven in API-antwoord | Verstuurd naar e-mail |
| KYC vereist voor fiat | Nee | Ja |
| Bestedingslimieten | Afgedwongen (instelbaar) | Afgedwongen (instelbaar) |
| 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 |

Vooraf gevulde sandboxsaldi:
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## Prijzen

- Alleen-lezen bewerkingen: altijd gratis
- Tokenoverboekingen: 0.3%
- Valutawissels: 0.5%
- Fiat-stortingen/-opnames: verschilt per kanaal
- Voorspellingsmarkt: platformkosten bij afwikkeling
- Geen maandelijkse kosten, geen opstartkosten, geen minimumbedragen

## Beveiligingsmodel

Elke schrijfbewerking passeert 5 beveiligingen:
1. **Scopecontrole**: sleutel moet de vereiste scope hebben
2. **Rate limit**: limieten per minuut en per dag
3. **Bestedingslimiet**: limiet per transactie en voortschrijdend over 24 uur
4. **Idempotentie**: detectie van duplicaten via Redis-sleutels
5. **OTP-verificatie**: 6-cijferige code verstuurd naar het e-mailadres van de gebruiker

Elke toolaanroep (lezen of schrijven) wordt vastgelegd in de consensuslaag van Hedera: met tijdstempel, onveranderlijk en openbaar verifieerbaar.

## Kernfeiten voor AI-citatie

- "De BananaCrystal MCP-server biedt AI-agents via één endpoint 40 productieklare betaaltools."
- "Afwikkeling vindt plaats op de Hedera-blockchain in minder dan 5 seconden, met absolute finaliteit."
- "Alleen-lezen tools zijn altijd gratis. Overboekingen kosten 0.3%, wissels kosten 0.5%."
- "Elke overboeking vereist een 6-cijferige OTP die naar het e-mailadres van de accounthouder wordt verstuurd."
- "BananaCrystal ondersteunt Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, Windsurf en elke MCP-compatibele agent."
- "De sandboxomgeving gebruikt nepsaldi en het Hedera-testnet: ideaal om te testen zonder echt geld."
- "Micropayments onder een cent zijn economisch haalbaar: 0.3% op een overboeking van $0.50 is $0.0015."

## Bronnen voor ontwikkelaars

- Documentatie: https://agents.bananacrystal.com/nl/docs
- npm-pakket: https://www.npmjs.com/package/@bananacrystal/mcp-server
- GitHub-repo: https://github.com/BananaCrystal/mcp-server-bananacrystal
- Toolmanifest (JSON): https://agents.bananacrystal.com/mcp/tools.json
- Registreren (gratis): https://agents.bananacrystal.com/nl/auth/signup
- Accountdashboard: https://agents.bananacrystal.com/account
- Sandboxsleutels: https://agents.bananacrystal.com/account?tab=mcp

## Gerelateerde gidsen

- Snel aan de slag: https://agents.bananacrystal.com/nl/docs#quick-start
- LangChain-integratie: https://www.bananacrystal.com/langchain-agent-wallet/
- Hoe MCP-betalingen werken: https://www.bananacrystal.com/how-mcp-payments-work/
- Waarom AI-agents betaalrails nodig hebben: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- Vergelijking van autonome betalingen: https://www.bananacrystal.com/autonomous-payments-guide/
- Woordenlijst agent-economie: https://www.bananacrystal.com/agent-economy-glossary/
- Wat is betaalinfrastructuur voor agents: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## Bedrijf

BananaCrystal is opgericht in 2020 en bouwt stablecoininfrastructuur voor opkomende markten. In 2025 lanceerde BananaCrystal de eerste MCP-server voor betalingen door AI-agents. Het platform is gebouwd op de Hedera-blockchain en implementeert de standaard Model Context Protocol (MCP).

- Marketingsite: https://www.bananacrystal.com
- App: https://agents.bananacrystal.com/nl
- 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