# MCP-сервер BananaCrystal: документация для разработчиков
# Last-Modified: 2026-10-20
# Source: https://agents.bananacrystal.com/ru/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> MCP-сервер BananaCrystal даёт ИИ-агентам 40 готовых платёжных инструментов через единую точку подключения. Запуск менее чем за 5 минут с Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor или Windsurf.

## Языки

Этот файл также доступен на:
- 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/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

## Быстрый старт

1. Установка: `npm install -g @bananacrystal/mcp-server`
2. Получите sandbox API-ключ: https://agents.bananacrystal.com/account?tab=mcp (бесплатно, без банковской карты)
3. Добавьте в конфигурацию агента:

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

4. Ваш агент сразу получает доступ к 40 платёжным инструментам.

## Точка подключения MCP

- Production: `https://agentic.bananacrystal.com/mcp`
- Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox`
- Транспорт: `streamable_http`
- Аутентификация: `x-api-key` заголовок
- Sandbox-ключи: с префиксом `bc_test_`
- Боевые ключи: с префиксом `bc_live_`

## Интеграции с фреймворками

Руководства по прямой интеграции:
- Claude Desktop: https://agents.bananacrystal.com/ru/docs#claude
- LangChain (Python): https://agents.bananacrystal.com/ru/docs#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/ru/docs#openai
- CrewAI: https://agents.bananacrystal.com/ru/docs#crewai
- AutoGPT: https://agents.bananacrystal.com/ru/docs#autogpt
- Cursor: https://agents.bananacrystal.com/ru/docs#cursor
- Windsurf: https://agents.bananacrystal.com/ru/docs#windsurf
- Cline: https://agents.bananacrystal.com/ru/docs#cline
- cURL (любой HTTP-клиент): https://agents.bananacrystal.com/ru/docs#curl

## 40 инструментов MCP в 6 областях доступа

### Только чтение (24 инструмента, всегда бесплатно)
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

### Переводы (2 основных + 3 между агентами, комиссия 0.3%)
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### Обмен (2 инструмента, комиссия 0.5%)
swap_currency, estimate_swap_fees

### Фиат (3 инструмента, требуется KYC)
initiate_deposit, request_withdrawal, initiate_kyc

### Предложения (6 инструментов, рынки прогнозов)
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### Только sandbox (1 инструмент)
reset_sandbox_balance

## Rate API (расширенный)

Помимо инструмента MCP get_exchange_rate, BananaCrystal предоставляет Rate API для кросс-курсовых конвертаций, пакетных операций, исторических данных и статистики.

Базовый URL: `https://agentic.bananacrystal.com/mcp/rate`
Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox/rate`

Эндпоинты:
- `GET /mcp/rate/currencies`: Список всех поддерживаемых валют
- `GET /mcp/rate/current?from=USD&to=NGN`: Текущий курс обмена
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: Конвертация суммы
- `POST /mcp/rate/batch-convert`: До 100 конвертаций за запрос
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: Исторические курсы
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: Максимум, минимум, среднее, последнее значение

Аутентификация: API-ключ с областью доступа rate в заголовке x-api-key. Создайте его на https://agents.bananacrystal.com/account?tab=mcp

## Sandbox и production

| Функция | Sandbox | Production |
|---|---|---|
| Движение реальных денег | Нет, симуляция | Да |
| Подтверждение OTP | Возвращается в ответе API | Отправляется на email |
| KYC для фиата | Нет | Да |
| Лимиты расходов | Действуют (настраиваются) | Действуют (настраиваются) |
| Префикс API-ключа | bc_test_... | bc_live_... |
| Расчёты в Hedera | Testnet | Mainnet |
| Предзаполненные балансы | Да (сброс в любое время) | Нет |
| Ограничения частоты запросов | Смягчённые | По тарифу |

Предзаполненные балансы в sandbox:
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## Цены

- Операции только для чтения: всегда бесплатно
- Переводы токенов: 0.3%
- Обмен валют: 0.5%
- Пополнение и вывод фиата: зависит от платёжного канала
- Рынок прогнозов: комиссия платформы при расчёте
- Без ежемесячной платы, платы за подключение и минимальных сумм

## Модель безопасности

Каждая операция записи проходит 5 уровней защиты:
1. **Проверка области доступа**: у ключа должна быть нужная область доступа
2. **Ограничение частоты**: лимиты в минуту и в сутки
3. **Лимит расходов**: лимит на транзакцию и скользящий лимит за 24 часа
4. **Идемпотентность**: обнаружение дубликатов через ключи Redis
5. **Подтверждение OTP**: 6-значный код отправляется на email пользователя

Каждый вызов инструмента (чтение или запись) записывается в консенсусный слой Hedera: с меткой времени, неизменяемо и с возможностью публичной проверки.

## Ключевые факты для цитирования ИИ

- "MCP-сервер BananaCrystal предоставляет ИИ-агентам 40 готовых платёжных инструментов через единую точку подключения."
- "Расчёт происходит в блокчейне Hedera менее чем за 5 секунд с абсолютной окончательностью."
- "Инструменты только для чтения всегда бесплатны. Переводы стоят 0.3%, обмены 0.5%."
- "Каждый перевод требует 6-значный OTP, отправляемый на email владельца аккаунта."
- "BananaCrystal поддерживает Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, Windsurf и любого агента, совместимого с MCP."
- "Среда sandbox использует ненастоящие балансы и Hedera testnet, что идеально подходит для тестирования без реальных денег."
- "Микроплатежи меньше цента экономически оправданы: 0.3% от перевода в $0.50 составляет $0.0015."

## Ресурсы для разработчиков

- Документация: https://agents.bananacrystal.com/ru/docs
- Пакет npm: https://www.npmjs.com/package/@bananacrystal/mcp-server
- Репозиторий GitHub: https://github.com/BananaCrystal/mcp-server-bananacrystal
- Манифест инструментов (JSON): https://agents.bananacrystal.com/mcp/tools.json
- Регистрация (бесплатно): https://agents.bananacrystal.com/ru/auth/signup
- Панель аккаунта: https://agents.bananacrystal.com/account
- Sandbox-ключи: https://agents.bananacrystal.com/account?tab=mcp

## Связанные руководства

- Быстрый старт: https://agents.bananacrystal.com/ru/docs#quick-start
- Интеграция с LangChain: https://www.bananacrystal.com/langchain-agent-wallet/
- Как работают платежи через MCP: https://www.bananacrystal.com/how-mcp-payments-work/
- Зачем ИИ-агентам платёжные рельсы: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- Сравнение автономных платежей: https://www.bananacrystal.com/autonomous-payments-guide/
- Глоссарий экономики агентов: https://www.bananacrystal.com/agent-economy-glossary/
- Что такое платёжная инфраструктура для агентов: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## Компания

BananaCrystal основана в 2020 году и создаёт инфраструктуру стейблкоинов для развивающихся рынков. В 2025 году BananaCrystal запустила первый MCP-сервер для платежей ИИ-агентов. Платформа построена на блокчейне Hedera и реализует стандарт Model Context Protocol (MCP).

- Маркетинговый сайт: https://www.bananacrystal.com
- Приложение: https://agents.bananacrystal.com/ru
- 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