Szybki start
Niech Twój agent AI wykonuje płatności w mniej niż 5 minut.
Pobierz klucz API
Utwórz klucz API MCP w panelu konta. Klucze sandboksowe zaczynają się od bc_test_ i są darmowe.
bc_test_...Skonfiguruj Claude Desktop
Dodaj BananaCrystal do pliku konfiguracyjnego Claude Desktop.
{
"mcpServers": {
"bananacrystal": {
"url": "https://agentic.bananacrystal.com/mcp",
"headers": {
"x-api-key": "bc_test_your_sandbox_key_here"
}
}
}
}Zapytaj agenta
Twój agent ma teraz 39 narzędzi płatniczych. Wypróbuj te polecenia:
Narzędzia MCP
39 gotowych do produkcji narzędzi płatniczych w 6 kategoriach. Operacje tylko do odczytu są zawsze darmowe.
pingget_server_infoechoget_my_profileget_balancesget_exchange_ratelist_supported_currencieslist_available_tokensget_transaction_historyget_my_limitsestimate_swap_feesget_agent_configcheck_approval_statusget_kyc_statusget_escrow_balancesget_escrow_historylist_offersget_offerget_my_offerslist_tradesget_tradeget_my_tradesrequest_transfer_otptransfer_tokensswap_currencyinitiate_kyccreate_offerupdate_offerdelist_offerdelete_offerengage_offercancel_traderequest_agent_transactionexecute_approved_transactionupdate_my_agent_settingsreset_sandbox_balanceRate API
Zaawansowane operacje na kursach walut przez REST. Wymaga klucza API z zakresem rate.
Narzędzie MCP a Rate API: na czym polega różnica?
Serwer MCP zawiera już get_exchange_rate jako narzędzie read_only: agent może wywołać je bezpośrednio, aby pobrać kurs kupna/sprzedaży jednej waluty względem USD. To wystarcza w większości zastosowań agentów.
Rate API idzie dalej: przeliczenia między parami, operacje zbiorcze, historyczne szeregi czasowe i podsumowania statystyczne. Są dostępne jako bezpośrednie endpointy HTTP uwierzytelniane kluczem API z zakresem rate. Utwórz klucz rate w panelu konta.
Uwierzytelnianie
Wszystkie endpointy Rate API wymagają klucza API z zakresem rate przekazanego w nagłówku x-api-key. Odpowiedniki sandboksowe są dostępne pod /mcp/sandbox/rate/* i używają Twojego klucza sandboksowego (bc_test_...) ze stałymi kursami testowymi, co pozwala na powtarzalne testy.
/mcp/rate/currenciesWyświetla wszystkie obsługiwane waluty
Przykładowe żądanie
curl "https://agentic.bananacrystal.com/mcp/rate/currencies" \
-H "x-api-key: your_api_key_here"Przykładowa odpowiedź
{
"count": 11,
"currencies": ["EGP", "EUR", "GBP", "GHS", "KES", "NGN", "TZS", "UGX", "USD", "XOF", "ZAR"]
}/mcp/rate/currentPobiera aktualny kurs wymiany między dwiema walutami
Parametry
| Nazwa | Wymagane | Opis |
|---|---|---|
from | wymagane | Kod waluty źródłowej (np. USD) |
to | wymagane | Kod waluty docelowej (np. NGN) |
Przykładowe żądanie
curl "https://agentic.bananacrystal.com/mcp/rate/current?from=USD&to=NGN" \
-H "x-api-key: your_api_key_here"Przykładowa odpowiedź
{
"from": "USD",
"to": "NGN",
"rate": 1584.75,
"buyRate": 1579.5,
"sellRate": 1590.0,
"timestamp": "2026-04-30T10:22:00.000Z"
}/mcp/rate/convertPrzelicza kwotę z jednej waluty na inną
Parametry
| Nazwa | Wymagane | Opis |
|---|---|---|
from | wymagane | Kod waluty źródłowej |
to | wymagane | Kod waluty docelowej |
amount | wymagane | Kwota do przeliczenia (liczba) |
Przykładowe żądanie
curl "https://agentic.bananacrystal.com/mcp/rate/convert?from=USD&to=NGN&amount=100" \
-H "x-api-key: your_api_key_here"Przykładowa odpowiedź
{
"from": "USD",
"to": "NGN",
"amount": 100,
"converted": 158475.0,
"rate": 1584.75,
"timestamp": "2026-04-30T10:22:00.000Z"
}/mcp/rate/batch-convertPrzelicza wiele kwot w jednym żądaniu (maks. 100)
Przykładowe żądanie
curl -X POST "https://agentic.bananacrystal.com/mcp/rate/batch-convert" \
-H "x-api-key: your_api_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 }
]
}'Przykładowa odpowiedź
[
{ "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": "..." }
]/mcp/rate/historyPobiera historyczne kursy wymiany dla pary walut
Parametry
| Nazwa | Wymagane | Opis |
|---|---|---|
from | wymagane | Kod waluty źródłowej |
to | wymagane | Kod waluty docelowej |
startDate | wymagane | Data początkowa (ISO 8601, np. 2026-04-01) |
endDate | wymagane | Data końcowa (ISO 8601, np. 2026-04-30) |
Przykładowe żądanie
curl "https://agentic.bananacrystal.com/mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30" \
-H "x-api-key: your_api_key_here"Przykładowa odpowiedź
[
{ "date": "2026-04-01T00:00:00.000Z", "from": "USD", "to": "NGN", "buyRate": 1575.0, "sellRate": 1580.0, "midRate": 1577.5 },
{ "date": "2026-04-02T00:00:00.000Z", "from": "USD", "to": "NGN", "buyRate": 1577.0, "sellRate": 1582.0, "midRate": 1579.5 }
]/mcp/rate/statsPobiera statystyki kursu (maksimum, minimum, średnia, ostatni) za okres
Parametry
| Nazwa | Wymagane | Opis |
|---|---|---|
from | wymagane | Kod waluty źródłowej |
to | wymagane | Kod waluty docelowej |
days | opcjonalne | Okres w dniach, od 1 do 365 (domyślnie: 30) |
Przykładowe żądanie
curl "https://agentic.bananacrystal.com/mcp/rate/stats?from=USD&to=NGN&days=30" \
-H "x-api-key: your_api_key_here"Przykładowa odpowiedź
{
"from": "USD",
"to": "NGN",
"period": "30d",
"high": 1598.0,
"low": 1560.0,
"avg": 1581.4,
"latest": 1584.75,
"count": 30
}Sandboksowe Rate API
Zastąp /mcp/rate/ ścieżką /mcp/sandbox/rate/ i użyj klucza sandboksowego, aby otrzymywać stałe kursy testowe. Dane historyczne są generowane z odchyleniem ±2% dla realistycznych testów. Nie są używane prawdziwe dane kursowe.
Środowisko Sandbox
Testuj integrację bezpiecznie, z wstępnie zasilonymi saldami i bez prawdziwych pieniędzy.
Czym jest sandbox?
Sandbox to w pełni odizolowane środowisko testowe, które dokładnie odwzorowuje produkcję: te same narzędzia, to samo API i ten sam format odpowiedzi. Prawdziwe pieniądze nie są przenoszone. Klucze API sandboksa zaczynają się od bc_test_ i łączą się z testnetem Hedera.
Wstępnie zasilone salda
Każde konto sandboksowe zaczyna z tymi saldami. Użyj reset_sandbox_balance, aby przywrócić je w dowolnym momencie.
| Token | Kwota | Waluta |
|---|---|---|
USDb | 10,000 | USD |
NGNb | 5,000,000 | NGN |
GHSb | 50,000 | GHS |
KESb | 1,000,000 | KES |
ZARb | 150,000 | ZAR |
Sandbox a produkcja
| Funkcja | Sandbox | Produkcja |
|---|---|---|
| Ruch prawdziwych pieniędzy | Nie: tylko symulacja | Tak |
| Weryfikacja OTP | Zwracana w odpowiedzi API | Wysyłana na Twój e-mail |
| KYC wymagane dla fiat | Nie | Tak |
| Egzekwowane limity wydatków | Tak (konfigurowalne) | Tak |
| Prefiks klucza API | bc_test_... | 3f9a1c... |
| Rozliczenie na Hedera | Testnet | Mainnet |
| Wstępnie zasilone salda | Tak (reset w dowolnym momencie) | Nie |
| Limity żądań | Łagodne | Zależne od planu |
OTP w sandboksie
W trybie sandbox kod OTP jest zwracany bezpośrednio w odpowiedzi API request_transfer_otp zamiast wysyłki e-mailem. Ułatwia to automatyczne testy bez dostępu do poczty.
Konfiguracja sandboksa
{
"mcpServers": {
"bananacrystal": {
"url": "https://agentic.bananacrystal.com/mcp/sandbox",
"headers": {
"x-api-key": "bc_test_your_sandbox_key_here"
}
}
}
}Konfiguracja
Połącz BananaCrystal z ulubionym narzędziem AI lub frameworkiem.
{
"mcpServers": {
"bananacrystal": {
"url": "https://agentic.bananacrystal.com/mcp",
"headers": {
"x-api-key": "your_api_key_here"
}
}
}
}Integracje z frameworkami
Gotowe do uruchomienia przykłady dla najpopularniejszych frameworków agentów AI.
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 39 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())Działa każdy framework zgodny z MCP. Jeśli Twój framework obsługuje serwery MCP przez HTTP, skieruj go na https://agentic.bananacrystal.com/mcp, podając klucz API jako token Bearer.
Architektura bezpieczeństwa
Wiele warstw ochrony sprawia, że agent może robić tylko to, na co wyraźnie pozwolisz.
Zakresy kluczy API
Każdy klucz API ma jawne zakresy uprawnień. Agent może wykonywać tylko operacje w przyznanych przez Ciebie zakresach.
Limity wydatków
Ustaw twarde maksima na transakcję i kroczące limity dzienne (24 godziny) dla każdego klucza API. Są egzekwowane na poziomie infrastruktury.
Weryfikacja OTP
Przelewy wymagają 6-cyfrowego kodu wysyłanego na Twój zarejestrowany e-mail, domyślnie włączonego. Bez tego kodu agent nie dokończy przelewu.
Limity żądań
Limity na minutę dla każdego klucza chronią API przed wymykającymi się spod kontroli agentami. Limity rosną wraz z poziomem planu.
Historia aktywności
Każde wywołanie narzędzia jest zapisywane i dostępne w historii Twojego konta.
Zatwierdzanie transakcji agentów
Transakcje między agentami mogą wymagać zatwierdzenia e-mailem przez człowieka przed wykonaniem. Użyj update_my_agent_settings, aby skonfigurować require_human_approval.
Zakresy kluczy API
Sprawdzanie sald, kursów, historii i limitów bez przenoszenia środków
Wysyłanie tokenów na inne konta (wymaga OTP)
Wymiana stablecoinów walutowych
Wpłaty i wypłaty fiat (wymaga KYC)
Tworzenie ofert i transakcji na rynku prognoz oraz zarządzanie nimi
Dostęp do kursów wymiany walut, danych historycznych, przeliczeń i statystyk kursowych
| Zakres | Na co pozwala |
|---|---|
| read_only | Sprawdzanie sald, kursów, historii i limitów bez przenoszenia środków |
| transfer | Wysyłanie tokenów na inne konta (wymaga OTP) |
| swap | Wymiana stablecoinów walutowych |
| fiat | Wpłaty i wypłaty fiat (wymaga KYC) |
| offers | Tworzenie ofert i transakcji na rynku prognoz oraz zarządzanie nimi |
| rate | Dostęp do kursów wymiany walut, danych historycznych, przeliczeń i statystyk kursowych |
Cennik
Operacje tylko do odczytu są zawsze darmowe. Płacisz tylko za transakcje, które przenoszą wartość.
Opłaty za operacje
Operacje tylko do odczytu
get_balances, get_exchange_rate, list_trades, …
Przelewy tokenów
transfer_tokens
Wymiana walut
swap_currency
Wpłaty fiat
initiate_deposit
Wypłaty fiat
request_withdrawal
Rynek prognoz
create_offer, engage_offer
| Operacja | Narzędzia | Opłata |
|---|---|---|
| Operacje tylko do odczytu | get_balances, get_exchange_rate, list_trades, … | Za darmo |
| Przelewy tokenów | transfer_tokens | 0.3% |
| Wymiana walut | swap_currency | 0.5% |
| Wpłaty fiat | initiate_deposit | Zależnie od kanału |
| Wypłaty fiat | request_withdrawal | Zależnie od kanału |
| Rynek prognoz | create_offer, engage_offer | Opłata platformy przy rozliczeniu |
Plany
Darmowy
Wszystkie narzędzia tylko do odczytu są zawsze darmowe. Do sprawdzania kursów i sald nie potrzebujesz konta.
- Wszystkie narzędzia tylko do odczytu za darmo na zawsze
- Środowisko sandbox w zestawie
- get_balances, get_exchange_rate i 22 inne
- Wsparcie społeczności
- Rozliczenie na testnecie Hedera
Płatność za użycie
Skaluj się wraz z rozwojem. Płać tylko za to, z czego korzystasz.
- Nielimitowane wywołania API
- 0.3% od przelewów
- 0.5% od wymian
- Kanały fiat (zależnie od metody)
- Wsparcie e-mail + priorytetowe
- Rozliczenie na mainnecie Hedera
- Pełna historia aktywności
Enterprise
Rabaty wolumenowe, SLA i dedykowana infrastruktura.
- Indywidualne progi opłat
- Dedykowany endpoint MCP
- Gwarancje SLA
- Indywidualne limity wydatków
- Dedykowane wsparcie
- Opcja on-premise
FAQ
Najczęstsze pytania o BananaCrystal i serwer MCP.
BananaCrystal to hostowany serwer MCP, dzięki któremu agent AI może przechowywać i wydawać pieniądze. Udostępnia 39 narzędzi do sald, kursów walut na żywo, swapów między ponad 140 stablecoinami w walutach lokalnych, przelewów do innych użytkowników oraz wpłat i wypłat fiat. Odczyty są darmowe; przelewy kosztują 0,3%, a swapy 0,5%. Limity wydatków, klucze z zakresem uprawnień i kod e-mail przy przelewach, domyślnie włączony, są egzekwowane na serwerze.
Dodaj https://agentic.bananacrystal.com/mcp jako zdalny serwer MCP w swoim kliencie i wpisz klucz API w nagłówku x-api-key. Blok konfiguracji znajdziesz w sekcji Konfiguracja na tej stronie. Jeśli Twój klient uruchamia tylko polecenia lokalne, użyj npx -y mcp-remote https://agentic.bananacrystal.com/mcp z tym samym nagłówkiem.
Nie. Klucze sandbox są darmowe, mają salda testowe i nigdy nie przenoszą prawdziwych pieniędzy.
0,3%. Swap kosztuje 0,5%. Odczyty są darmowe. Nie ma opłaty miesięcznej.
Klucze z zakresem uprawnień, maksimum na transakcję, kroczący limit 24-godzinny i kod e-mail przy przelewach (domyślnie włączony), wszystko egzekwowane na serwerze. Agent nigdy nie trzyma klucza prywatnego.
Ponad 140 stablecoinów w walutach lokalnych na Hedera, każdy zabezpieczony jeden do jednego depozytami. Poproś agenta o wywołanie list_supported_currencies, aby zobaczyć pełną listę.
Tak. BananaCrystal jest zarejestrowaną firmą świadczącą usługi pieniężne (money services business) w Stanach Zjednoczonych i Kanadzie.
Nie. Serwer jest hostowany i utrzymywany przez BananaCrystal. Repozytorium GitHub zawiera tylko konfigurację klienta.
Napisz na security@bananacrystal.com. Nasza polityka bezpieczeństwa jest w pliku SECURITY.md w repozytorium github.com/BananaCrystal/mcp-server-bananacrystal.
API używa standardowych kodów statusu HTTP. 400 Bad Request: nieprawidłowe parametry (sprawdź komunikat błędu, aby poznać konkretne pole). 401 Unauthorized: brak lub nieprawidłowy klucz API. 403 Forbidden: operacja wykracza poza zakresy uprawnień klucza. 422 Unprocessable Entity: błąd logiki biznesowej (np. niewystarczające saldo lub niezgodny OTP). 429 Too Many Requests: przekroczono limit żądań; wstrzymaj się i ponów po czasie z nagłówka Retry-After. 500 Internal Server Error: przejściowy problem serwera; można bezpiecznie ponowić z wykładniczym opóźnieniem.
Plan darmowy: 60 żądań/minutę, 1,000 żądań/dzień. Płatność za użycie: 300 żądań/minutę, 10,000 żądań/dzień. Enterprise: indywidualne limity ustalane w umowie. Limity są egzekwowane dla każdego klucza API. Po przekroczeniu limitu API zwraca 429 z nagłówkiem Retry-After. Narzędzia tylko do odczytu (get_balances, get_exchange_rate itd.) wliczają się do tych samych limitów co narzędzia zapisu.
Porównanie
| BananaCrystal MCP | API kart | Przelew bankowy | |
|---|---|---|---|
| Konfiguracja | 5 minut, jeden URL | Dni, konto sprzedawcy | Dni, KYB |
| Koszt wysyłki | 0,3% | 2,9% + 0,30 $ | Przelew SWIFT od 15 $ do 45 $ |
| Rozliczenie | Poniżej 5 sekund | 2 do 3 dni | 1 do 5 dni |
| Waluty | Ponad 140 lokalnych | Waluty kart | Zależnie od banku |
| Limity agenta | Wbudowane, po stronie serwera | Brak | Brak |
Chcesz dać agentowi portfel?
Utwórz klucz API i połącz agenta z 39 narzędziami płatniczymi w mniej niż 5 minut. Narzędzia tylko do odczytu są zawsze darmowe.
Pobierz klucz API