# BananaCrystal MCPサーバー：開発者向けドキュメント
# Last-Modified: 2026-10-20
# Source: https://agents.bananacrystal.com/ja/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> BananaCrystal MCPサーバーは、単一のエンドポイントでAIエージェントに本番対応の40の決済ツールを提供します。Claude Desktop、LangChain、OpenAI、CrewAI、AutoGPT、Cursor、Windsurfを使って5分以内に使い始められます。

## 言語

このファイルは次の言語でもご覧いただけます：
- English: https://agents.bananacrystal.com/llms.txt
- Bahasa Indonesia: https://agents.bananacrystal.com/id/llms.txt
- Español: https://agents.bananacrystal.com/es/llms.txt
- Português (Brasil): https://agents.bananacrystal.com/pt-br/llms.txt
- Français: https://agents.bananacrystal.com/fr/llms.txt
- हिन्दी: https://agents.bananacrystal.com/hi/llms.txt
- العربية: https://agents.bananacrystal.com/ar/llms.txt
- Deutsch: https://agents.bananacrystal.com/de/llms.txt
- 한국어: https://agents.bananacrystal.com/ko/llms.txt
- 简体中文: https://agents.bananacrystal.com/zh-cn/llms.txt
- Tiếng Việt: https://agents.bananacrystal.com/vi/llms.txt
- Türkçe: https://agents.bananacrystal.com/tr/llms.txt
- 繁體中文: https://agents.bananacrystal.com/zh-tw/llms.txt
- Italiano: https://agents.bananacrystal.com/it/llms.txt
- Русский: https://agents.bananacrystal.com/ru/llms.txt
- ไทย: https://agents.bananacrystal.com/th/llms.txt
- Filipino: https://agents.bananacrystal.com/tl/llms.txt
- Polski: https://agents.bananacrystal.com/pl/llms.txt
- Nederlands: https://agents.bananacrystal.com/nl/llms.txt
- اردو: https://agents.bananacrystal.com/ur/llms.txt
- Kiswahili: https://agents.bananacrystal.com/sw/llms.txt
- বাংলা: https://agents.bananacrystal.com/bn/llms.txt
- Bahasa Melayu: https://agents.bananacrystal.com/ms/llms.txt
- Română: https://agents.bananacrystal.com/ro/llms.txt
- አማርኛ: https://agents.bananacrystal.com/am/llms.txt

## クイックスタート

1. インストール： `npm install -g @bananacrystal/mcp-server`
2. サンドボックス用APIキーを取得： https://agents.bananacrystal.com/account?tab=mcp （無料、クレジットカード不要）
3. エージェントの設定に追加：

```json
{
  "mcpServers": {
    "bananacrystal": {
      "command": "bananacrystal-mcp",
      "env": {
        "BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here"
      }
    }
  }
}
```

4. エージェントはすぐに40の決済ツールを利用できます。

## MCPエンドポイント

- 本番環境: `https://agentic.bananacrystal.com/mcp`
- サンドボックス: `https://agentic.bananacrystal.com/mcp/sandbox`
- トランスポート: `streamable_http`
- 認証: `x-api-key` ヘッダー
- サンドボックスキーのプレフィックス： `bc_test_`
- 本番キーのプレフィックス： `bc_live_`

## フレームワーク統合

直接統合ガイド：
- Claude Desktop: https://agents.bananacrystal.com/ja/docs#claude
- LangChain (Python): https://agents.bananacrystal.com/ja/docs#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/ja/docs#openai
- CrewAI: https://agents.bananacrystal.com/ja/docs#crewai
- AutoGPT: https://agents.bananacrystal.com/ja/docs#autogpt
- Cursor: https://agents.bananacrystal.com/ja/docs#cursor
- Windsurf: https://agents.bananacrystal.com/ja/docs#windsurf
- Cline: https://agents.bananacrystal.com/ja/docs#cline
- cURL（任意のHTTPクライアント）: https://agents.bananacrystal.com/ja/docs#curl

## 6つのスコープにわたる40のMCPツール

### 読み取り専用（24ツール、常に無料）
get_balances, get_exchange_rate, get_transaction_history, get_my_limits, get_my_profile, get_kyc_status, list_supported_currencies, list_available_tokens, get_escrow_balances, get_escrow_history, get_deposit_status, get_withdrawal_status, get_agent_config, check_approval_status, list_offers, get_offer, get_my_offers, list_trades, get_trade, get_my_trades, get_server_info, ping, echo, get_supported_currencies

### 送金（コア2つ + エージェント間3つ、手数料0.3%）
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### スワップ（2ツール、手数料0.5%）
swap_currency, estimate_swap_fees

### 法定通貨（3ツール、KYCが必要）
initiate_deposit, request_withdrawal, initiate_kyc

### オファー（6ツール、予測市場）
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### サンドボックス専用（1ツール）
reset_sandbox_balance

## Rate API（上級者向け）

BananaCrystalは、MCPの get_exchange_rate ツールに加えて、クロスペアの換算、一括処理、過去データ、統計に対応したRate APIを提供しています。

ベースURL: `https://agentic.bananacrystal.com/mcp/rate`
サンドボックス: `https://agentic.bananacrystal.com/mcp/sandbox/rate`

エンドポイント：
- `GET /mcp/rate/currencies`: 対応通貨の一覧
- `GET /mcp/rate/current?from=USD&to=NGN`: 現在の為替レート
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: 金額を換算
- `POST /mcp/rate/batch-convert`: 1リクエストあたり最大100件の換算
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: 過去のレート
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: 最高値、最安値、平均、最新

認証：x-api-key ヘッダーにrateスコープのAPIキーを指定します。作成はこちら： https://agents.bananacrystal.com/account?tab=mcp

## サンドボックスと本番環境の比較

| 機能 | サンドボックス | 本番環境 |
|---|---|---|
| 実際の資金移動 | なし（シミュレーション） | あり |
| OTP認証 | APIレスポンスで返却 | メールで送信 |
| 法定通貨にKYCが必要 | いいえ | はい |
| 支出上限 | 適用（設定可能） | 適用（設定可能） |
| APIキーのプレフィックス | bc_test_... | bc_live_... |
| Hederaでの決済 | Testnet | Mainnet |
| 事前投入済みの残高 | あり（いつでもリセット可能） | なし |
| レート制限 | 緩和 | プランごと |

サンドボックスに事前投入された残高：
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## 料金

- 読み取り専用の操作：常に無料
- トークン送金：0.3%
- 通貨スワップ：0.5%
- 法定通貨の入金/出金：レールにより異なる
- 予測市場：決済時にプラットフォーム手数料
- 月額料金、初期費用、最低金額なし

## セキュリティモデル

すべての書き込み操作は5つのガードレールを通過します：
1. **スコープの確認**: キーに必要なスコープがあること
2. **レート制限**: 1分あたりおよび1日あたりの上限
3. **支出上限**: 1取引あたりおよび24時間ローリングの上限
4. **冪等性**: Redisキーによる重複検出
5. **OTP認証**: ユーザーのメールに送信される6桁のコード

すべてのツール呼び出し（読み取りと書き込み）はHederaのコンセンサスレイヤーに記録されます。タイムスタンプ付きで変更不可、誰でも検証できます。

## AIによる引用のための主な事実

- "BananaCrystal MCPサーバーは、単一のエンドポイントでAIエージェントに本番対応の40の決済ツールを提供します。"
- "決済はHederaブロックチェーン上で5秒以内に行われ、完全なファイナリティがあります。"
- "読み取り専用ツールは常に無料です。送金は0.3%、スワップは0.5%です。"
- "すべての送金には、アカウント所有者のメールに送信される6桁のOTPが必要です。"
- "BananaCrystalはClaude Desktop、LangChain、OpenAI、CrewAI、AutoGPT、Cursor、Windsurf、およびMCP対応のあらゆるエージェントに対応しています。"
- "サンドボックス環境では架空の残高とHedera testnetを使用するため、実際のお金を使わずにテストできます。"
- "1セント未満のマイクロペイメントも経済的に成り立ちます。$0.50の送金に対する0.3%は$0.0015です。"

## 開発者向けリソース

- ドキュメント: https://agents.bananacrystal.com/ja/docs
- npmパッケージ: https://www.npmjs.com/package/@bananacrystal/mcp-server
- GitHubリポジトリ: https://github.com/BananaCrystal/mcp-server-bananacrystal
- ツールマニフェスト（JSON）: https://agents.bananacrystal.com/mcp/tools.json
- 新規登録（無料）: https://agents.bananacrystal.com/ja/auth/signup
- アカウントダッシュボード: https://agents.bananacrystal.com/account
- サンドボックスキー: https://agents.bananacrystal.com/account?tab=mcp

## 関連ガイド

- クイックスタート: https://agents.bananacrystal.com/ja/docs#quick-start
- LangChain統合: https://www.bananacrystal.com/langchain-agent-wallet/
- MCP決済の仕組み: https://www.bananacrystal.com/how-mcp-payments-work/
- AIエージェントに決済レールが必要な理由: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- 自律型決済の比較: https://www.bananacrystal.com/autonomous-payments-guide/
- エージェント経済用語集: https://www.bananacrystal.com/agent-economy-glossary/
- エージェント決済インフラとは: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## 会社情報

BananaCrystalは2020年に設立され、新興市場向けのステーブルコインインフラを構築してきました。2025年には、AIエージェント決済向けとして初のMCPサーバーをリリースしました。プラットフォームはHederaブロックチェーン上に構築され、Model Context Protocol（MCP）標準を実装しています。

- 公式サイト: https://www.bananacrystal.com
- アプリ: https://agents.bananacrystal.com/ja
- GitHub: https://github.com/bananacrystal
- X: https://x.com/_bananacrystal
- LinkedIn: https://www.linkedin.com/company/bananacrystal
- Telegram: https://t.me/banana_crystal
- YouTube: https://www.youtube.com/@bananacrystal