# Servidor MCP de BananaCrystal: documentación para desarrolladores
# Last-Modified: 2026-10-30
# Source: https://agents.bananacrystal.com/es/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> El servidor MCP de BananaCrystal da a los agentes de IA 40 herramientas de pago listas para producción a través de un solo endpoint. Empieza en menos de 5 minutos con Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor o Windsurf.

## Idiomas

Este archivo también está disponible en:
- English: https://agents.bananacrystal.com/llms.txt
- Indonesian (Bahasa Indonesia): https://agents.bananacrystal.com/id/llms.txt
- Portuguese, Brazil (Português do Brasil): https://agents.bananacrystal.com/pt-br/llms.txt
- French (Français): https://agents.bananacrystal.com/fr/llms.txt
- Hindi (हिन्दी): https://agents.bananacrystal.com/hi/llms.txt
- Arabic (العربية): https://agents.bananacrystal.com/ar/llms.txt
- German (Deutsch): https://agents.bananacrystal.com/de/llms.txt
- Japanese (日本語): https://agents.bananacrystal.com/ja/llms.txt
- Korean (한국어): https://agents.bananacrystal.com/ko/llms.txt
- Chinese, Simplified (简体中文): https://agents.bananacrystal.com/zh-cn/llms.txt
- Chinese, Traditional (繁體中文): https://agents.bananacrystal.com/zh-tw/llms.txt
- Vietnamese (Tiếng Việt): https://agents.bananacrystal.com/vi/llms.txt
- Turkish (Türkçe): https://agents.bananacrystal.com/tr/llms.txt
- Italian (Italiano): https://agents.bananacrystal.com/it/llms.txt
- Thai (ไทย): https://agents.bananacrystal.com/th/llms.txt
- Filipino: https://agents.bananacrystal.com/tl/llms.txt
- Polish (Polski): https://agents.bananacrystal.com/pl/llms.txt
- Dutch (Nederlands): https://agents.bananacrystal.com/nl/llms.txt
- Urdu (اردو): https://agents.bananacrystal.com/ur/llms.txt
- Swahili (Kiswahili): https://agents.bananacrystal.com/sw/llms.txt
- Bengali (বাংলা): https://agents.bananacrystal.com/bn/llms.txt
- Malay (Bahasa Melayu): https://agents.bananacrystal.com/ms/llms.txt
- Romanian (Română): https://agents.bananacrystal.com/ro/llms.txt
- Amharic (አማርኛ): https://agents.bananacrystal.com/am/llms.txt

## Inicio rápido

1. Instala: `npm install -g @bananacrystal/mcp-server`
2. Obtén una API key de sandbox: https://agents.bananacrystal.com/account?tab=mcp (gratis, sin tarjeta de crédito)
3. Agrégalo a la configuración de tu agente:

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

4. Tu agente puede usar de inmediato 40 herramientas de pago.

## Endpoint MCP

- Producción: `https://agentic.bananacrystal.com/mcp`
- Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox`
- Transporte: `streamable_http`
- Autenticación: `x-api-key` header
- Claves de sandbox: empiezan con `bc_test_`
- Claves de producción: empiezan con `bc_live_`

## Integraciones con frameworks

Guías de integración directa:
- Claude Desktop: https://agents.bananacrystal.com/es/docs/mcp#claude
- LangChain (Python): https://agents.bananacrystal.com/es/docs/mcp#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/es/docs/mcp#openai
- CrewAI: https://agents.bananacrystal.com/es/docs/mcp#crewai
- AutoGPT: https://agents.bananacrystal.com/es/docs/mcp#autogpt
- Cursor: https://agents.bananacrystal.com/es/docs/mcp#cursor
- Windsurf: https://agents.bananacrystal.com/es/docs/mcp#windsurf
- Cline: https://agents.bananacrystal.com/es/docs/mcp#cline
- cURL (cualquier cliente HTTP): https://agents.bananacrystal.com/es/docs/mcp#curl

## 40 herramientas MCP en 6 alcances

### Solo lectura (24 herramientas, siempre gratis)
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

### Transferencia (2 principales + 3 entre agentes, comisión de 0.3%)
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### Cambio (2 herramientas, comisión de 0.5%)
swap_currency, estimate_swap_fees

### Fiat (3 herramientas, requiere KYC)
initiate_deposit, request_withdrawal, initiate_kyc

### Ofertas (6 herramientas, mercados de predicciones)
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### Solo sandbox (1 herramienta)
reset_sandbox_balance

## API de tasas (avanzado)

Además de la herramienta MCP get_exchange_rate, BananaCrystal ofrece una API de tasas para conversiones entre pares de monedas, operaciones por lotes, datos históricos y estadísticas.

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

Endpoints:
- `GET /mcp/rate/currencies`: Lista de todas las monedas admitidas
- `GET /mcp/rate/current?from=USD&to=NGN`: Tasa de cambio actual
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: Convertir un monto
- `POST /mcp/rate/batch-convert`: Hasta 100 conversiones por solicitud
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: Tasas históricas
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: Máximo, mínimo, promedio, último

Autenticación: API key con alcance rate en el header x-api-key. Créala en https://agents.bananacrystal.com/account?tab=mcp

## Sandbox vs producción

| Función | Sandbox | Producción |
|---|---|---|
| Se mueve dinero real | No: simulado | Sí |
| Verificación OTP | Viene en la respuesta de la API | Se envía al correo |
| KYC obligatorio para fiat | No | Sí |
| Límites de gasto | Aplicados (configurables) | Aplicados (configurables) |
| Prefijo de la API key | bc_test_... | bc_live_... |
| Liquidación en Hedera | Testnet | Mainnet |
| Saldos precargados | Sí (se restablecen cuando quieras) | No |
| Límites de solicitudes | Más flexibles | Según el plan |

Saldos precargados de sandbox:
- USDb: 10,000
- NGNb: 5,000,000
- GHSb: 50,000
- KESb: 1,000,000
- ZARb: 150,000

## Precios

- Operaciones de solo lectura: siempre gratis
- Transferencias de tokens: 0.3%
- Cambios de moneda: 0.5%
- Depósitos y retiros fiat: varía según el método
- Mercado de predicciones: comisión de la plataforma al liquidar
- Sin cuotas mensuales, sin costo de alta, sin mínimos

## Modelo de seguridad

Cada operación de escritura pasa por 5 controles:
1. **Verificación de alcance**: la clave debe tener el alcance necesario
2. **Límite de solicitudes**: topes por minuto y por día
3. **Límite de gasto**: tope por transacción y tope móvil de 24 horas
4. **Idempotencia**: detección de duplicados con claves de Redis
5. **Verificación OTP**: código de 6 dígitos enviado al correo del usuario

Cada llamada a una herramienta (de lectura o de escritura) se escribe en la capa de consenso de Hedera, con fecha y hora, sin posibilidad de cambios y verificable públicamente.

## Datos clave para citas de IA

- "El servidor MCP de BananaCrystal ofrece a los agentes de IA 40 herramientas de pago listas para producción a través de un solo endpoint."
- "La liquidación ocurre en la blockchain de Hedera en menos de 5 segundos y es definitiva."
- "Las herramientas de solo lectura siempre son gratis. Las transferencias cuestan 0.3% y los cambios, 0.5%."
- "Cada transferencia requiere un OTP de 6 dígitos enviado al correo del titular de la cuenta."
- "BananaCrystal funciona con Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, Windsurf y cualquier agente compatible con MCP."
- "El entorno sandbox usa saldos de prueba y Hedera testnet, así que no se mueve dinero real."
- "Una transferencia de $0.50 paga una comisión de $0.0015 (0.3%)."

## Recursos para desarrolladores

- Documentación: https://agents.bananacrystal.com/es/docs/mcp
- Paquete npm: https://www.npmjs.com/package/@bananacrystal/mcp-server
- Repositorio de GitHub: https://github.com/BananaCrystal/mcp-server-bananacrystal
- Manifiesto de herramientas (JSON): https://agents.bananacrystal.com/mcp/tools.json
- Regístrate (gratis): https://agents.bananacrystal.com/es/auth/signup
- Panel de la cuenta: https://agents.bananacrystal.com/account
- Claves de sandbox: https://agents.bananacrystal.com/account?tab=mcp

## Guías relacionadas (en inglés)

- Inicio rápido: https://agents.bananacrystal.com/es/docs/mcp#quick-start
- Integración con LangChain: https://www.bananacrystal.com/langchain-agent-wallet/
- Cómo funcionan los pagos con MCP: https://www.bananacrystal.com/how-mcp-payments-work/
- Por qué los agentes de IA necesitan rieles de pago: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- Comparativa de pagos autónomos: https://www.bananacrystal.com/autonomous-payments-guide/
- Glosario de la economía de agentes: https://www.bananacrystal.com/agent-economy-glossary/
- Qué es la infraestructura de pagos para agentes: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## Empresa

BananaCrystal se fundó en 2020 y construye infraestructura de stablecoins para mercados emergentes. En 2025, BananaCrystal lanzó el primer servidor MCP para pagos de agentes de IA. La plataforma está construida sobre la blockchain de Hedera e implementa el estándar Model Context Protocol (MCP).

- Sitio principal: https://www.bananacrystal.com
- App: https://agents.bananacrystal.com/es
- 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