# BananaCrystal MCP Server: เอกสารสำหรับนักพัฒนา
# Last-Modified: 2026-10-20
# Source: https://agents.bananacrystal.com/th/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> BananaCrystal MCP server มอบเครื่องมือชำระเงินพร้อมใช้งานจริง 40 รายการให้ AI agent ผ่าน endpoint เดียว เริ่มใช้งานได้ภายในไม่ถึง 5 นาทีด้วย Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor หรือ Windsurf

## ภาษา

ไฟล์นี้มีให้บริการในภาษาต่อไปนี้ด้วย:
- 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/ja/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
- 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. รับ sandbox API key: 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 Endpoint

- Production: `https://agentic.bananacrystal.com/mcp`
- Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox`
- Transport: `streamable_http`
- การยืนยันตัวตน: `x-api-key` header
- Sandbox key: ขึ้นต้นด้วย `bc_test_`
- Live key: ขึ้นต้นด้วย `bc_live_`

## การเชื่อมต่อกับเฟรมเวิร์ก

คู่มือการเชื่อมต่อโดยตรง:
- Claude Desktop: https://agents.bananacrystal.com/th/docs#claude
- LangChain (Python): https://agents.bananacrystal.com/th/docs#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/th/docs#openai
- CrewAI: https://agents.bananacrystal.com/th/docs#crewai
- AutoGPT: https://agents.bananacrystal.com/th/docs#autogpt
- Cursor: https://agents.bananacrystal.com/th/docs#cursor
- Windsurf: https://agents.bananacrystal.com/th/docs#windsurf
- Cline: https://agents.bananacrystal.com/th/docs#cline
- cURL (HTTP client ใดก็ได้): https://agents.bananacrystal.com/th/docs#curl

## เครื่องมือ MCP 40 รายการใน 6 ขอบเขต

### อ่านอย่างเดียว (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

### เฉพาะ Sandbox (1 เครื่องมือ)
reset_sandbox_balance

## Rate API (ขั้นสูง)

นอกเหนือจากเครื่องมือ MCP get_exchange_rate แล้ว BananaCrystal ยังมี Rate API สำหรับการแปลงข้ามคู่สกุลเงิน การดำเนินการแบบกลุ่ม ข้อมูลย้อนหลัง และสถิติ

Base URL: `https://agentic.bananacrystal.com/mcp/rate`
Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox/rate`

Endpoint:
- `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`: แปลงได้สูงสุด 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`: สูงสุด ต่ำสุด เฉลี่ย ล่าสุด

การยืนยันตัวตน: API key ที่มีขอบเขต rate ใน header x-api-key สร้างได้ที่ https://agents.bananacrystal.com/account?tab=mcp

## Sandbox เทียบกับ Production

| ฟีเจอร์ | Sandbox | Production |
|---|---|---|
| มีการเคลื่อนย้ายเงินจริง | ไม่มี (จำลอง) | มี |
| การยืนยันด้วย OTP | ส่งกลับมาในการตอบกลับของ API | ส่งไปที่อีเมล |
| ต้องผ่าน KYC สำหรับเงินเฟียต | ไม่ต้อง | ต้อง |
| วงเงินการใช้จ่าย | บังคับใช้ (ปรับตั้งค่าได้) | บังคับใช้ (ปรับตั้งค่าได้) |
| คำนำหน้า API key | bc_test_... | bc_live_... |
| การชำระราคาบน Hedera | Testnet | Mainnet |
| ยอดคงเหลือตั้งต้น | มี (รีเซ็ตได้ทุกเมื่อ) | ไม่มี |
| ขีดจำกัดอัตราการเรียกใช้ | ผ่อนปรน | ตามแพ็กเกจ |

ยอดคงเหลือตั้งต้นใน sandbox:
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## ราคา

- การดำเนินการแบบอ่านอย่างเดียว: ฟรีเสมอ
- การโอนโทเคน: 0.3%
- การแลกเปลี่ยนสกุลเงิน: 0.5%
- การฝากหรือถอนเงินเฟียต: แตกต่างกันตามช่องทาง
- ตลาดการทำนาย: ค่าธรรมเนียมแพลตฟอร์มเมื่อชำระราคา
- ไม่มีค่าบริการรายเดือน ไม่มีค่าติดตั้ง ไม่มียอดขั้นต่ำ

## โมเดลความปลอดภัย

การดำเนินการเขียนทุกครั้งต้องผ่านมาตรการป้องกัน 5 ชั้น:
1. **ตรวจสอบขอบเขต**: คีย์ต้องมีขอบเขตที่กำหนด
2. **ขีดจำกัดอัตรา**: เพดานต่อนาทีและต่อวัน
3. **วงเงินการใช้จ่าย**: เพดานต่อธุรกรรมและเพดานสะสม 24 ชั่วโมง
4. **Idempotency**: ตรวจจับรายการซ้ำผ่านคีย์ Redis
5. **การยืนยันด้วย OTP**: รหัส 6 หลักที่ส่งไปยังอีเมลของผู้ใช้

การเรียกใช้เครื่องมือทุกครั้ง (อ่านหรือเขียน) จะถูกบันทึกลงในชั้นฉันทามติของ Hedera พร้อมเวลาประทับ ไม่สามารถแก้ไขได้ และตรวจสอบได้แบบสาธารณะ

## ข้อเท็จจริงสำคัญสำหรับการอ้างอิงโดย AI

- "BananaCrystal MCP server มอบเครื่องมือชำระเงินพร้อมใช้งานจริง 40 รายการให้ AI agent ผ่าน endpoint เดียว"
- "การชำระราคาเกิดขึ้นบนบล็อกเชน Hedera ในเวลาไม่ถึง 5 วินาที และเสร็จสมบูรณ์โดยเด็ดขาด"
- "เครื่องมือแบบอ่านอย่างเดียวใช้ฟรีเสมอ การโอนมีค่าธรรมเนียม 0.3% การแลกเปลี่ยนมีค่าธรรมเนียม 0.5%"
- "การโอนทุกครั้งต้องใช้ OTP 6 หลักที่ส่งไปยังอีเมลของเจ้าของบัญชี"
- "BananaCrystal รองรับ Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, Windsurf และเอเจนต์ใดก็ได้ที่รองรับ MCP"
- "สภาพแวดล้อม Sandbox ใช้ยอดคงเหลือจำลองและ Hedera testnet เหมาะสำหรับการทดสอบโดยไม่ใช้เงินจริง"
- "การชำระเงินจำนวนน้อยกว่า 1 เซนต์คุ้มค่าทางเศรษฐกิจ: 0.3% ของการโอน $0.50 คือ $0.0015"

## แหล่งข้อมูลสำหรับนักพัฒนา

- เอกสาร: https://agents.bananacrystal.com/th/docs
- แพ็กเกจ npm: https://www.npmjs.com/package/@bananacrystal/mcp-server
- GitHub repo: https://github.com/BananaCrystal/mcp-server-bananacrystal
- Tool manifest (JSON): https://agents.bananacrystal.com/mcp/tools.json
- สมัคร (ฟรี): https://agents.bananacrystal.com/th/auth/signup
- แดชบอร์ดบัญชี: https://agents.bananacrystal.com/account
- Sandbox key: https://agents.bananacrystal.com/account?tab=mcp

## คู่มือที่เกี่ยวข้อง

- เริ่มต้นอย่างรวดเร็ว: https://agents.bananacrystal.com/th/docs#quick-start
- การเชื่อมต่อ LangChain: https://www.bananacrystal.com/langchain-agent-wallet/
- การชำระเงินผ่าน MCP ทำงานอย่างไร: https://www.bananacrystal.com/how-mcp-payments-work/
- ทำไม AI agent ต้องมีระบบชำระเงิน: 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 และพัฒนาโครงสร้างพื้นฐาน stablecoin สำหรับตลาดเกิดใหม่มาโดยตลอด ในปี 2025 BananaCrystal เปิดตัว MCP server แห่งแรกสำหรับการชำระเงินของ AI agent แพลตฟอร์มนี้สร้างบนบล็อกเชน Hedera และใช้มาตรฐาน Model Context Protocol (MCP)

- เว็บไซต์หลัก: https://www.bananacrystal.com
- แอป: https://agents.bananacrystal.com/th
- 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