BananaCrystal MCP Server
OfficialBananaCrystal MCP server gives an AI agent a hosted wallet for FX, swaps, transfers, fiat/KYC, and prediction-market operations, with server-enforced limits and OTP/approval guardrails.
Check server health/info and echo messages.
View profile, Hedera token balances, supported currencies/tokens, exchange rates, swap-fee estimates, transaction history, and API-key limits.
Transfer tokens with OTP flow; swap 140+ local-currency stablecoins; update agent OTP/human-approval/webhook settings.
Run KYC, initiate fiat deposits/withdrawals, and check deposit/withdrawal status.
Browse/create/update/delist/delete prediction-market offers and engage/cancel trades.
View trade and escrow balances/history.
Reset sandbox balances for
bc_test_keys.Request agent-to-agent transactions, check approval status, execute approved transactions, and read other users' agent config.
Enables CrewAI agents to manage treasury operations, including balance inquiries, transfers, and spending limits, through MCP tools.
Provides the underlying blockchain for fast (under 5 seconds) and immutable settlement of agent payments, with low fees and finality.
Provides tools for LangChain agents to perform financial operations such as balance checks, payments with memos, and currency swaps, with on-chain settlement.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BananaCrystal MCP Server what's my current balance?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BananaCrystal MCP Server
Give your AI agent a wallet: live FX rates, swaps and payments in 140+ local currencies.
One hosted MCP endpoint. 40 tools. Free sandbox. Settles on Hedera in under 5 seconds.
https://agentic.bananacrystal.com/mcpDocs · Get a free sandbox key · API reference · Security policy
What this is
BananaCrystal is a hosted MCP server that gives an AI agent a wallet it can actually spend from. The agent can check balances, get a live exchange rate, swap between 140+ local-currency stablecoins, send money to another user, and move funds in and out of fiat, all through standard MCP tool calls. Limits are enforced on our side, so the agent never holds a private key and can never spend past the cap you set.
This repository holds the configuration files for connecting an MCP client to the hosted server. There is nothing to install or run locally. The server itself is hosted and maintained by BananaCrystal.
Related MCP server: remit.md MCP Server
Connect in five minutes
Create a free account at agents.bananacrystal.com/account and copy a sandbox key. Sandbox keys start with
bc_test_and come with test balances, so nothing real moves.Add the server to your MCP client.
Ask your agent: "What is my USDb balance?"
Claude Desktop, Claude Code, Cursor, Windsurf, VS Code
Add this to your client's MCP config (claude_desktop_config.json, ~/.cursor/mcp.json, .vscode/mcp.json, or the equivalent):
{
"mcpServers": {
"bananacrystal": {
"url": "https://agentic.bananacrystal.com/mcp",
"headers": {
"x-api-key": "bc_test_your_key"
}
}
}
}Clients that do not yet accept a url entry directly (older Claude Desktop builds) can use mcp-remote:
{
"mcpServers": {
"bananacrystal": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://agentic.bananacrystal.com/mcp",
"--header", "x-api-key:${BANANACRYSTAL_API_KEY}"
],
"env": { "BANANACRYSTAL_API_KEY": "bc_test_your_key" }
}
}
}Claude Code (one line)
claude mcp add --transport http bananacrystal https://agentic.bananacrystal.com/mcp --header "x-api-key: bc_test_your_key"Gemini CLI
gemini extensions install https://github.com/BananaCrystal/mcp-server-bananacrystal
export BANANACRYSTAL_API_KEY=bc_test_your_keyKiro
Click the badge to add the server to Kiro, then replace bc_test_your_key with your own key.
ChatGPT, Claude.ai connectors, and OAuth clients
Add https://agentic.bananacrystal.com/mcp as a custom connector or remote MCP server. Leave the API key empty and the client will walk you through OAuth 2.0 sign-in. The server advertises its authorization server at /.well-known/oauth-protected-resource.
Any language, no SDK
The server speaks Streamable HTTP, so any MCP client library works. The only thing you need is the URL and a key.
curl -s https://agentic.bananacrystal.com/mcp \
-H "content-type: application/json" \
-H "x-api-key: bc_test_your_key" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'What your agent can do
Group | Tools | Fee |
Read-only |
| Free |
Transfer |
| 0.3% |
Swap |
| 0.5% |
Fiat |
| Partner rate shown before you confirm |
Offers and trades |
| Free to list |
Agent to agent |
| 0.3% |
The full list with input schemas is at agents.bananacrystal.com/docs/mcp. Every tool also returns its schema through tools/list.
Example: pay an invoice in rupiah
User: Pay Putri's invoice: Rp 1,500,000 from my USD balance.
Agent: get_exchange_rate(USD, IDR) -> 1 USD = 16,360 IDR
swap_currency(91.69 USDb -> IDRb) -> 1,500,000 IDRb, fee 0.5%
request_transfer_otp() -> code sent to your email
[you enter the 6-digit code]
transfer_tokens(1,500,000 IDRb, @putri) -> settled in 3.4s
Paid. Total cost $0.73. Receipt saved.Guardrails
Everything that limits spending lives on the server, not in the agent's prompt.
Scoped API keys. Each key gets only the scopes it needs:
read,transfer,swap,fiat. A read-only key cannot move money, whatever the prompt says.Per-transaction maximum and rolling 24-hour cap, set per key in your account and enforced server-side. A runaway loop stops at the number you chose.
Email one-time code on transfers, swaps and withdrawals, on by default. The agent can request the code; only you can supply it.
Idempotent requests. Retrying a call never pays twice.
Sandbox is a separate environment.
bc_test_keys never touch real balances.
Pricing
Reads are free. Transfers cost 0.3% and swaps 0.5%, charged in the currency you send. There is no monthly fee, no minimum and no per-call charge. Fiat deposits and withdrawals carry the partner's rate, which the agent sees before it confirms.
Sandbox and production
Sandbox | Production | |
Key format |
| 64 hex characters, no prefix |
Balances | Test funds, reset on request | Real |
KYC | Not required | Required before fiat tools |
Rate limit | Returned by | Returned by |
About BananaCrystal
BananaCrystal is a registered money services business in the United States (FinCEN) and Canada (FINTRAC). Stablecoins are issued on Hedera and each local-currency token is backed one to one by the deposits that minted it. Learn more at bananacrystal.com.
Support and security
Questions and integration help: support@bananacrystal.com
Security reports: security@bananacrystal.com. Please read SECURITY.md before reporting.
Privacy policy: bananacrystal.com/privacy
License
The configuration files in this repository are released under the MIT License. Use of the hosted server is governed by the BananaCrystal Terms and Conditions.
Available Tools
40 toolscancel_tradeAInspect
Cancel an active trade and release your locked escrow. Only possible while trade is active.
Inputs: tradeId (required), userId.
check_approval_statusBInspect
Check the status of a pending agent transaction approval
Inputs: approvalRequestId (required).
create_offerAInspect
Create a prediction market offer. The creator locks totalAmount in escrow.
Inputs: amount (required), currency (required), leverage (required), offerType (required), +12 more.
delete_offerAInspect
Permanently delete your own offer. Blocked if the offer has active trades.
Inputs: offerId (required), userId.
delist_offerAInspect
Delist (deactivate) your own offer from the marketplace. Releases locked escrow.
Inputs: offerId (required), userId.
engage_offerCInspect
Engage (trade against) an open offer. The trader locks the same totalAmount in escrow.
Inputs: amount (required), offerId (required), currency (required), tradeType (required), +5 more.
estimate_swap_feesAInspect
Estimate fees for a currency swap before executing
Inputs: amount (required), toCurrency (required), fromCurrency (required).
execute_approved_transactionBInspect
Execute a transaction after it has been approved
Inputs: executionToken (required), approvalRequestId (required).
get_agent_configBInspect
Look up another user's agent configuration
Inputs: targetOwnerUserExtId (required).
get_balancesAInspect
Get Hedera account balances for all tokens or a specific token
Inputs: tokenId, accountId.
get_deposit_statusAInspect
Get the status of a fiat deposit by transfer ID
Inputs: transferId (required), userId.
get_escrow_balancesAInspect
Get a user's escrow balance breakdown, including total, available, and locked amounts
Inputs: userId.
get_escrow_historyBInspect
Get a user's full escrow transaction history, covering locks, releases, wins, losses, and fees
Inputs: userId.
get_exchange_rateAInspect
Get current buy/sell exchange rates for a currency
Inputs: currency (required).
get_kyc_statusBInspect
Get KYC verification status for a user
Inputs: userId.
get_my_limitsAInspect
Get your API key limits and current usage
Inputs: no named parameters.
get_my_offersAInspect
Get all offers created by a specific user
Inputs: userId, offerType.
get_my_profileAInspect
Get your BananaCrystal profile including user ID, wallets, and account details
Inputs: no named parameters.
get_my_tradesAInspect
Get all trades for a user, including trades they created and trades on offers they own
Inputs: state, userId, tradeType.
get_offerAInspect
Get full details of a single offer including trade stats and time remaining
Inputs: offerId (required).
get_server_infoBInspect
Returns basic server information
Inputs: no named parameters.
get_tradeAInspect
Get full details of a single trade including the parent offer stats
Inputs: tradeId (required).
get_transaction_historyBInspect
Get your transaction history with filtering options
Inputs: page, type, limit, direction.
get_withdrawal_statusAInspect
Get withdrawal requests for a user via Brale
Inputs: userId.
initiate_depositBInspect
Initiate a fiat deposit via Brale. Requires verified KYC.
Inputs: amount (required), currency (required), userId, railType, +1 more.
initiate_kycAInspect
Initiate KYC verification for a user. Returns a Sumsub access token.
Inputs: userId, ttlInSecs.
list_available_tokensAInspect
List all available Hedera tokens for the platform
Inputs: no named parameters.
list_offersAInspect
Browse the prediction market. Returns active offers with trade stats.
Inputs: page, limit, search, sortBy, +2 more.
list_supported_currenciesAInspect
List all supported currencies and tokens on BananaCrystal
Inputs: no named parameters.
list_tradesAInspect
List all trades on the platform. Filter by trade type or state.
Inputs: state, tradeType.
request_agent_transactionAInspect
Request a transaction on behalf of another user. They will receive an email to approve.
Inputs: amount (required), currency (required), transactionType (required), transactionParams (required), +3 more.
request_transfer_otpAInspect
Step 1: Request an OTP code to authorize a token transfer. An email will be sent with the code.
Inputs: amount (required), tokenId (required), recipientAccountId (required), tokenSymbol.
request_withdrawalAInspect
Request a fiat withdrawal via Brale. Requires verified KYC.
Inputs: amount (required), currency (required), userId, railType, +1 more.
reset_sandbox_balanceAInspect
Reset your sandbox account balances back to the default pre-seeded amounts. Only works with sandbox keys (bc_test_*).
Inputs: no named parameters.
swap_currencyBInspect
Swap between two Hedera tokens. Exchange rate calculated automatically.
Inputs: toTokenId (required), fromAmount (required), fromTokenId (required), memo.
transfer_tokensAInspect
Step 2: Execute the token transfer. If OTP is enabled on your key (default), provide otpCode and transactionRef from request_transfer_otp. If OTP is disabled, these fields are not required.
Inputs: amount (required), tokenId (required), recipientAccountId (required), otpCode, +2 more.
update_my_agent_settingsAInspect
Update agent approval settings (require_human_approval, require_otp, callback_url)
Inputs: requireOtp, callbackUrl, requireHumanApproval.
update_offerAInspect
Edit an existing offer. Only allowed when the offer has no trades yet.
Inputs: offerId (required), userId, isActive, advertiser, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Most tools clearly target distinct resources and actions, but list_supported_currencies and list_available_tokens are nearly identical in purpose, and delist_offer vs delete_offer could confuse agents. These minor overlaps prevent a perfect score.
All tool names follow a consistent snake_case verb_noun pattern (get_, list_, create_, update_, delete_, request_, etc.). Even exceptions like ping and echo are simple verbs that fit the style. No mixed casing or arbitrary names.
With 40 tools, the server exposes a very large surface area. Although the platform spans multiple subsystems, this count far exceeds the typical well-scoped range and will burden agents with selection complexity.
The tool set provides comprehensive lifecycle coverage for offers (create/read/update/delete/delist), trades (engage/cancel/list), escrow (balances/history), transfers, KYC, fiat deposits/withdrawals, and agent transactions. No obvious critical gaps or dead ends.
Maintenance
Related MCP Connectors
Complete financial infrastructure for AI agents — payments, lending, escrow & more.
USDC wallets, payment links and x402 payments on Solana for AI agents.
Crypto payments for AI agents: self-serve account, invoices, receiving, payouts, exchange.
Non-custodial stablecoin bill-pay rails on Celo & Base for AI agents, settled on-chain via MCP.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI agents to interact with cryptocurrency ecosystems through wallet management, trading operations (swaps, DCA, limit orders), staking, and multi-chain support starting with Solana.37GPL 3.0
- AlicenseNot gradedqualityFmaintenanceEnables AI agents to perform financial transactions such as direct payments, escrows, and bounty management using natural language with zero code integration. It provides a comprehensive suite of tools for fund streaming, subscriptions, and reputation tracking to facilitate secure agent-to-agent commerce.MIT
- AlicenseAqualityBmaintenanceEnables AI agents to manage USDC wallets on Solana, allowing them to send payments, create invoices, and access paid APIs within human-defined spending limits. It uses threshold signatures to provide agents with financial autonomy while ensuring secure oversight and transaction approval.3670 npm4Apache 2.0
- AlicenseAqualityCmaintenanceEnables AI agents to discover, inspect, and pay for paid HTTP and MCP services using USDC on Solana with a self-custodial wallet.4131 npm9Apache 2.0