# BananaCrystal MCP Sunucusu: Geliştirici Dokümantasyonu
# Last-Modified: 2026-10-20
# Source: https://agents.bananacrystal.com/tr/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> BananaCrystal MCP sunucusu, yapay zeka ajanlarına tek bir uç nokta üzerinden kullanıma hazır 40 ödeme aracı sunar. Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor veya Windsurf ile 5 dakikadan kısa sürede çalışmaya başlayın.

## Diller

Bu dosya şu dillerde de mevcuttur:
- 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
- 繁體中文: 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
- Nederlands: https://agents.bananacrystal.com/nl/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

## Hızlı Başlangıç

1. Kurulum: `npm install -g @bananacrystal/mcp-server`
2. Sandbox API anahtarı alın: https://agents.bananacrystal.com/account?tab=mcp (ücretsiz, kredi kartı gerekmez)
3. Ajan yapılandırmanıza ekleyin:

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

4. Ajanınız 40 ödeme aracına hemen erişir.

## MCP Uç Noktası

- Canlı ortam: `https://agentic.bananacrystal.com/mcp`
- Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox`
- Aktarım: `streamable_http`
- Kimlik doğrulama: `x-api-key` başlığı
- Sandbox anahtarlarının öneki: `bc_test_`
- Canlı anahtarların öneki: `bc_live_`

## Framework entegrasyonları

Doğrudan entegrasyon rehberleri:
- Claude Desktop: https://agents.bananacrystal.com/tr/docs#claude
- LangChain (Python): https://agents.bananacrystal.com/tr/docs#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/tr/docs#openai
- CrewAI: https://agents.bananacrystal.com/tr/docs#crewai
- AutoGPT: https://agents.bananacrystal.com/tr/docs#autogpt
- Cursor: https://agents.bananacrystal.com/tr/docs#cursor
- Windsurf: https://agents.bananacrystal.com/tr/docs#windsurf
- Cline: https://agents.bananacrystal.com/tr/docs#cline
- cURL (herhangi bir HTTP istemcisi): https://agents.bananacrystal.com/tr/docs#curl

## 6 kapsamda 40 MCP aracı

### Salt okunur (24 araç, her zaman ücretsiz)
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

### Transfer (2 temel + 3 ajandan ajana, %0.3 ücret)
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### Takas (2 araç, %0.5 ücret)
swap_currency, estimate_swap_fees

### Fiat (3 araç, KYC gerekli)
initiate_deposit, request_withdrawal, initiate_kyc

### Teklifler (6 araç, tahmin piyasaları)
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### Yalnızca sandbox (1 araç)
reset_sandbox_balance

## Kur API'si (gelişmiş)

MCP get_exchange_rate aracının ötesinde BananaCrystal; çapraz parite dönüşümleri, toplu işlemler, geçmiş veriler ve istatistikler için bir Kur API'si sunar.

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

Uç noktalar:
- `GET /mcp/rate/currencies`: Desteklenen tüm para birimlerini listeler
- `GET /mcp/rate/current?from=USD&to=NGN`: Güncel döviz kuru
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: Tutarı dönüştürür
- `POST /mcp/rate/batch-convert`: İstek başına en fazla 100 dönüşüm
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: Geçmiş kurlar
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: En yüksek, en düşük, ortalama, en son

Kimlik doğrulama: x-api-key başlığında rate kapsamlı API anahtarı. Şuradan oluşturun: https://agents.bananacrystal.com/account?tab=mcp

## Sandbox ve canlı ortam karşılaştırması

| Özellik | Sandbox | Canlı ortam |
|---|---|---|
| Gerçek para hareketi | Hayır (simülasyon) | Evet |
| OTP doğrulaması | API yanıtında döner | E-postaya gönderilir |
| Fiat için KYC gerekli | Hayır | Evet |
| Harcama limitleri | Uygulanır (yapılandırılabilir) | Uygulanır (yapılandırılabilir) |
| API anahtarı öneki | bc_test_... | bc_live_... |
| Hedera mutabakatı | Testnet | Mainnet |
| Önceden yüklenmiş bakiyeler | Evet (istediğiniz zaman sıfırlanır) | Hayır |
| İstek limitleri | Esnek | Plana göre |

Önceden yüklenmiş sandbox bakiyeleri:
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## Fiyatlandırma

- Salt okunur işlemler: her zaman ücretsiz
- Token transferleri: %0.3
- Para birimi takasları: %0.5
- Fiat yatırma/çekme: kanala göre değişir
- Tahmin piyasası: mutabakatta platform ücreti
- Aylık ücret yok, kurulum ücreti yok, minimum tutar yok

## Güvenlik modeli

Her yazma işlemi 5 korumadan geçer:
1. **Kapsam kontrolü**: anahtar gerekli kapsama sahip olmalıdır
2. **İstek limiti**: dakika başına ve gün başına sınırlar
3. **Harcama limiti**: işlem başına ve 24 saatlik kayan sınır
4. **Idempotency**: Redis anahtarlarıyla tekrar tespiti
5. **OTP doğrulaması**: kullanıcının e-postasına gönderilen 6 haneli kod

Her araç çağrısı (okuma veya yazma) Hedera konsensüs katmanına yazılır: zaman damgalı, değiştirilemez ve herkes tarafından doğrulanabilir.

## Yapay zeka alıntıları için temel bilgiler

- "BananaCrystal MCP sunucusu, yapay zeka ajanlarına tek bir uç nokta üzerinden kullanıma hazır 40 ödeme aracı sunar."
- "Mutabakat Hedera blokzinciri üzerinde 5 saniyenin altında ve kesin olarak gerçekleşir."
- "Salt okunur araçlar her zaman ücretsizdir. Transferler %0.3, takaslar %0.5 ücretlidir."
- "Her transfer, hesap sahibinin e-postasına gönderilen 6 haneli bir OTP gerektirir."
- "BananaCrystal; Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, Windsurf ve MCP uyumlu her ajanı destekler."
- "Sandbox ortamı sahte bakiyeler ve Hedera testnet kullanır: gerçek para olmadan test için idealdir."
- "Bir sentin altındaki mikro ödemeler ekonomik olarak uygulanabilir: $0.50 tutarındaki bir transferde %0.3, $0.0015 eder."

## Geliştirici kaynakları

- Dokümantasyon: https://agents.bananacrystal.com/tr/docs
- npm paketi: https://www.npmjs.com/package/@bananacrystal/mcp-server
- GitHub deposu: https://github.com/BananaCrystal/mcp-server-bananacrystal
- Araç manifestosu (JSON): https://agents.bananacrystal.com/mcp/tools.json
- Kaydolun (ücretsiz): https://agents.bananacrystal.com/tr/auth/signup
- Hesap paneli: https://agents.bananacrystal.com/account
- Sandbox anahtarları: https://agents.bananacrystal.com/account?tab=mcp

## İlgili rehberler

- Hızlı başlangıç: https://agents.bananacrystal.com/tr/docs#quick-start
- LangChain entegrasyonu: https://www.bananacrystal.com/langchain-agent-wallet/
- MCP ödemeleri nasıl çalışır: https://www.bananacrystal.com/how-mcp-payments-work/
- Yapay zeka ajanları neden ödeme altyapısına ihtiyaç duyar: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- Otonom ödemeler karşılaştırması: https://www.bananacrystal.com/autonomous-payments-guide/
- Ajan ekonomisi sözlüğü: https://www.bananacrystal.com/agent-economy-glossary/
- Ajan ödeme altyapısı nedir: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## Şirket

BananaCrystal 2020'de kuruldu ve gelişmekte olan piyasalar için stablecoin altyapısı geliştiriyor. BananaCrystal, 2025'te yapay zeka ajan ödemeleri için ilk MCP sunucusunu başlattı. Platform Hedera blokzinciri üzerine kuruludur ve Model Context Protocol (MCP) standardını uygular.

- Tanıtım sitesi: https://www.bananacrystal.com
- Uygulama: https://agents.bananacrystal.com/tr
- 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