Skip to main content
Glama
BananaCrystal MCP Server

BananaCrystal MCP Server

Official

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/mcp

Docs · Get a free sandbox key · API reference · Security policy

MCP Badge


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

  1. 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.

  2. Add the server to your MCP client.

  3. 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_key

Kiro

Add to Kiro

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

get_balances, get_exchange_rate, get_transaction_history, get_my_limits, estimate_swap_fees and 19 more

Free

Transfer

request_transfer_otp, transfer_tokens

0.3%

Swap

swap_currency across 140+ local-currency stablecoins

0.5%

Fiat

initiate_kyc, initiate_deposit, request_withdrawal

Partner rate shown before you confirm

Offers and trades

create_offer, update_offer, engage_offer, cancel_trade and 2 more

Free to list

Agent to agent

request_agent_transaction, execute_approved_transaction and 1 more

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

bc_test_ prefix

64 hex characters, no prefix

Balances

Test funds, reset on request

Real

KYC

Not required

Required before fiat tools

Rate limit

Returned by get_my_limits

Returned by get_my_limits

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

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 tools
cancel_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.

echoAInspect

Echoes the input message back to the caller

Inputs: message (required).

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.

pingAInspect

Health check tool that returns pong

Inputs: no named parameters.

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

    A3.6/5.0

    Scored across 40 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables 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
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      36
      70 npm
      4
      Apache 2.0