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.

Документация BananaCrystal MCP | 40 платёжных инструментов для ИИ-агентов

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

Ваш ИИ-агент начнёт проводить платежи менее чем через 5 минут.

Установите MCP-сервер

Установите MCP-сервер BananaCrystal глобально через npm.

bash

npm install -g @bananacrystal/mcp-server

Получите API-ключ

Создайте MCP API-ключ в панели аккаунта. Sandbox-ключи начинаются с bc_test_ и бесплатны.

Получить API-ключ

Sandbox-ключи: bc_test_...

Настройте Claude Desktop

Добавьте BananaCrystal в файл конфигурации Claude Desktop.

claude_desktop_config.json

json

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

Попросите агента

Теперь у вашего агента 40 платёжных инструментов. Попробуйте такие запросы:

›"Какой у меня сейчас баланс USDb?"

›"Отправь 50 USDb на 0.0.654321"

›"Обменяй 100 USDb на NGNb по текущему курсу"

›"Покажи мои последние 10 транзакций"

›"Какой сейчас курс USD к NGN?"

Инструменты MCP

40 готовых платёжных инструментов в 6 категориях. Операции только для чтения всегда бесплатны.

Только чтение24 инструмента

ping

read_onlyбесплатно

Проверка работоспособности: возвращает pong

get_server_info

read_onlyбесплатно

Возвращает основную информацию о сервере

echo

read_onlyбесплатно

Возвращает входное сообщение обратно вызывающему

get_my_profile

read_onlyбесплатно

Получить полный профиль аутентифицированного пользователя

get_balances

read_onlyбесплатно

Получить баланс аккаунта Hedera по всем токенам платформы или по конкретному токену

get_exchange_rate

read_onlyбесплатно

Получить актуальные курсы покупки/продажи для валюты

list_supported_currencies

read_onlyбесплатно

Список всех поддерживаемых валют с динамическими комиссиями

list_available_tokens

read_onlyбесплатно

Список всех доступных токенов Hedera на платформе

get_transaction_history

read_onlyбесплатно

Получить историю транзакций по категориям с фильтрами

get_my_limits

read_onlyбесплатно

Получить настроенные лимиты и текущее использование для аутентифицированного API-ключа

estimate_swap_fees

read_onlyбесплатно

Оценить комиссии за обмен валюты перед выполнением

get_agent_config

read_onlyбесплатно

Посмотреть конфигурацию агента другого пользователя

check_approval_status

read_onlyбесплатно

Проверить статус ожидающего запроса на одобрение транзакции агента

get_kyc_status

read_onlyбесплатно

Получить статус проверки KYC пользователя через Sumsub

get_deposit_status

read_onlyбесплатно

Получить статус пополнения фиатом по ID перевода

get_withdrawal_status

read_onlyбесплатно

Получить запросы на вывод пользователя через Brale

get_escrow_balances

read_onlyбесплатно

Получить разбивку баланса эскроу: общая, доступная и заблокированная суммы

get_escrow_history

read_onlyбесплатно

Получить полную историю транзакций эскроу, включая блокировки, освобождения, выигрыши и проигрыши

list_offers

read_onlyбесплатно

Просмотреть активные предложения на рынке прогнозов со статистикой сделок

get_offer

read_onlyбесплатно

Получить полные детали одного предложения со статистикой сделок

get_my_offers

read_onlyбесплатно

Получить все предложения, созданные конкретным пользователем

list_trades

read_onlyбесплатно

Список всех сделок на платформе с фильтрами

get_trade

read_onlyбесплатно

Получить полные детали одной сделки со статистикой родительского предложения

get_my_trades

read_onlyбесплатно

Получить все сделки пользователя, включая созданные и полученные

Переводы2 инструмента

request_transfer_otp

transfer0.3%

Шаг 1: запросить код подтверждения OTP, отправляемый на email отправителя

transfer_tokens

transfer0.3%

Шаг 2: выполнить перевод токенов с подтверждением OTP

Обмен1 инструмент

swap_currency

swap0.5%

Обмен между двумя токенами Hedera с автоматическим расчётом курса и комиссий

Фиат3 инструмента

initiate_kyc

fiat

Запустить проверку KYC: возвращает токен доступа Sumsub для SDK

initiate_deposit

fiat

Инициировать пополнение фиатом через Brale (требуется KYC)

request_withdrawal

fiat

Запросить вывод фиата через Brale (требуется KYC)

Предложения и сделки6 инструментов

create_offer

offers

Создать предложение на рынке прогнозов с блокировкой всей суммы в эскроу

update_offer

offers

Изменить существующее предложение (только если по нему нет сделок)

delist_offer

offers

Снять предложение с маркетплейса и освободить заблокированный эскроу

delete_offer

offers

Удалить предложение навсегда (недоступно при наличии активных сделок)

engage_offer

offers

Принять открытое предложение, заблокировав встречный эскроу

cancel_trade

offers

Отменить активную сделку и освободить заблокированный эскроу

Между агентами3 инструмента

request_agent_transaction

transfer

Запросить транзакцию от имени агента другого пользователя (требуется одобрение по email)

execute_approved_transaction

transfer

Выполнить ранее одобренную транзакцию агента с помощью токена исполнения

update_my_agent_settings

read_onlyбесплатно

Настроить, требуют ли транзакции между агентами одобрения по email и OTP

Только sandbox1 инструмент

reset_sandbox_balance

read_onlyбесплатно

Сбросить балансы sandbox к начальным значениям (только sandbox)

Rate API

Расширенные операции с курсами валют через REST. Требуется API-ключ с областью доступа rate.

Инструмент MCP и Rate API: в чём разница?

MCP-сервер уже включает get_exchange_rate как инструмент read_only: агент может вызвать его напрямую и получить курс покупки/продажи одной валюты к USD. Этого достаточно для большинства задач агента.

Rate API идёт дальше: кросс-курсовые конвертации, пакетные операции, исторические временные ряды и статистические сводки. Они доступны как прямые HTTP-эндпоинты с аутентификацией по API-ключу с областью доступа rate. Создайте ключ rate в панели аккаунта.

Аутентификация

Все эндпоинты Rate API требуют API-ключ с областью доступа rate, передаваемый в заголовке x-api-key. Аналоги для sandbox доступны по адресу /mcp/sandbox/rate/* и используют ваш sandbox-ключ (bc_test_...) с фиксированными тестовыми курсами для воспроизводимого тестирования.

Базовый URL

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

GET/mcp/rate/currenciesСписок всех поддерживаемых валют

Список всех поддерживаемых валют

Пример запроса

bash

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

Пример ответа

json

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

GET/mcp/rate/currentПолучить текущий курс между двумя валютами

Получить текущий курс между двумя валютами

Параметры

Название	Обязательно	Описание
`from`	обязательно	Код исходной валюты (например, USD)
`to`	обязательно	Код целевой валюты (например, NGN)

Пример запроса

bash

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

Пример ответа

json

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

GET/mcp/rate/convertКонвертировать сумму из одной валюты в другую

Конвертировать сумму из одной валюты в другую

Параметры

Название	Обязательно	Описание
`from`	обязательно	Код исходной валюты
`to`	обязательно	Код целевой валюты
`amount`	обязательно	Сумма для конвертации (число)

Пример запроса

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"

Пример ответа

json

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

POST/mcp/rate/batch-convertКонвертировать несколько сумм за один запрос (максимум 100)

Конвертировать несколько сумм за один запрос (максимум 100)

Пример запроса

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

Пример ответа

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/historyПолучить исторические курсы для валютной пары

Получить исторические курсы для валютной пары

Параметры

Название	Обязательно	Описание
`from`	обязательно	Код исходной валюты
`to`	обязательно	Код целевой валюты
`startDate`	обязательно	Дата начала (ISO 8601, например 2026-04-01)
`endDate`	обязательно	Дата окончания (ISO 8601, например 2026-04-30)

Пример запроса

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"

Пример ответа

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/statsПолучить статистику курса (максимум, минимум, среднее, последнее) за период

Получить статистику курса (максимум, минимум, среднее, последнее) за период

Параметры

Название	Обязательно	Описание
`from`	обязательно	Код исходной валюты
`to`	обязательно	Код целевой валюты
`days`	необязательно	Период в днях, от 1 до 365 (по умолчанию: 30)

Пример запроса

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"

Пример ответа

json

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

Rate API в sandbox

Замените /mcp/rate/ на /mcp/sandbox/rate/ и используйте sandbox-ключ, чтобы получать фиксированные тестовые курсы. Исторические данные генерируются с отклонением ±2% для реалистичного тестирования. Реальные данные бирж не используются.

Среда sandbox

Безопасно тестируйте интеграцию с предзаполненными балансами и без реальных денег.

Что такое sandbox?

Sandbox: полностью изолированная тестовая среда, которая точно повторяет production: те же инструменты, тот же API и тот же формат ответов. Реальные деньги не перемещаются. Sandbox API-ключи начинаются с bc_test_ и подключаются к Hedera testnet.

Предзаполненные балансы

Каждый sandbox-аккаунт начинается с этих балансов. Используйте reset_sandbox_balance, чтобы восстановить их в любой момент.

Токен	Сумма	Валюта
`USDb`	10,000	USD
`NGNb`	5,000,000	NGN
`GHSb`	50,000	GHS
`KESb`	1,000,000	KES
`ZARb`	150,000	ZAR

Sandbox и боевой режим

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

OTP в sandbox

В режиме sandbox код OTP возвращается прямо в ответе API request_transfer_otp, а не отправляется по email. Это упрощает автоматическое тестирование без доступа к почте.

Конфигурация 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"
      }
    }
  }
}

Настройка

Подключите BananaCrystal к своему ИИ-инструменту или фреймворку.

claude_desktop_config.json

json

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

Переменные окружения

BANANACRYSTAL_API_KEYобязательно

Ваш MCP API-ключ. Sandbox-ключи начинаются с bc_test_, боевые с bc_live_.

По умолчанию: N/A

BANANACRYSTAL_API_URLнеобязательно

Переопределить URL точки MCP. Для тестирования используйте URL sandbox.

По умолчанию: https://agentic.bananacrystal.com/mcp

DEBUGнеобязательно

Установите true, чтобы включить подробное логирование запросов и ответов.

По умолчанию: false

Переменная	Обязательно	По умолчанию	Описание
`BANANACRYSTAL_API_KEY`	обязательно	`N/A`	Ваш MCP API-ключ. Sandbox-ключи начинаются с bc_test_, боевые с bc_live_.
`BANANACRYSTAL_API_URL`	необязательно	`https://agentic.bananacrystal.com/mcp`	Переопределить URL точки MCP. Для тестирования используйте URL sandbox.
`DEBUG`	необязательно	`false`	Установите true, чтобы включить подробное логирование запросов и ответов.

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

Готовые к запуску примеры для самых популярных фреймворков ИИ-агентов.

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

Подходит любой фреймворк, совместимый с MCP. Если ваш фреймворк поддерживает MCP-серверы по HTTP, направьте его на https://agentic.bananacrystal.com/mcp с API-ключом в качестве Bearer-токена.

Архитектура безопасности

Несколько уровней защиты, чтобы агент мог делать только то, что вы явно разрешили.

Области доступа API-ключей

У каждого API-ключа есть явные области доступа. Агент может выполнять только операции в пределах выданных вами областей.

Лимиты расходов

Задайте жёсткие максимумы на транзакцию и скользящие дневные лимиты за 24 часа для каждого API-ключа. Они применяются на уровне инфраструктуры.

Подтверждение OTP

Каждый перевод токенов требует 6-значного OTP, отправляемого на ваш зарегистрированный email. Агент не может завершить перевод без этого кода от вас.

Ограничение частоты запросов

Лимиты в минуту для каждого ключа не дают вышедшим из-под контроля агентам перегружать API. Лимиты зависят от вашего тарифа.

Неизменяемый журнал аудита

Каждый вызов инструмента записывается в консенсусный слой Hedera. Записи имеют метку времени, защищены от подделки и публично проверяемы в блокчейне. Полная история аудита доступна через get_transaction_history.

Одобрение действий агента

Транзакции между агентами могут требовать одобрения человеком по email перед выполнением. Используйте update_my_agent_settings, чтобы настроить require_human_approval.

Области доступа API-ключей

read_only

Проверять балансы, курсы, историю и лимиты без перемещения средств

transfer

Отправлять токены на другие аккаунты (требуется OTP)

swap

Обменивать валютные стейблкоины

fiat

Пополнять и выводить фиат (требуется KYC)

offers

Создавать и управлять предложениями и сделками на рынке прогнозов

rate

Получать курсы обмена валют, исторические данные, конвертации и статистику курсов

Область	Что разрешает
read_only	Проверять балансы, курсы, историю и лимиты без перемещения средств
transfer	Отправлять токены на другие аккаунты (требуется OTP)
swap	Обменивать валютные стейблкоины
fiat	Пополнять и выводить фиат (требуется KYC)
offers	Создавать и управлять предложениями и сделками на рынке прогнозов
rate	Получать курсы обмена валют, исторические данные, конвертации и статистику курсов

Цены

Операции только для чтения всегда бесплатны. Платите только за транзакции, которые перемещают средства.

Комиссии за операции

Операции только для чтения

get_balances, get_exchange_rate, list_trades, …

Бесплатно

Переводы токенов

transfer_tokens

0.3%

Обмен валют

swap_currency

0.5%

Пополнение фиатом

initiate_deposit

Зависит от канала

Вывод фиата

request_withdrawal

Зависит от канала

Рынок прогнозов

create_offer, engage_offer

Комиссия платформы при расчёте

Операция	Инструменты	Комиссия
Операции только для чтения	get_balances, get_exchange_rate, list_trades, …	Бесплатно
Переводы токенов	transfer_tokens	0.3%
Обмен валют	swap_currency	0.5%
Пополнение фиатом	initiate_deposit	Зависит от канала
Вывод фиата	request_withdrawal	Зависит от канала
Рынок прогнозов	create_offer, engage_offer	Комиссия платформы при расчёте