দ্রুত শুরু
5 মিনিটের কম সময়ে আপনার AI এজেন্টকে দিয়ে পেমেন্ট শুরু করুন।
MCP সার্ভার ইনস্টল করুন
npm দিয়ে BananaCrystal MCP সার্ভার গ্লোবালি ইনস্টল করুন।
npm install -g @bananacrystal/mcp-serverআপনার API key নিন
আপনার অ্যাকাউন্ট ড্যাশবোর্ড থেকে একটি MCP API key তৈরি করুন। Sandbox key শুরু হয় bc_test_ দিয়ে এবং এগুলো ফ্রি।
bc_test_...Claude Desktop কনফিগার করুন
আপনার Claude Desktop কনফিগ ফাইলে BananaCrystal যোগ করুন।
{
"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 key প্রয়োজন।
MCP টুল বনাম Rate API: পার্থক্য কী?
MCP সার্ভারে ইতিমধ্যে get_exchange_rate একটি read_only টুল হিসেবে আছে: আপনার এজেন্ট সরাসরি এটি কল করে USD-এর বিপরীতে একটি মুদ্রার কেনা/বেচার রেট পেতে পারে। এজেন্টের বেশিরভাগ ব্যবহারের জন্য এটুকুই যথেষ্ট।
Rate API আরও বেশি দেয়: ক্রস-পেয়ার রূপান্তর, বাল্ক ব্যাচ অপারেশন, ঐতিহাসিক টাইম-সিরিজ ডেটা এবং পরিসংখ্যানগত সারাংশ। এগুলো সরাসরি HTTP এন্ডপয়েন্ট হিসেবে পাওয়া যায়, rate-স্কোপের API key দিয়ে অথেনটিকেট করতে হয়। আপনার অ্যাকাউন্ট ড্যাশবোর্ড থেকে একটি rate key তৈরি করুন।
অথেনটিকেশন
সব Rate API এন্ডপয়েন্টে x-api-key হেডারে একটি rate-স্কোপের API key দিতে হয়। Sandbox সংস্করণ /mcp/sandbox/rate/*-এ পাওয়া যায় এবং পুনরুৎপাদনযোগ্য পরীক্ষার জন্য নির্দিষ্ট মক রেটসহ আপনার sandbox key (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
}Sandbox Rate API
/mcp/rate/-এর বদলে /mcp/sandbox/rate/ দিন এবং নির্দিষ্ট মক রেট পেতে আপনার sandbox key ব্যবহার করুন। বাস্তবসম্মত পরীক্ষার জন্য ঐতিহাসিক ডেটা ±2% তারতম্যসহ তৈরি করা হয়। কোনো আসল বিনিময় ডেটা ব্যবহার হয় না।
Sandbox পরিবেশ
আগে থেকে দেওয়া ব্যালেন্স দিয়ে, আসল টাকা ছাড়াই নিরাপদে আপনার ইন্টিগ্রেশন পরীক্ষা করুন।
Sandbox কী?
Sandbox হলো সম্পূর্ণ আলাদা একটি টেস্ট পরিবেশ, যা হুবহু প্রোডাকশনের মতো: একই টুল, একই API এবং একই রেসপন্স ফরম্যাট। কোনো আসল টাকা লেনদেন হয় না। Sandbox API key শুরু হয় bc_test_ দিয়ে এবং Hedera testnet-এ যুক্ত হয়।
আগে থেকে দেওয়া ব্যালেন্স
প্রতিটি sandbox অ্যাকাউন্ট এই ব্যালেন্স দিয়ে শুরু হয়। যেকোনো সময় ফিরিয়ে আনতে 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 |
Sandbox বনাম লাইভ
| বৈশিষ্ট্য | Sandbox | লাইভ |
|---|---|---|
| আসল টাকা লেনদেন হয় | না: শুধু সিমুলেটেড | হ্যাঁ |
| OTP ভেরিফিকেশন | API রেসপন্সে ফেরত আসে | আপনার ইমেইলে পাঠানো হয় |
| ফিয়াটের জন্য KYC লাগে | না | হ্যাঁ |
| খরচের সীমা প্রয়োগ হয় | হ্যাঁ (কনফিগারযোগ্য) | হ্যাঁ |
| API key প্রিফিক্স | bc_test_... | bc_live_... |
| Hedera সেটেলমেন্ট | Testnet | Mainnet |
| আগে থেকে দেওয়া ব্যালেন্স | হ্যাঁ (যেকোনো সময় রিসেট করা যায়) | না |
| রেট লিমিট | শিথিল | প্ল্যান অনুযায়ী |
Sandbox-এ OTP
Sandbox মোডে OTP কোড ইমেইলে না পাঠিয়ে সরাসরি request_transfer_otp API রেসপন্সে ফেরত দেওয়া হয়। এতে ইমেইল অ্যাক্সেস ছাড়াই স্বয়ংক্রিয় পরীক্ষা সহজ হয়।
Sandbox কনফিগারেশন
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here",
"BANANACRYSTAL_API_URL": "https://agentic.bananacrystal.com/mcp/sandbox"
}
}
}
}কনফিগারেশন
আপনার পছন্দের AI টুল বা ফ্রেমওয়ার্কের সাথে BananaCrystal যুক্ত করুন।
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "your_api_key_here"
}
}
}
}এনভায়রনমেন্ট ভেরিয়েবল
BANANACRYSTAL_API_KEYআবশ্যকআপনার MCP API key। Sandbox key শুরু হয় bc_test_ দিয়ে, লাইভ key bc_live_ দিয়ে।
ডিফল্ট: N/A
BANANACRYSTAL_API_URLঐচ্ছিকMCP এন্ডপয়েন্ট URL পরিবর্তন করুন। পরীক্ষার জন্য sandbox URL ব্যবহার করুন।
ডিফল্ট: https://agentic.bananacrystal.com/mcp
DEBUGঐচ্ছিকবিস্তারিত রিকোয়েস্ট/রেসপন্স লগিং চালু করতে true দিন।
ডিফল্ট: false
| ভেরিয়েবল | আবশ্যক | ডিফল্ট | বিবরণ |
|---|---|---|---|
BANANACRYSTAL_API_KEY | আবশ্যক | N/A | আপনার MCP API key। Sandbox key শুরু হয় bc_test_ দিয়ে, লাইভ key bc_live_ দিয়ে। |
BANANACRYSTAL_API_URL | ঐচ্ছিক | https://agentic.bananacrystal.com/mcp | MCP এন্ডপয়েন্ট URL পরিবর্তন করুন। পরীক্ষার জন্য sandbox 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 সার্ভার সমর্থন করলে, Bearer টোকেন হিসেবে আপনার API key দিয়ে এটিকে https://agentic.bananacrystal.com/mcp-এ যুক্ত করুন।
নিরাপত্তা কাঠামো
সুরক্ষার একাধিক স্তর, যাতে আপনার এজেন্ট শুধু আপনার স্পষ্টভাবে অনুমোদিত কাজই করতে পারে।
API key স্কোপ
প্রতিটি API key-এর নির্দিষ্ট অনুমতির পরিধি আছে। এজেন্ট শুধু আপনার দেওয়া পরিধির মধ্যেই কাজ করতে পারে।
খরচের সীমা
প্রতিটি API key-এর জন্য প্রতি লেনদেনের কঠোর সর্বোচ্চ এবং চলমান 24 ঘণ্টার দৈনিক সীমা ঠিক করুন। এগুলো অবকাঠামো স্তরে প্রয়োগ করা হয়।
OTP ভেরিফিকেশন
প্রতিটি টোকেন ট্রান্সফারে আপনার নিবন্ধিত ইমেইলে পাঠানো একটি 6 সংখ্যার OTP লাগে। আপনি সেই কোড না দিলে এজেন্ট ট্রান্সফার সম্পন্ন করতে পারে না।
রেট লিমিটিং
প্রতি key, প্রতি মিনিটের সীমা নিয়ন্ত্রণহীন এজেন্টকে API-তে অতিরিক্ত চাপ দিতে বাধা দেয়। সীমা আপনার প্ল্যানের স্তর অনুযায়ী বাড়ে।
অপরিবর্তনীয় অডিট ট্রেইল
প্রতিটি টুল কল Hedera-এর কনসেনসাস লেয়ারে লেখা হয়। এগুলো টাইমস্ট্যাম্পসহ, পরিবর্তন-অযোগ্য এবং অন-চেইনে সর্বজনীনভাবে যাচাইযোগ্য। get_transaction_history দিয়ে সম্পূর্ণ অডিট ইতিহাস পাওয়া যায়।
এজেন্ট অনুমোদন প্রক্রিয়া
এজেন্ট-টু-এজেন্ট লেনদেন সম্পন্নের আগে মানুষের ইমেইল অনুমোদন বাধ্যতামূলক করা যায়। require_human_approval কনফিগার করতে update_my_agent_settings ব্যবহার করুন।
API key স্কোপ
কোনো অর্থ না সরিয়ে ব্যালেন্স, রেট, ইতিহাস ও সীমা দেখা
অন্য অ্যাকাউন্টে টোকেন পাঠানো (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 | সেটেলমেন্টে প্ল্যাটফর্ম ফি |
প্ল্যান
ফ্রি
সব শুধু-পড়া টুল সবসময় ফ্রি। রেট বা ব্যালেন্স দেখতে কোনো অ্যাকাউন্ট লাগে না।
- সব শুধু-পড়া টুল চিরকাল ফ্রি
- Sandbox পরিবেশ অন্তর্ভুক্ত
- get_balances, get_exchange_rate এবং আরও 22টি
- কমিউনিটি সাপোর্ট
- Hedera testnet সেটেলমেন্ট
ব্যবহার অনুযায়ী পেমেন্ট
আপনার বৃদ্ধির সাথে বাড়ান। যতটুকু ব্যবহার করবেন, ততটুকুর জন্যই পেমেন্ট।
- সীমাহীন API কল
- ট্রান্সফারে 0.3%
- সোয়াপে 0.5%
- ফিয়াট রেল (পদ্ধতি অনুযায়ী ভিন্ন)
- ইমেইল + অগ্রাধিকার সাপোর্ট
- Hedera mainnet সেটেলমেন্ট
- সম্পূর্ণ অডিট ট্রেইল
এন্টারপ্রাইজ
ভলিউম ডিসকাউন্ট, SLA এবং ডেডিকেটেড অবকাঠামো।
- কাস্টম ফি স্তর
- ডেডিকেটেড MCP এন্ডপয়েন্ট
- SLA গ্যারান্টি
- কাস্টম খরচের সীমা
- ডেডিকেটেড সাপোর্ট
- অন-প্রিমিস বিকল্প
প্রশ্নোত্তর
BananaCrystal ও MCP সার্ভার সম্পর্কে সাধারণ প্রশ্ন।
আপনার এজেন্টকে একটি ওয়ালেট দিতে প্রস্তুত?
আপনার API key তৈরি করুন এবং 5 মিনিটের কম সময়ে আপনার এজেন্টকে 40টি পেমেন্ট টুলের সাথে যুক্ত করুন। শুধু-পড়া টুল সবসময় ফ্রি।
API key নিন