MCP ServerZana 40v1.0

    Nyaraka za BananaCrystal MCP

    Mpe AI agent wako zana 40 za malipo zilizo tayari kwa matumizi. Angalia salio, hamisha stablecoins, badilisha sarafu na shughulikia fiat: yote yakikamilika kwenye Hedera kwa chini ya sekunde 5.

    Pata API KeyGitHubnpm
    40
    Zana za MCP
    150+
    Sarafu
    < 5s
    Ukamilishaji
    0.3%
    Ada ya uhamisho

    Kuanza Haraka

    Mfanye AI agent wako aanze kufanya malipo kwa chini ya dakika 5.

    01

    Sakinisha MCP server

    Sakinisha BananaCrystal MCP server kwa ujumla kupitia npm.

    npm install -g @bananacrystal/mcp-server
    02

    Pata API key yako

    Unda MCP API key kutoka dashibodi ya akaunti yako. Sandbox keys zinaanza na bc_test_ na ni bure.

    Pata API Key
    Sandbox keys: bc_test_...
    03

    Sanidi Claude Desktop

    Ongeza BananaCrystal kwenye faili la usanidi la Claude Desktop.

    claude_desktop_config.json
    {
  "mcpServers": {
    "bananacrystal": {
      "command": "bananacrystal-mcp",
      "env": {
        "BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here"
      }
    }
  }
}
    04

    Muulize agent wako

    Agent wako sasa ana zana 40 za malipo. Jaribu maombi haya:

    ›"Salio langu la sasa la USDb ni kiasi gani?"
    ›"Tuma 50 USDb kwenda 0.0.654321"
    ›"Badilisha 100 USDb kuwa NGNb kwa kiwango cha sasa"
    ›"Nionyeshe miamala yangu 10 ya mwisho"
    ›"Kiwango cha sasa cha ubadilishaji wa USD kwenda NGN ni kipi?"

    Zana za MCP

    Zana 40 za malipo zilizo tayari kwa matumizi katika makundi 6. Shughuli za kusoma tu ni bure kila wakati.

    Kusoma tuzana 24
    ping
    read_onlybure
    Ukaguzi wa afya: inarudisha pong
    get_server_info
    read_onlybure
    Inarudisha taarifa za msingi za server
    echo
    read_onlybure
    Inarudisha ujumbe ulioingizwa kwa aliyeita
    get_my_profile
    read_onlybure
    Pata wasifu kamili wa mtumiaji aliyethibitishwa
    get_balances
    read_onlybure
    Pata salio la akaunti ya Hedera kwa tokeni zote za jukwaa au tokeni maalum
    get_exchange_rate
    read_onlybure
    Pata viwango vya sasa vya kununua/kuuza kwa sarafu
    list_supported_currencies
    read_onlybure
    Orodhesha sarafu zote zinazokubaliwa pamoja na ada zao zinazobadilika
    list_available_tokens
    read_onlybure
    Orodhesha tokeni zote za Hedera zinazopatikana kwenye jukwaa
    get_transaction_history
    read_onlybure
    Pata historia ya miamala iliyopangwa kwa makundi pamoja na vichujio
    get_my_limits
    read_onlybure
    Pata vikomo vilivyosanidiwa na matumizi ya sasa kwa API key iliyothibitishwa
    estimate_swap_fees
    read_onlybure
    Kadiria ada za swap ya sarafu kabla ya kutekeleza
    get_agent_config
    read_onlybure
    Tafuta usanidi wa agent wa mtumiaji mwingine
    check_approval_status
    read_onlybure
    Angalia hali ya ombi la idhini ya muamala wa agent linalosubiri
    get_kyc_status
    read_onlybure
    Pata hali ya uthibitisho wa KYC kwa mtumiaji kupitia Sumsub
    get_deposit_status
    read_onlybure
    Pata hali ya uwekaji wa fiat kwa transfer ID
    get_withdrawal_status
    read_onlybure
    Pata maombi ya utoaji kwa mtumiaji kupitia Brale
    get_escrow_balances
    read_onlybure
    Pata mchanganuo wa salio la escrow: jumla, linalopatikana na lililofungwa
    get_escrow_history
    read_onlybure
    Pata historia kamili ya miamala ya escrow ikiwemo kufungwa, kuachiliwa, ushindi na hasara
    list_offers
    read_onlybure
    Vinjari soko la utabiri kwa ofa zinazoendelea pamoja na takwimu za biashara
    get_offer
    read_onlybure
    Pata maelezo kamili ya ofa moja ikiwemo takwimu za biashara
    get_my_offers
    read_onlybure
    Pata ofa zote zilizoundwa na mtumiaji maalum
    list_trades
    read_onlybure
    Orodhesha biashara zote kwenye jukwaa pamoja na vichujio
    get_trade
    read_onlybure
    Pata maelezo kamili ya biashara moja ikiwemo takwimu za ofa mama
    get_my_trades
    read_onlybure
    Pata biashara zote za mtumiaji, zilizoundwa na zilizopokelewa
    Uhamishozana 2
    request_transfer_otp
    transfer0.3%
    Hatua 1: Omba nambari ya uthibitisho ya OTP inayotumwa kwa barua pepe ya mtumaji
    transfer_tokens
    transfer0.3%
    Hatua 2: Tekeleza uhamisho wa tokeni kwa uthibitisho wa OTP
    Swapzana 1
    swap_currency
    swap0.5%
    Badilisha kati ya tokeni mbili za Hedera huku kiwango na ada zikikokotolewa zenyewe
    Fiatzana 3
    initiate_kyc
    fiat
    Anzisha uthibitisho wa KYC: inarudisha access token ya Sumsub kwa SDK
    initiate_deposit
    fiat
    Anzisha uwekaji wa fiat kupitia Brale (KYC inahitajika)
    request_withdrawal
    fiat
    Omba utoaji wa fiat kupitia Brale (KYC inahitajika)
    Ofa na Biasharazana 6
    create_offer
    offers
    Unda ofa ya soko la utabiri inayofunga jumla ya kiasi kwenye escrow
    update_offer
    offers
    Hariri ofa iliyopo (pale tu hakuna biashara)
    delist_offer
    offers
    Ondoa ofa yako sokoni na uachilie escrow iliyofungwa
    delete_offer
    offers
    Futa ofa yako kabisa (inazuiwa ikiwa kuna biashara zinazoendelea)
    engage_offer
    offers
    Shiriki ofa iliyo wazi kwa kufunga escrow inayolingana
    cancel_trade
    offers
    Ghairi biashara inayoendelea na uachilie escrow yako iliyofungwa
    Agent kwa Agentzana 3
    request_agent_transaction
    transfer
    Omba muamala kwa niaba ya agent wa mtumiaji mwingine (inahitaji idhini kwa barua pepe)
    execute_approved_transaction
    transfer
    Tekeleza muamala wa agent ulioidhinishwa awali kwa kutumia execution token
    update_my_agent_settings
    read_onlybure
    Dhibiti kama miamala ya agent kwa agent inahitaji idhini kwa barua pepe na OTP
    Sandbox pekeezana 1
    reset_sandbox_balance
    read_onlybure
    Rudisha salio la sandbox kwenye chaguo-msingi zilizowekwa tayari (sandbox pekee)

    Rate API

    Shughuli za hali ya juu za viwango vya sarafu kupitia REST. Inahitaji API key yenye scope ya rate.

    Zana ya MCP dhidi ya Rate API: kuna tofauti gani?

    MCP server tayari inajumuisha get_exchange_rate kama zana ya read_only: agent wako anaweza kuiita moja kwa moja kupata kiwango cha kununua/kuuza kwa sarafu moja dhidi ya USD. Hiyo inatosha kwa matumizi mengi ya agents.

    Rate API inaenda mbali zaidi: ubadilishaji kati ya jozi, shughuli za kundi kwa wingi, data ya kihistoria ya mfululizo wa muda na muhtasari wa takwimu. Hizi zinapatikana kama HTTP endpoints za moja kwa moja zinazothibitishwa kwa API key yenye scope ya rate. Unda rate key kutoka dashibodi ya akaunti yako.

    Uthibitishaji

    Endpoints zote za Rate API zinahitaji API key yenye scope ya rate inayopitishwa kama header ya x-api-key. Zinazolingana za sandbox zinapatikana kwenye /mcp/sandbox/rate/* na zinatumia sandbox key yako (bc_test_...) na viwango vya kuigiza visivyobadilika kwa majaribio yanayorudiwa.

    Base URL
    https://agentic.bananacrystal.com/mcp/rate
    GET/mcp/rate/currencies

    Orodhesha sarafu zote zinazokubaliwa

    Mfano wa ombi

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

    Mfano wa jibu

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

    Pata kiwango cha sasa cha ubadilishaji kati ya sarafu mbili

    Vigezo

    JinaInahitajikaMaelezo
    frominahitajikaMsimbo wa sarafu ya chanzo (k.m. USD)
    toinahitajikaMsimbo wa sarafu lengwa (k.m. NGN)

    Mfano wa ombi

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

    Mfano wa jibu

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

    Badilisha kiasi kutoka sarafu moja kwenda nyingine

    Vigezo

    JinaInahitajikaMaelezo
    frominahitajikaMsimbo wa sarafu ya chanzo
    toinahitajikaMsimbo wa sarafu lengwa
    amountinahitajikaKiasi cha kubadilisha (nambari)

    Mfano wa ombi

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

    Mfano wa jibu

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

    Badilisha viasi vya sarafu kadhaa katika ombi moja (hadi 100)

    Mfano wa ombi

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

    Mfano wa jibu

    [
  { "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

    Pata viwango vya kihistoria vya ubadilishaji kwa jozi ya sarafu

    Vigezo

    JinaInahitajikaMaelezo
    frominahitajikaMsimbo wa sarafu ya chanzo
    toinahitajikaMsimbo wa sarafu lengwa
    startDateinahitajikaTarehe ya kuanza (ISO 8601, k.m. 2026-04-01)
    endDateinahitajikaTarehe ya mwisho (ISO 8601, k.m. 2026-04-30)

    Mfano wa ombi

    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"

    Mfano wa jibu

    [
  { "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

    Pata takwimu za viwango (juu, chini, wastani, cha karibuni) kwa kipindi

    Vigezo

    JinaInahitajikaMaelezo
    frominahitajikaMsimbo wa sarafu ya chanzo
    toinahitajikaMsimbo wa sarafu lengwa
    dayshiariKipindi kwa siku, 1 hadi 365 (chaguo-msingi: 30)

    Mfano wa ombi

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

    Mfano wa jibu

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

    Sandbox Rate API

    Badilisha /mcp/rate/ kuwa /mcp/sandbox/rate/ na utumie sandbox key yako kupata viwango vya kuigiza visivyobadilika. Data ya kihistoria inatengenezwa kwa tofauti ya ±2% kwa majaribio yanayofanana na hali halisi. Hakuna data halisi ya ubadilishaji inayotumika.

    Mazingira ya Sandbox

    Jaribu muunganisho wako kwa usalama ukiwa na salio lililowekwa tayari na bila pesa halisi.

    Sandbox ni nini?

    Sandbox ni mazingira ya majaribio yaliyotengwa kabisa yanayofanana na production, ikiwemo zana zile zile, API ile ile na muundo ule ule wa majibu. Hakuna pesa halisi zinazohamishwa. Sandbox API keys zinaanza na bc_test_ na zinaunganika na Hedera testnet.

    Salio lililowekwa tayari

    Kila akaunti ya sandbox inaanza na salio hili. Tumia reset_sandbox_balance kulirejesha wakati wowote.

    TokeniKiasiSarafu
    USDb10,000USD
    NGNb5,000,000NGN
    GHSb50,000GHS
    KESb1,000,000KES
    ZARb150,000ZAR

    Sandbox dhidi ya Live

    KipengeleSandboxLive
    Pesa halisi zinahamishwaHapana: ni uigaji tuNdiyo
    Uthibitisho wa OTPHurudishwa kwenye jibu la APIHutumwa kwa barua pepe yako
    KYC inahitajika kwa fiatHapanaNdiyo
    Vikomo vya matumizi vinatekelezwaNdiyo (vinaweza kusanidiwa)Ndiyo
    Kiambishi cha API keybc_test_...bc_live_...
    Ukamilishaji kwenye HederaTestnetMainnet
    Salio lililowekwa tayariNdiyo (weka upya wakati wowote)Hapana
    Vikomo vya maombiVimelegezwaKulingana na mpango

    OTP kwenye sandbox

    Katika hali ya sandbox, nambari ya OTP inarudishwa moja kwa moja kwenye jibu la API la request_transfer_otp badala ya kutumwa kwa barua pepe. Hii inarahisisha majaribio ya kiotomatiki bila kuhitaji barua pepe.

    Usanidi wa sandbox

    claude_desktop_config.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"
      }
    }
  }
}

    Usanidi

    Unganisha BananaCrystal na zana au framework ya AI unayopendelea.

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

    Vigezo vya mazingira

    BANANACRYSTAL_API_KEYinahitajika

    MCP API key yako. Sandbox keys zinaanza na bc_test_, live keys na bc_live_.

    Chaguo-msingi: N/A

    BANANACRYSTAL_API_URLhiari

    Badilisha URL ya MCP endpoint. Tumia URL ya sandbox kwa majaribio.

    Chaguo-msingi: https://agentic.bananacrystal.com/mcp

    DEBUGhiari

    Weka true ili kuwasha kumbukumbu za kina za maombi/majibu.

    Chaguo-msingi: false

    Miunganisho ya Frameworks

    Mifano iliyo tayari kuendeshwa kwa frameworks maarufu zaidi za AI agents.

    langchain_agent.py
    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())

    Framework yoyote inayoendana na MCP inafanya kazi. Ikiwa framework yako inakubali MCP servers zinazotumia HTTP, ielekeze kwenye https://agentic.bananacrystal.com/mcp ukitumia API key yako kama Bearer token.

    Muundo wa Usalama

    Safu nyingi za ulinzi ili agent wako afanye tu kile ulichoidhinisha waziwazi.

    Scopes za API Key

    Kila API key ina ruhusa wazi. Agent anaweza kufanya shughuli ndani ya ruhusa unazotoa tu.

    Vikomo vya Matumizi

    Weka viwango vya juu madhubuti kwa kila muamala na vikomo vya kila siku vya saa 24 zinazozunguka kwa kila API key. Vinatekelezwa katika ngazi ya miundombinu.

    Uthibitisho wa OTP

    Kila uhamisho wa tokeni unahitaji OTP ya tarakimu 6 inayotumwa kwa barua pepe yako iliyosajiliwa. Agent hawezi kukamilisha uhamisho bila wewe kutoa nambari hiyo.

    Vikomo vya Maombi

    Vikomo kwa kila key na kwa kila dakika vinazuia agents wasiodhibitika kushambulia API. Vikomo vinaongezeka kulingana na kiwango cha mpango wako.

    Rekodi ya Ukaguzi Isiyobadilika

    Kila wito wa zana huandikwa kwenye safu ya makubaliano ya Hedera. Una muhuri wa muda, hauwezi kuchezewa na unathibitishwa hadharani on-chain. Historia kamili ya ukaguzi inapatikana kupitia get_transaction_history.

    Mtiririko wa Idhini ya Agent

    Miamala ya agent kwa agent inaweza kuhitaji idhini ya binadamu kwa barua pepe kabla ya kutekelezwa. Tumia update_my_agent_settings kusanidi require_human_approval.

    Scopes za API Key

    read_only

    Kuangalia salio, viwango, historia na vikomo bila kuhamisha fedha zozote

    transfer

    Kutuma tokeni kwenda akaunti nyingine (inahitaji OTP)

    swap

    Kubadilisha kati ya stablecoins za sarafu

    fiat

    Kuweka na kutoa fiat (inahitaji KYC)

    offers

    Kuunda na kusimamia ofa na biashara za soko la utabiri

    rate

    Kufikia viwango vya ubadilishaji wa sarafu, data ya kihistoria, ubadilishaji na takwimu za viwango

    Bei

    Shughuli za kusoma tu ni bure kila wakati. Lipa tu kwa miamala inayohamisha thamani.

    Ada za shughuli

    Shughuli za kusoma tu

    get_balances, get_exchange_rate, list_trades, …

    Bure

    Uhamisho wa tokeni

    transfer_tokens

    0.3%

    Kubadilisha sarafu

    swap_currency

    0.5%

    Kuweka fiat

    initiate_deposit

    Inategemea njia ya malipo

    Kutoa fiat

    request_withdrawal

    Inategemea njia ya malipo

    Soko la utabiri

    create_offer, engage_offer

    Ada ya jukwaa wakati wa ukamilishaji

    Mipango

    Bure

    $0shughuli za kusoma tu

    Zana zote za kusoma tu ni bure kila wakati. Hakuna akaunti inayohitajika kuangalia viwango au salio.

    • Zana zote za kusoma tu ni bure milele
    • Mazingira ya sandbox yamejumuishwa
    • get_balances, get_exchange_rate na nyingine 22
    • Msaada wa jumuiya
    • Ukamilishaji kwenye Hedera testnet
    Pata API Key
    Maarufu zaidi

    Lipa kwa matumizi

    Kulingana na matumizihakuna ada ya kila mwezi

    Kua kadri unavyokua. Lipa tu kwa unachotumia.

    • Miito ya API bila kikomo
    • 0.3% kwa uhamisho
    • 0.5% kwa swaps
    • Njia za fiat (inategemea njia)
    • Barua pepe + msaada wa kipaumbele
    • Ukamilishaji kwenye Hedera mainnet
    • Rekodi kamili ya ukaguzi
    Pata API key

    Enterprise

    Maalumwasiliana nasi

    Punguzo kwa wingi, SLAs na miundombinu maalum.

    • Viwango maalum vya ada
    • MCP endpoint maalum
    • Hakikisho za SLA
    • Vikomo maalum vya matumizi
    • Msaada maalum
    • Chaguo la on-premise
    Wasiliana na mauzo

    Maswali

    Maswali ya kawaida kuhusu BananaCrystal na MCP server.

    Uko tayari kumpa agent wako wallet?

    Unda API key yako na uunganishe agent wako na zana 40 za malipo kwa chini ya dakika 5. Zana za kusoma tu ni bure kila wakati.

    Pata API Key