ፈጣን ጅምር
የAI ኤጀንትዎ ከ5 ደቂቃ በታች ውስጥ ክፍያ እንዲፈጽም ያድርጉ።
የMCP አገልጋዩን ይጫኑ
የBananaCrystal MCP አገልጋይን በnpm በኩል በዓለም አቀፍ ደረጃ ይጫኑ።
npm install -g @bananacrystal/mcp-serverየAPI ቁልፍዎን ያግኙ
ከመለያ ዳሽቦርድዎ የMCP API ቁልፍ ይፍጠሩ። የሳንድቦክስ ቁልፎች በbc_test_ ይጀምራሉ እና ነጻ ናቸው።
bc_test_...Claude Desktop ን ያዋቅሩ
BananaCrystal ን ወደ Claude Desktop ውቅር ፋይልዎ ያክሉ።
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here"
}
}
}
}ኤጀንትዎን ይጠይቁ
ኤጀንትዎ አሁን 40 የክፍያ መሳሪያዎች አሉት። እነዚህን ጥያቄዎች ይሞክሩ፦
MCP መሳሪያዎች
በ6 ምድቦች 40 ለምርት ዝግጁ የክፍያ መሳሪያዎች። ማንበብ ብቻ ስራዎች ሁልጊዜ ነጻ ናቸው።
pingget_server_infoechoget_my_profileget_balancesget_exchange_ratelist_supported_currencieslist_available_tokensget_transaction_historyget_my_limitsestimate_swap_feesget_agent_configcheck_approval_statusget_kyc_statusget_deposit_statusget_withdrawal_statusget_escrow_balancesget_escrow_historylist_offersget_offerget_my_offerslist_tradesget_tradeget_my_tradesrequest_transfer_otptransfer_tokensswap_currencyinitiate_kycinitiate_depositrequest_withdrawalcreate_offerupdate_offerdelist_offerdelete_offerengage_offercancel_traderequest_agent_transactionexecute_approved_transactionupdate_my_agent_settingsreset_sandbox_balanceRate API
በREST በኩል የላቁ የገንዘብ ተመን ስራዎች። በrate ወሰን የተወሰነ API ቁልፍ ያስፈልገዋል።
MCP መሳሪያ ከRate API ጋር፦ ልዩነቱ ምንድን ነው?
የMCP አገልጋዩ get_exchange_rate ን እንደ read_only መሳሪያ አስቀድሞ ያካትታል፦ ኤጀንትዎ ለአንድ ገንዘብ ከUSD ጋር ያለውን የመግዣ/መሸጫ ተመን ለማግኘት በቀጥታ ሊጠራው ይችላል። ይህ አብዛኞቹን የኤጀንት አጠቃቀሞች ይሸፍናል።
Rate API የበለጠ ይሄዳል፦ የገንዘብ ጥንድ ተሻጋሪ ልወጣዎች፣ የጅምላ ስራዎች፣ ታሪካዊ የጊዜ ተከታታይ መረጃ እና ስታቲስቲካዊ ማጠቃለያዎች። እነዚህ በrate ወሰን የተወሰነ API ቁልፍ የሚረጋገጡ ቀጥተኛ የHTTP መጨረሻ ነጥቦች ሆነው ይገኛሉ። የrate ቁልፍን ከመለያ ዳሽቦርድዎ ይፍጠሩ።
ማረጋገጫ
ሁሉም የRate API መጨረሻ ነጥቦች እንደ x-api-key ራስጌ የሚተላለፍ በrate ወሰን የተወሰነ API ቁልፍ ይፈልጋሉ። የሳንድቦክስ አቻዎቹ በ/mcp/sandbox/rate/* ይገኛሉ እና ሊደገሙ የሚችሉ ሙከራዎችን ለማድረግ ቋሚ የማስመሰያ ተመኖች ያላቸውን የሳንድቦክስ ቁልፍዎን (bc_test_...) ይጠቀማሉ።
/mcp/rate/currenciesሁሉንም የሚደገፉ ገንዘቦች ይዘርዝሩ
የምሳሌ ጥያቄ
curl "https://agentic.bananacrystal.com/mcp/rate/currencies" \
-H "x-api-key: bc_live_your_rate_key_here"የምሳሌ ምላሽ
{
"count": 11,
"currencies": ["EGP", "EUR", "GBP", "GHS", "KES", "NGN", "TZS", "UGX", "USD", "XOF", "ZAR"]
}/mcp/rate/currentበሁለት ገንዘቦች መካከል ያለውን የአሁኑ የምንዛሬ ተመን ያግኙ
መለኪያዎች
| ስም | ያስፈልጋል | መግለጫ |
|---|---|---|
from | ያስፈልጋል | የምንጭ ገንዘብ ኮድ (ለምሳሌ USD) |
to | ያስፈልጋል | የመድረሻ ገንዘብ ኮድ (ለምሳሌ NGN) |
የምሳሌ ጥያቄ
curl "https://agentic.bananacrystal.com/mcp/rate/current?from=USD&to=NGN" \
-H "x-api-key: bc_live_your_rate_key_here"የምሳሌ ምላሽ
{
"from": "USD",
"to": "NGN",
"rate": 1584.75,
"buyRate": 1590.0,
"sellRate": 1579.5,
"timestamp": "2026-04-30T10:22:00.000Z"
}/mcp/rate/convertመጠንን ከአንድ ገንዘብ ወደ ሌላ ይቀይሩ
መለኪያዎች
| ስም | ያስፈልጋል | መግለጫ |
|---|---|---|
from | ያስፈልጋል | የምንጭ ገንዘብ ኮድ |
to | ያስፈልጋል | የመድረሻ ገንዘብ ኮድ |
amount | ያስፈልጋል | የሚቀየር መጠን (ቁጥር) |
የምሳሌ ጥያቄ
curl "https://agentic.bananacrystal.com/mcp/rate/convert?from=USD&to=NGN&amount=100" \
-H "x-api-key: bc_live_your_rate_key_here"የምሳሌ ምላሽ
{
"from": "USD",
"to": "NGN",
"amount": 100,
"converted": 158475.0,
"rate": 1584.75,
"timestamp": "2026-04-30T10:22:00.000Z"
}/mcp/rate/batch-convertበአንድ ጥያቄ ውስጥ በርካታ የገንዘብ መጠኖችን ይቀይሩ (ከፍተኛ 100)
የምሳሌ ጥያቄ
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 }
]
}'የምሳሌ ምላሽ
[
{ "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/historyለአንድ የገንዘብ ጥንድ ታሪካዊ የምንዛሬ ተመኖችን ያምጡ
መለኪያዎች
| ስም | ያስፈልጋል | መግለጫ |
|---|---|---|
from | ያስፈልጋል | የምንጭ ገንዘብ ኮድ |
to | ያስፈልጋል | የመድረሻ ገንዘብ ኮድ |
startDate | ያስፈልጋል | የመጀመሪያ ቀን (ISO 8601፣ ለምሳሌ 2026-04-01) |
endDate | ያስፈልጋል | የመጨረሻ ቀን (ISO 8601፣ ለምሳሌ 2026-04-30) |
የምሳሌ ጥያቄ
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"የምሳሌ ምላሽ
[
{ "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 }
]/mcp/rate/statsበአንድ ጊዜ ወቅት የተመን ስታቲስቲክስ (ከፍተኛ፣ ዝቅተኛ፣ አማካይ፣ የቅርብ ጊዜ) ያግኙ
መለኪያዎች
| ስም | ያስፈልጋል | መግለጫ |
|---|---|---|
from | ያስፈልጋል | የምንጭ ገንዘብ ኮድ |
to | ያስፈልጋል | የመድረሻ ገንዘብ ኮድ |
days | አማራጭ | የጊዜ ወቅት በቀናት፣ ከ1 እስከ 365 (ነባሪ፦ 30) |
የምሳሌ ጥያቄ
curl "https://agentic.bananacrystal.com/mcp/rate/stats?from=USD&to=NGN&days=30" \
-H "x-api-key: bc_live_your_rate_key_here"የምሳሌ ምላሽ
{
"from": "USD",
"to": "NGN",
"period": "30d",
"high": 1598.0,
"low": 1560.0,
"avg": 1581.4,
"latest": 1584.75,
"count": 30
}የሳንድቦክስ Rate API
/mcp/rate/ ን በ/mcp/sandbox/rate/ ይተኩ እና ቋሚ የማስመሰያ ተመኖችን ለማግኘት የሳንድቦክስ ቁልፍዎን ይጠቀሙ። ታሪካዊ መረጃ ለተጨባጭ ሙከራ በ±2% ልዩነት ይመነጫል። ምንም እውነተኛ የምንዛሬ መረጃ አይጠቀምም።
የሳንድቦክስ አካባቢ
ውህደትዎን አስቀድመው በተሞሉ ቀሪ ሂሳቦች እና ያለ እውነተኛ ገንዘብ በደህና ይሞክሩ።
ሳንድቦክስ ምንድን ነው?
ሳንድቦክስ ምርትን በትክክል የሚመስል ሙሉ በሙሉ የተለየ የሙከራ አካባቢ ነው፣ ተመሳሳይ መሳሪያዎችን፣ ተመሳሳይ API እና ተመሳሳይ የምላሽ ቅርጸትን ጨምሮ። ምንም እውነተኛ ገንዘብ አይንቀሳቀስም። የሳንድቦክስ API ቁልፎች በbc_test_ ይጀምራሉ እና ከHedera testnet ጋር ይገናኛሉ።
አስቀድመው የተሞሉ ቀሪ ሂሳቦች
እያንዳንዱ የሳንድቦክስ መለያ በእነዚህ ቀሪ ሂሳቦች ይጀምራል። በማንኛውም ጊዜ ለመመለስ 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 |
ሳንድቦክስ ከቀጥታ ጋር
| ባህሪ | ሳንድቦክስ | ቀጥታ |
|---|---|---|
| እውነተኛ ገንዘብ ይንቀሳቀሳል | አይ፦ የተመሰለ ብቻ | አዎ |
| OTP ማረጋገጫ | በAPI ምላሽ ውስጥ ይመለሳል | ወደ ኢሜይልዎ ይላካል |
| ለፊያት KYC ያስፈልጋል | አይ | አዎ |
| የወጪ ገደቦች ይተገበራሉ | አዎ (ሊዋቀር ይችላል) | አዎ |
| የAPI ቁልፍ ቅድመ ቅጥያ | bc_test_... | bc_live_... |
| የHedera ማጠናቀቅ | Testnet | Mainnet |
| አስቀድመው የተሞሉ ቀሪ ሂሳቦች | አዎ (በማንኛውም ጊዜ ዳግም ማስጀመር) | አይ |
| የጥያቄ ገደቦች | ቀለል ያሉ | እንደ ዕቅዱ |
በሳንድቦክስ ውስጥ OTP
በሳንድቦክስ ሁነታ የOTP ኮዱ በኢሜይል ከመላክ ይልቅ በrequest_transfer_otp API ምላሽ ውስጥ በቀጥታ ይመለሳል። ይህ የኢሜይል መዳረሻ ሳያስፈልግ አውቶማቲክ ሙከራን ቀላል ያደርገዋል።
የሳንድቦክስ ውቅር
{
"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 ን ከሚመርጡት የAI መሳሪያ ወይም ፍሬምወርክ ጋር ያገናኙ።
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "your_api_key_here"
}
}
}
}የአካባቢ ተለዋዋጮች
BANANACRYSTAL_API_KEYያስፈልጋልየእርስዎ MCP API ቁልፍ። የሳንድቦክስ ቁልፎች በbc_test_ ይጀምራሉ፣ የቀጥታ ቁልፎች በbc_live_።
ነባሪ፦ N/A
BANANACRYSTAL_API_URLአማራጭየMCP መጨረሻ ነጥብ URL ን ይተኩ። ለሙከራ የሳንድቦክስ URL ን ይጠቀሙ።
ነባሪ፦ https://agentic.bananacrystal.com/mcp
DEBUGአማራጭዝርዝር የጥያቄ/ምላሽ ምዝግብ ለማንቃት ወደ true ያዋቅሩ።
ነባሪ፦ false
| ተለዋዋጭ | ያስፈልጋል | ነባሪ | መግለጫ |
|---|---|---|---|
BANANACRYSTAL_API_KEY | ያስፈልጋል | N/A | የእርስዎ MCP API ቁልፍ። የሳንድቦክስ ቁልፎች በbc_test_ ይጀምራሉ፣ የቀጥታ ቁልፎች በbc_live_። |
BANANACRYSTAL_API_URL | አማራጭ | https://agentic.bananacrystal.com/mcp | የMCP መጨረሻ ነጥብ URL ን ይተኩ። ለሙከራ የሳንድቦክስ URL ን ይጠቀሙ። |
DEBUG | አማራጭ | false | ዝርዝር የጥያቄ/ምላሽ ምዝግብ ለማንቃት ወደ true ያዋቅሩ። |
የፍሬምወርክ ውህደቶች
ለታዋቂዎቹ የ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 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 የሚደግፍ ፍሬምወርክ ይሰራል። ፍሬምወርክዎ በHTTP ላይ የተመሰረቱ MCP አገልጋዮችን የሚደግፍ ከሆነ፣ ወደ https://agentic.bananacrystal.com/mcp ያመልክቱት እና የAPI ቁልፍዎን እንደ Bearer ቶከን ይጠቀሙ።
የደህንነት አርክቴክቸር
ኤጀንትዎ በግልጽ የፈቀዱትን ብቻ እንዲያደርግ በርካታ የጥበቃ ንብርብሮች።
የAPI ቁልፍ ወሰኖች
እያንዳንዱ የAPI ቁልፍ ግልጽ የፈቃድ ወሰኖች አሉት። ኤጀንት ሊሰራ የሚችለው በሰጡት ወሰኖች ውስጥ ያሉ ስራዎችን ብቻ ነው።
የወጪ ገደቦች
በእያንዳንዱ የAPI ቁልፍ ጥብቅ የግብይት ከፍተኛ ገደቦችን እና የሚንከባለል የ24 ሰዓት ዕለታዊ ጣሪያዎችን ያዘጋጁ። እነዚህ በመሠረተ ልማት ደረጃ ይተገበራሉ።
የOTP ማረጋገጫ
እያንዳንዱ የቶከን ዝውውር ወደ ተመዘገበው ኢሜይልዎ የሚላክ ባለ6 አሃዝ OTP ይፈልጋል። ያንን ኮድ እርስዎ ሳያቀርቡ ኤጀንቱ ዝውውርን ማጠናቀቅ አይችልም።
የጥያቄ ገደብ
በቁልፍ እና በደቂቃ የሚወሰኑ የጥያቄ ጣሪያዎች ቁጥጥር ያጡ ኤጀንቶች APIውን እንዳያጨናንቁ ይከላከላሉ። ገደቦች በዕቅድ ደረጃዎ ይጨምራሉ።
የማይለወጥ የኦዲት መዝገብ
እያንዳንዱ የመሳሪያ ጥሪ በHedera የስምምነት ንብርብር ላይ ይጻፋል። የጊዜ ማህተም አላቸው፣ ሊቀየሩ አይችሉም፣ እና በብሎክቼይን ላይ በይፋ ሊረጋገጡ ይችላሉ። ሙሉ የኦዲት ታሪክ በget_transaction_history በኩል ይገኛል።
የኤጀንት ፈቃድ ሂደት
ከኤጀንት ወደ ኤጀንት ግብይቶች ከመፈጸማቸው በፊት የሰው የኢሜይል ፈቃድ ሊጠይቁ ይችላሉ። require_human_approval ን ለማዋቀር update_my_agent_settings ን ይጠቀሙ።
የAPI ቁልፍ ወሰኖች
ምንም ገንዘብ ሳያንቀሳቅሱ ቀሪ ሂሳቦችን፣ ተመኖችን፣ ታሪክን እና ገደቦችን ይፈትሹ
ቶከኖችን ወደ ሌሎች መለያዎች ይላኩ (OTP ያስፈልጋል)
በገንዘብ ስቴብልኮይኖች መካከል ይቀይሩ
የፊያት ተቀማጭ እና ማውጫ (KYC ያስፈልጋል)
የትንበያ ገበያ ቅናሾችን እና ንግዶችን ይፍጠሩ እና ያስተዳድሩ
የገንዘብ የምንዛሬ ተመኖችን፣ ታሪካዊ መረጃን፣ ልወጣዎችን እና የተመን ስታቲስቲክስን ይድረሱ
| ወሰን | የሚፈቅደው |
|---|---|
| read_only | ምንም ገንዘብ ሳያንቀሳቅሱ ቀሪ ሂሳቦችን፣ ተመኖችን፣ ታሪክን እና ገደቦችን ይፈትሹ |
| transfer | ቶከኖችን ወደ ሌሎች መለያዎች ይላኩ (OTP ያስፈልጋል) |
| swap | በገንዘብ ስቴብልኮይኖች መካከል ይቀይሩ |
| fiat | የፊያት ተቀማጭ እና ማውጫ (KYC ያስፈልጋል) |
| offers | የትንበያ ገበያ ቅናሾችን እና ንግዶችን ይፍጠሩ እና ያስተዳድሩ |
| rate | የገንዘብ የምንዛሬ ተመኖችን፣ ታሪካዊ መረጃን፣ ልወጣዎችን እና የተመን ስታቲስቲክስን ይድረሱ |
ዋጋ
ማንበብ ብቻ ስራዎች ሁልጊዜ ነጻ ናቸው። ዋጋ የሚያንቀሳቅሱ ግብይቶችን ብቻ ይክፈሉ።
የስራ ክፍያዎች
ማንበብ ብቻ ስራዎች
get_balances, get_exchange_rate, list_trades, …
የቶከን ዝውውሮች
transfer_tokens
የገንዘብ መቀየሮች
swap_currency
የፊያት ተቀማጮች
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 | በማጠናቀቂያ ላይ የመድረክ ክፍያ |
ዕቅዶች
ነጻ
ሁሉም ማንበብ ብቻ መሳሪያዎች ሁልጊዜ ነጻ ናቸው። ተመኖችን ወይም ቀሪ ሂሳቦችን ለመፈተሽ መለያ አያስፈልግም።
- ሁሉም ማንበብ ብቻ መሳሪያዎች ለዘላለም ነጻ
- የሳንድቦክስ አካባቢ ተካትቷል
- get_balances፣ get_exchange_rate እና ሌሎች 22
- የማህበረሰብ ድጋፍ
- የHedera testnet ማጠናቀቅ
እንደተጠቀሙ ይክፈሉ
እያደጉ ሲሄዱ ያስፋፉ። የሚጠቀሙትን ብቻ ይክፈሉ።
- ያልተገደበ የAPI ጥሪዎች
- በዝውውሮች 0.3%
- በመቀየሮች 0.5%
- የፊያት መንገዶች (እንደ ዘዴው ይለያያል)
- ኢሜይል እና ቅድሚያ የሚሰጠው ድጋፍ
- የHedera mainnet ማጠናቀቅ
- ሙሉ የኦዲት መዝገብ
ኢንተርፕራይዝ
የመጠን ቅናሾች፣ SLAዎች እና ራሱን የቻለ መሠረተ ልማት።
- ብጁ የክፍያ ደረጃዎች
- ራሱን የቻለ MCP መጨረሻ ነጥብ
- የSLA ዋስትናዎች
- ብጁ የወጪ ገደቦች
- ራሱን የቻለ ድጋፍ
- በራስዎ አገልጋይ የመጫን አማራጭ
የተለመዱ ጥያቄዎች
ስለBananaCrystal እና ስለMCP አገልጋዩ የተለመዱ ጥያቄዎች።
ለኤጀንትዎ ዋሌት ለመስጠት ዝግጁ ነዎት?
የAPI ቁልፍዎን ይፍጠሩ እና ኤጀንትዎን ከ5 ደቂቃ በታች ውስጥ ከ40 የክፍያ መሳሪያዎች ጋር ያገናኙ። ማንበብ ብቻ መሳሪያዎች ሁልጊዜ ነጻ ናቸው።
የAPI ቁልፍ ያግኙ