क्विक स्टार्ट
5 मिनट से कम में अपने AI एजेंट से पेमेंट शुरू करवाएं।
MCP सर्वर इंस्टॉल करें
npm से BananaCrystal MCP सर्वर को ग्लोबली इंस्टॉल करें।
npm install -g @bananacrystal/mcp-serverअपनी API key पाएं
अपने अकाउंट dashboard से MCP API key बनाएं। Sandbox keys bc_test_ से शुरू होती हैं और मुफ्त हैं।
bc_test_...Claude Desktop कॉन्फ़िगर करें
अपनी Claude Desktop config फ़ाइल में 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 से होता है। अपने अकाउंट dashboard से rate key बनाएं।
ऑथेंटिकेशन
सभी Rate API एंडपॉइंट के लिए rate स्कोप वाली API key ज़रूरी है, जिसे x-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किसी अवधि के रेट आंकड़े पाएं (high, low, avg, latest)
पैरामीटर
| नाम | ज़रूरी | विवरण |
|---|---|---|
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 keys bc_test_ से शुरू होती हैं और Hedera testnet से जुड़ती हैं।
पहले से भरे बैलेंस
हर sandbox अकाउंट इन बैलेंस के साथ शुरू होता है। इन्हें कभी भी वापस लाने के लिए reset_sandbox_balance इस्तेमाल करें।
| Token | रकम | करेंसी |
|---|---|---|
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"
}
}
}
}कॉन्फ़िगरेशन
BananaCrystal को अपने पसंदीदा AI टूल या फ्रेमवर्क से जोड़ें।
{
"mcpServers": {
"bananacrystal": {
"command": "bananacrystal-mcp",
"env": {
"BANANACRYSTAL_API_KEY": "your_api_key_here"
}
}
}
}एनवायरनमेंट वेरिएबल
BANANACRYSTAL_API_KEYज़रूरीआपकी MCP API key। Sandbox keys bc_test_ से और लाइव keys 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 keys bc_test_ से और लाइव keys 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 सर्वर सपोर्ट करता है, तो उसे https://agentic.bananacrystal.com/mcp पर पॉइंट करें और अपनी API key को Bearer token के रूप में दें।
सिक्योरिटी आर्किटेक्चर
सुरक्षा की कई परतें, ताकि आपका एजेंट सिर्फ़ वही कर सके जिसकी आप साफ़ अनुमति दें।
API key स्कोप
हर API key के अपने तय परमिशन स्कोप होते हैं। एजेंट सिर्फ़ आपके दिए स्कोप के अंदर ही ऑपरेशन कर सकता है।
खर्च की लिमिट
हर API key के लिए प्रति ट्रांज़ैक्शन अधिकतम रकम और 24 घंटे की रोलिंग दैनिक सीमा तय करें। ये इंफ्रास्ट्रक्चर लेवल पर लागू होती हैं।
OTP वेरिफ़िकेशन
हर token ट्रांसफर के लिए आपके रजिस्टर्ड ईमेल पर भेजा गया 6 अंकों का OTP ज़रूरी है। आपके कोड दिए बिना एजेंट ट्रांसफर पूरा नहीं कर सकता।
रेट लिमिटिंग
हर key पर प्रति मिनट रेट सीमा बेकाबू एजेंट को API पर बार-बार रिक्वेस्ट भेजने से रोकती है। लिमिट आपके प्लान टियर के साथ बढ़ती है।
न बदलने वाला ऑडिट ट्रेल
हर टूल कॉल Hedera की कंसेंसस लेयर पर दर्ज होती है। उन पर टाइमस्टैम्प होता है, उनसे छेड़छाड़ नहीं हो सकती और उन्हें ऑन-चेन कोई भी वेरिफ़ाई कर सकता है। पूरी ऑडिट हिस्ट्री get_transaction_history से मिलती है।
एजेंट अप्रूवल फ़्लो
एजेंट-से-एजेंट ट्रांज़ैक्शन पूरा होने से पहले इंसान से ईमेल अप्रूवल मांगा जा सकता है। require_human_approval कॉन्फ़िगर करने के लिए update_my_agent_settings इस्तेमाल करें।
API key स्कोप
बिना कोई फ़ंड हिलाए बैलेंस, रेट, हिस्ट्री और लिमिट चेक करें
दूसरे अकाउंट पर token भेजें (OTP ज़रूरी)
करेंसी stablecoin के बीच स्वैप करें
फिएट डिपॉज़िट और निकासी (KYC ज़रूरी)
प्रेडिक्शन मार्केट ऑफ़र और ट्रेड बनाएं और मैनेज करें
करेंसी एक्सचेंज रेट, पुराना डेटा, कन्वर्ज़न और रेट आंकड़े देखें
| स्कोप | क्या करने देता है |
|---|---|
| read_only | बिना कोई फ़ंड हिलाए बैलेंस, रेट, हिस्ट्री और लिमिट चेक करें |
| transfer | दूसरे अकाउंट पर token भेजें (OTP ज़रूरी) |
| swap | करेंसी stablecoin के बीच स्वैप करें |
| fiat | फिएट डिपॉज़िट और निकासी (KYC ज़रूरी) |
| offers | प्रेडिक्शन मार्केट ऑफ़र और ट्रेड बनाएं और मैनेज करें |
| rate | करेंसी एक्सचेंज रेट, पुराना डेटा, कन्वर्ज़न और रेट आंकड़े देखें |
प्राइसिंग
रीड-ओनली ऑपरेशन हमेशा मुफ्त हैं। सिर्फ़ उन ट्रांज़ैक्शन के लिए भुगतान करें जिनमें पैसा जाता है।
ऑपरेशन फीस
रीड-ओनली ऑपरेशन
get_balances, get_exchange_rate, list_trades, …
Token ट्रांसफर
transfer_tokens
करेंसी स्वैप
swap_currency
फिएट डिपॉज़िट
initiate_deposit
फिएट निकासी
request_withdrawal
प्रेडिक्शन मार्केट
create_offer, engage_offer
| ऑपरेशन | टूल | फीस |
|---|---|---|
| रीड-ओनली ऑपरेशन | get_balances, get_exchange_rate, list_trades, … | मुफ्त |
| Token ट्रांसफर | 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 गारंटी
- कस्टम खर्च लिमिट
- डेडिकेटेड सपोर्ट
- ऑन-प्रिमाइस विकल्प
FAQ
BananaCrystal और MCP सर्वर के बारे में आम सवाल।
अपने एजेंट को wallet देने के लिए तैयार हैं?
अपनी API key बनाएं और 5 मिनट से कम में अपने एजेंट को 40 पेमेंट टूल से जोड़ें। रीड-ओनली टूल हमेशा मुफ्त हैं।
API key पाएं