What is BananaCrystal MCP?

BananaCrystal MCP is a Model Context Protocol server that gives AI agents the ability to check balances, transfer stablecoins, swap currencies, and handle fiat through a single endpoint settled on Hedera blockchain.

How fast are agent transactions?

Transactions settle in under 5 seconds on the Hedera consensus layer, providing instant finality for autonomous agent operations.

Documentación MCP: 40 herramientas de pago para agentes de IA

Inicio rápido

Haz que tu agente de IA haga pagos en menos de 5 minutos.

Instala el servidor MCP

Instala el servidor MCP de BananaCrystal de forma global con npm.

bash

npm install -g @bananacrystal/mcp-server

Obtén tu API key

Crea una API key de MCP desde el panel de tu cuenta. Las claves de sandbox empiezan con bc_test_ y son gratis.

Obtener API key

Claves de sandbox: bc_test_...

Configura Claude Desktop

Agrega BananaCrystal al archivo de configuración de Claude Desktop.

claude_desktop_config.json

json

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

Pídele algo a tu agente

Tu agente ya tiene 40 herramientas de pago. Prueba estas instrucciones:

›"¿Cuál es mi saldo actual de USDb?"

›"Envía 50 USDb a 0.0.654321"

›"Cambia 100 USDb a NGNb a la tasa actual"

›"Muéstrame mis últimas 10 transacciones"

›"¿Cuál es el tipo de cambio actual de USD a NGN?"

Herramientas MCP

40 herramientas de pago listas para producción en 6 categorías. Las operaciones de solo lectura siempre son gratis.

Solo lectura24 herramientas

ping

read_onlygratis

Verificación de estado: responde pong

get_server_info

read_onlygratis

Devuelve información básica del servidor

echo

read_onlygratis

Devuelve el mensaje de entrada a quien lo llama

get_my_profile

read_onlygratis

Obtiene el perfil completo del usuario autenticado

get_balances

read_onlygratis

Obtiene el saldo de la cuenta de Hedera para todos los tokens de la plataforma o para uno específico

get_exchange_rate

read_onlygratis

Obtiene las tasas de compra y venta en vivo de una moneda

list_supported_currencies

read_onlygratis

Lista todas las monedas disponibles con sus comisiones dinámicas

list_available_tokens

read_onlygratis

Lista todos los tokens de Hedera disponibles en la plataforma

get_transaction_history

read_onlygratis

Obtiene el historial de transacciones por categoría, con filtros

get_my_limits

read_onlygratis

Obtiene los límites configurados y el uso en vivo de la API key autenticada

estimate_swap_fees

read_onlygratis

Estima las comisiones de un cambio de moneda antes de ejecutarlo

get_agent_config

read_onlygratis

Consulta la configuración del agente de otro usuario

check_approval_status

read_onlygratis

Consulta el estado de una solicitud de aprobación pendiente de una transacción de agente

get_kyc_status

read_onlygratis

Obtiene el estado de verificación KYC de un usuario mediante Sumsub

get_deposit_status

read_onlygratis

Obtiene el estado de un depósito fiat por ID de transferencia

get_withdrawal_status

read_onlygratis

Obtiene las solicitudes de retiro de un usuario mediante Brale

get_escrow_balances

read_onlygratis

Obtiene el desglose del saldo en garantía: total, disponible y bloqueado

get_escrow_history

read_onlygratis

Obtiene el historial completo de garantía, con bloqueos, liberaciones, ganancias y pérdidas

list_offers

read_onlygratis

Explora las ofertas activas del mercado de predicciones con estadísticas de operaciones

get_offer

read_onlygratis

Obtiene el detalle completo de una oferta, con estadísticas de operaciones

get_my_offers

read_onlygratis

Obtiene todas las ofertas creadas por un usuario específico

list_trades

read_onlygratis

Lista todas las operaciones de la plataforma, con filtros

get_trade

read_onlygratis

Obtiene el detalle completo de una operación, con estadísticas de su oferta

get_my_trades

read_onlygratis

Obtiene todas las operaciones de un usuario, creadas y recibidas

Transferencia2 herramientas

request_transfer_otp

transfer0.3%

Paso 1: solicita un código OTP de verificación que se envía al correo del remitente

transfer_tokens

transfer0.3%

Paso 2: ejecuta la transferencia de tokens con verificación OTP

Cambio1 herramienta

swap_currency

swap0.5%

Cambia entre dos tokens de Hedera con la tasa y las comisiones calculadas automáticamente

Fiat3 herramientas

initiate_kyc

fiat

Inicia la verificación KYC: devuelve un token de acceso de Sumsub para el SDK

initiate_deposit

fiat

Inicia un depósito fiat mediante Brale (requiere KYC)

request_withdrawal

fiat

Solicita un retiro fiat mediante Brale (requiere KYC)

Ofertas y operaciones6 herramientas

create_offer

offers

Crea una oferta en el mercado de predicciones que bloquea el monto total en garantía

update_offer

offers

Edita una oferta existente (solo si no tiene operaciones)

delist_offer

offers

Retira tu oferta del mercado y libera la garantía bloqueada

delete_offer

offers

Elimina tu oferta de forma permanente (no se puede si tiene operaciones activas)

engage_offer

offers

Toma una oferta abierta bloqueando una garantía equivalente

cancel_trade

offers

Cancela una operación activa y libera tu garantía bloqueada

Entre agentes3 herramientas

request_agent_transaction

transfer

Solicita una transacción en nombre del agente de otro usuario (requiere aprobación por correo)

execute_approved_transaction

transfer

Ejecuta una transacción de agente ya aprobada con el token de ejecución

update_my_agent_settings

read_onlygratis

Define si las transacciones entre agentes requieren aprobación por correo y OTP

Solo sandbox1 herramienta

reset_sandbox_balance

read_onlygratis

Restablece los saldos de sandbox a los valores iniciales (solo sandbox)

API de tasas

Operaciones avanzadas con tasas de cambio vía REST. Requiere una API key con alcance rate.

Herramienta MCP vs API de tasas: ¿cuál es la diferencia?

El servidor MCP ya incluye get_exchange_rate como herramienta read_only: tu agente puede llamarla directamente para obtener la tasa de compra y venta de una moneda frente al USD. Eso cubre la mayoría de los casos de uso de un agente.

La API de tasas va más allá: conversiones entre pares cruzados, operaciones masivas por lotes, series históricas y resúmenes estadísticos. Están disponibles como endpoints HTTP directos, autenticados con una API key con alcance rate. Crea una clave rate desde el panel de tu cuenta.

Autenticación

Todos los endpoints de la API de tasas requieren una API key con alcance rate, enviada en el encabezado x-api-key. Los equivalentes de sandbox están en /mcp/sandbox/rate/* y usan tu clave de sandbox (bc_test_...) con tasas simuladas fijas para pruebas reproducibles.

URL base

https://agentic.bananacrystal.com/mcp/rate

GET/mcp/rate/currenciesLista todas las monedas disponibles

Lista todas las monedas disponibles

Ejemplo de solicitud

bash

curl "https://agentic.bananacrystal.com/mcp/rate/currencies" \
  -H "x-api-key: bc_live_your_rate_key_here"

Ejemplo de respuesta

json

{
  "count": 11,
  "currencies": ["EGP", "EUR", "GBP", "GHS", "KES", "NGN", "TZS", "UGX", "USD", "XOF", "ZAR"]
}

GET/mcp/rate/currentObtiene el tipo de cambio actual entre dos monedas

Obtiene el tipo de cambio actual entre dos monedas

Parámetros

Nombre	Obligatorio	Descripción
`from`	obligatorio	Código de la moneda de origen (p. ej. USD)
`to`	obligatorio	Código de la moneda de destino (p. ej. NGN)

Ejemplo de solicitud

bash

curl "https://agentic.bananacrystal.com/mcp/rate/current?from=USD&to=NGN" \
  -H "x-api-key: bc_live_your_rate_key_here"

Ejemplo de respuesta

json

{
  "from": "USD",
  "to": "NGN",
  "rate": 1584.75,
  "buyRate": 1590.0,
  "sellRate": 1579.5,
  "timestamp": "2026-04-30T10:22:00.000Z"
}

GET/mcp/rate/convertConvierte un monto de una moneda a otra

Convierte un monto de una moneda a otra

Parámetros

Nombre	Obligatorio	Descripción
`from`	obligatorio	Código de la moneda de origen
`to`	obligatorio	Código de la moneda de destino
`amount`	obligatorio	Monto a convertir (número)

Ejemplo de solicitud

bash

curl "https://agentic.bananacrystal.com/mcp/rate/convert?from=USD&to=NGN&amount=100" \
  -H "x-api-key: bc_live_your_rate_key_here"

Ejemplo de respuesta

json

{
  "from": "USD",
  "to": "NGN",
  "amount": 100,
  "converted": 158475.0,
  "rate": 1584.75,
  "timestamp": "2026-04-30T10:22:00.000Z"
}

POST/mcp/rate/batch-convertConvierte varios montos en una sola solicitud (máximo 100)

Convierte varios montos en una sola solicitud (máximo 100)

Ejemplo de solicitud

bash

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 }
    ]
  }'

Ejemplo de respuesta

json

[
  { "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": "..." }
]

GET/mcp/rate/historyObtiene tipos de cambio históricos de un par de monedas

Obtiene tipos de cambio históricos de un par de monedas

Parámetros

Nombre	Obligatorio	Descripción
`from`	obligatorio	Código de la moneda de origen
`to`	obligatorio	Código de la moneda de destino
`startDate`	obligatorio	Fecha de inicio (ISO 8601, p. ej. 2026-04-01)
`endDate`	obligatorio	Fecha de fin (ISO 8601, p. ej. 2026-04-30)

Ejemplo de solicitud

bash

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"

Ejemplo de respuesta

json

[
  { "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 }
]

GET/mcp/rate/statsObtiene estadísticas de la tasa (máxima, mínima, promedio, última) en un período

Obtiene estadísticas de la tasa (máxima, mínima, promedio, última) en un período

Parámetros

Nombre	Obligatorio	Descripción
`from`	obligatorio	Código de la moneda de origen
`to`	obligatorio	Código de la moneda de destino
`days`	opcional	Período en días, de 1 a 365 (por defecto: 30)

Ejemplo de solicitud

bash

curl "https://agentic.bananacrystal.com/mcp/rate/stats?from=USD&to=NGN&days=30" \
  -H "x-api-key: bc_live_your_rate_key_here"

Ejemplo de respuesta

json

{
  "from": "USD",
  "to": "NGN",
  "period": "30d",
  "high": 1598.0,
  "low": 1560.0,
  "avg": 1581.4,
  "latest": 1584.75,
  "count": 30
}

API de tasas en sandbox

Reemplaza /mcp/rate/ por /mcp/sandbox/rate/ y usa tu clave de sandbox para obtener tasas simuladas fijas. Los datos históricos se generan con una variación de ±2% para pruebas realistas. No se usan datos reales del mercado cambiario.

Entorno sandbox

Prueba tu integración de forma segura con saldos precargados y sin dinero real.

¿Qué es el sandbox?

El sandbox es un entorno de pruebas totalmente aislado que replica producción tal cual: las mismas herramientas, la misma API y el mismo formato de respuesta. No se mueve dinero real. Las API keys de sandbox empiezan con bc_test_ y se conectan a la testnet de Hedera.

Saldos precargados

Cada cuenta de sandbox empieza con estos saldos. Usa reset_sandbox_balance para restablecerlos cuando quieras.

Token	Monto	Moneda
`USDb`	10,000	USD
`NGNb`	5,000,000	NGN
`GHSb`	50,000	GHS
`KESb`	1,000,000	KES
`ZARb`	150,000	ZAR

Sandbox vs producción

Función	Sandbox	Producción
Se mueve dinero real	No: solo simulado	Sí
Verificación OTP	Viene en la respuesta de la API	Se envía a tu correo
KYC obligatorio para fiat	No	Sí
Límites de gasto aplicados	Sí (configurables)	Sí
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

OTP en sandbox

En modo sandbox, el código OTP llega directamente en la respuesta de la API request_transfer_otp en lugar de enviarse por correo. Así puedes automatizar pruebas sin acceso al correo.

Configuración de sandbox

claude_desktop_config.json

json

{
  "mcpServers": {
    "bananacrystal": {
      "command": "bananacrystal-mcp",
      "env": {
        "BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here",
        "BANANACRYSTAL_API_URL": "https://agentic.bananacrystal.com/mcp/sandbox"
      }
    }
  }
}

Configuración

Conecta BananaCrystal a tu herramienta o framework de IA preferido.

claude_desktop_config.json

json

{
  "mcpServers": {
    "bananacrystal": {
      "command": "bananacrystal-mcp",
      "env": {
        "BANANACRYSTAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Variables de entorno

BANANACRYSTAL_API_KEYobligatorio

Tu API key de MCP. Las claves de sandbox empiezan con bc_test_ y las de producción con bc_live_.

Por defecto: N/A

BANANACRYSTAL_API_URLopcional

Reemplaza la URL del endpoint MCP. Usa la URL de sandbox para pruebas.

Por defecto: https://agentic.bananacrystal.com/mcp

DEBUGopcional

Ponlo en true para activar el registro detallado de solicitudes y respuestas.

Por defecto: false

Variable	Obligatorio	Por defecto	Descripción
`BANANACRYSTAL_API_KEY`	obligatorio	`N/A`	Tu API key de MCP. Las claves de sandbox empiezan con bc_test_ y las de producción con bc_live_.
`BANANACRYSTAL_API_URL`	opcional	`https://agentic.bananacrystal.com/mcp`	Reemplaza la URL del endpoint MCP. Usa la URL de sandbox para pruebas.
`DEBUG`	opcional	`false`	Ponlo en true para activar el registro detallado de solicitudes y respuestas.

Integraciones con frameworks

Ejemplos listos para ejecutar con los frameworks de agentes de IA más usados.

langchain_agent.py

python

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())

Funciona con cualquier framework compatible con MCP. Si tu framework admite servidores MCP por HTTP, apúntalo a https://agentic.bananacrystal.com/mcp con tu API key como token Bearer.

Arquitectura de seguridad

Varias capas de protección para que tu agente solo haga lo que tú autorizas de forma explícita.

Alcances de la API key

Cada API key tiene alcances de permisos explícitos. Un agente solo puede hacer operaciones dentro de los alcances que tú le das.

Límites de gasto

Define montos máximos fijos por transacción y topes diarios móviles de 24 horas por API key. Se aplican a nivel de infraestructura.

Verificación OTP

Cada transferencia de tokens requiere un OTP de 6 dígitos que se envía a tu correo registrado. El agente no puede completar una transferencia si tú no le das ese código.

Límite de solicitudes

Los topes por clave y por minuto evitan que un agente descontrolado sature la API. Los límites crecen según tu plan.

Registro de auditoría inmutable

Cada llamada a una herramienta se escribe en la capa de consenso de Hedera. Queda con fecha y hora, a prueba de alteraciones y verificable públicamente en la cadena. El historial completo de auditoría está disponible con get_transaction_history.

Flujo de aprobación de agentes

Las transacciones entre agentes pueden requerir la aprobación de una persona por correo antes de ejecutarse. Usa update_my_agent_settings para configurar require_human_approval.

Alcances de la API key

read_only

Consultar saldos, tasas, historial y límites sin mover fondos

transfer

Enviar tokens a otras cuentas (requiere OTP)

swap

Cambiar entre stablecoins de distintas monedas

fiat

Depósitos y retiros fiat (requiere KYC)

offers

Crear y gestionar ofertas y operaciones del mercado de predicciones

rate

Acceder a tipos de cambio, datos históricos, conversiones y estadísticas de tasas

Alcance	Qué permite
read_only	Consultar saldos, tasas, historial y límites sin mover fondos
transfer	Enviar tokens a otras cuentas (requiere OTP)
swap	Cambiar entre stablecoins de distintas monedas
fiat	Depósitos y retiros fiat (requiere KYC)
offers	Crear y gestionar ofertas y operaciones del mercado de predicciones
rate	Acceder a tipos de cambio, datos históricos, conversiones y estadísticas de tasas

Precios

Las operaciones de solo lectura siempre son gratis. Solo pagas por las transacciones que mueven valor.

Comisiones por operación

Operaciones de solo lectura

get_balances, get_exchange_rate, list_trades, …

Gratis

Transferencias de tokens

transfer_tokens

0.3%

Cambios de moneda

swap_currency

0.5%

Depósitos fiat

initiate_deposit

Varía según el método

Retiros fiat

request_withdrawal

Varía según el método

Mercado de predicciones

create_offer, engage_offer

Comisión de la plataforma al liquidar

Operación	Herramientas	Comisión
Operaciones de solo lectura	get_balances, get_exchange_rate, list_trades, …	Gratis
Transferencias de tokens	transfer_tokens	0.3%
Cambios de moneda	swap_currency	0.5%
Depósitos fiat	initiate_deposit	Varía según el método
Retiros fiat	request_withdrawal	Varía según el método
Mercado de predicciones	create_offer, engage_offer	Comisión de la plataforma al liquidar

Planes

Gratis

$0operaciones de solo lectura

Todas las herramientas de solo lectura siempre son gratis. No necesitas cuenta para consultar tasas o saldos.

Todas las herramientas de solo lectura gratis para siempre
Entorno sandbox incluido
get_balances, get_exchange_rate y 22 más
Soporte de la comunidad
Liquidación en la testnet de Hedera

Obtener API key

Más popular

Pago por uso

Según usosin cuota mensual

Crece a tu ritmo. Paga solo por lo que usas.

Llamadas a la API ilimitadas
0.3% en transferencias
0.5% en cambios
Rieles fiat (varía según el método)
Soporte por correo y prioritario
Liquidación en la mainnet de Hedera
Registro de auditoría completo

Obtener API key

Empresas

A medidacontáctanos

Descuentos por volumen, SLA e infraestructura dedicada.

Niveles de comisión a medida
Endpoint MCP dedicado
Garantías de SLA
Límites de gasto a medida
Soporte dedicado
Opción on-premise

Hablar con ventas

Preguntas frecuentes

Preguntas comunes sobre BananaCrystal y el servidor MCP.

¿Listo para darle una billetera a tu agente?

Crea tu API key y conecta tu agente a 40 herramientas de pago en menos de 5 minutos. Las herramientas de solo lectura siempre son gratis.

Obtener API key

Documentación de MCP de BananaCrystal

Inicio rápido

Instala el servidor MCP

Obtén tu API key

Configura Claude Desktop

Pídele algo a tu agente

Herramientas MCP

API de tasas

Herramienta MCP vs API de tasas: ¿cuál es la diferencia?

Autenticación

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

API de tasas en sandbox

Entorno sandbox

¿Qué es el sandbox?

Saldos precargados

Sandbox vs producción

OTP en sandbox

Configuración de sandbox

Configuración

Variables de entorno

Integraciones con frameworks

Arquitectura de seguridad

Alcances de la API key

Límites de gasto

Verificación OTP

Límite de solicitudes

Registro de auditoría inmutable

Flujo de aprobación de agentes

Alcances de la API key

Precios

Comisiones por operación

Planes

Gratis

Pago por uso

Empresas

Preguntas frecuentes

¿Listo para darle una billetera a tu agente?