Servidor MCP40 ferramentasv1.0

    Documentação do MCP da BananaCrystal

    Dê ao seu agente de IA 40 ferramentas de pagamento prontas para produção. Consulte saldos, transfira stablecoins, troque moedas e opere com moeda fiduciária: tudo liquidado na Hedera em menos de 5 segundos.

    Obter API keyGitHubnpm
    40
    Ferramentas MCP
    150+
    Moedas
    < 5s
    Liquidação
    0.3%
    Taxa de transferência

    Início rápido

    Coloque seu agente de IA para fazer pagamentos em menos de 5 minutos.

    01

    Instale o servidor MCP

    Instale o servidor MCP da BananaCrystal globalmente via npm.

    npm install -g @bananacrystal/mcp-server
    02

    Obtenha sua API key

    Crie uma API key de MCP no painel da sua conta. As chaves de sandbox começam com bc_test_ e são grátis.

    Obter API key
    Chaves de sandbox: bc_test_...
    03

    Configure o Claude Desktop

    Adicione a BananaCrystal ao arquivo de configuração do Claude Desktop.

    claude_desktop_config.json
    {
  "mcpServers": {
    "bananacrystal": {
      "command": "bananacrystal-mcp",
      "env": {
        "BANANACRYSTAL_API_KEY": "bc_test_your_sandbox_key_here"
      }
    }
  }
}
    04

    Peça ao seu agente

    Agora seu agente tem 40 ferramentas de pagamento. Teste estes prompts:

    ›"Qual é meu saldo atual de USDb?"
    ›"Envie 50 USDb para 0.0.654321"
    ›"Troque 100 USDb por NGNb na cotação atual"
    ›"Mostre minhas últimas 10 transações"
    ›"Qual é a taxa de câmbio atual de USD para NGN?"

    Ferramentas MCP

    40 ferramentas de pagamento prontas para produção em 6 categorias. As operações somente leitura são sempre grátis.

    Somente leitura24 ferramentas
    ping
    read_onlygrátis
    Verificação de saúde: retorna pong
    get_server_info
    read_onlygrátis
    Retorna informações básicas do servidor
    echo
    read_onlygrátis
    Devolve a mensagem de entrada para quem chamou
    get_my_profile
    read_onlygrátis
    Obtém o perfil completo do usuário autenticado
    get_balances
    read_onlygrátis
    Obtém o saldo da conta Hedera para todos os tokens da plataforma ou para um token específico
    get_exchange_rate
    read_onlygrátis
    Obtém as cotações de compra e venda em tempo real de uma moeda
    list_supported_currencies
    read_onlygrátis
    Lista todas as moedas aceitas com suas taxas dinâmicas
    list_available_tokens
    read_onlygrátis
    Lista todos os tokens Hedera disponíveis na plataforma
    get_transaction_history
    read_onlygrátis
    Obtém o histórico de transações por categoria, com filtros
    get_my_limits
    read_onlygrátis
    Obtém os limites configurados e o uso em tempo real da API key autenticada
    estimate_swap_fees
    read_onlygrátis
    Estima as taxas de uma troca de moeda antes de executar
    get_agent_config
    read_onlygrátis
    Consulta a configuração de agente de outro usuário
    check_approval_status
    read_onlygrátis
    Verifica o status de uma solicitação de aprovação de transação de agente pendente
    get_kyc_status
    read_onlygrátis
    Obtém o status da verificação KYC de um usuário via Sumsub
    get_deposit_status
    read_onlygrátis
    Obtém o status de um depósito em moeda fiduciária pelo ID da transferência
    get_withdrawal_status
    read_onlygrátis
    Obtém as solicitações de saque de um usuário via Brale
    get_escrow_balances
    read_onlygrátis
    Obtém o detalhamento do saldo em escrow: valores total, disponível e bloqueado
    get_escrow_history
    read_onlygrátis
    Obtém o histórico completo de transações em escrow, incluindo bloqueios, liberações, ganhos e perdas
    list_offers
    read_onlygrátis
    Navega no mercado de previsões em busca de ofertas ativas com estatísticas de negociação
    get_offer
    read_onlygrátis
    Obtém os detalhes completos de uma oferta, incluindo estatísticas de negociação
    get_my_offers
    read_onlygrátis
    Obtém todas as ofertas criadas por um usuário específico
    list_trades
    read_onlygrátis
    Lista todas as negociações da plataforma, com filtros
    get_trade
    read_onlygrátis
    Obtém os detalhes completos de uma negociação, incluindo estatísticas da oferta de origem
    get_my_trades
    read_onlygrátis
    Obtém todas as negociações de um usuário, criadas e recebidas
    Transferência2 ferramentas
    request_transfer_otp
    transfer0.3%
    Passo 1: solicita um código OTP de verificação enviado ao e-mail de quem envia
    transfer_tokens
    transfer0.3%
    Passo 2: executa a transferência de tokens com verificação OTP
    Troca1 ferramenta
    swap_currency
    swap0.5%
    Troca entre dois tokens Hedera com cotação e taxas calculadas automaticamente
    Moeda fiduciária3 ferramentas
    initiate_kyc
    fiat
    Inicia a verificação KYC: retorna um token de acesso Sumsub para o SDK
    initiate_deposit
    fiat
    Inicia um depósito em moeda fiduciária via Brale (exige KYC)
    request_withdrawal
    fiat
    Solicita um saque em moeda fiduciária via Brale (exige KYC)
    Ofertas e negociações6 ferramentas
    create_offer
    offers
    Cria uma oferta no mercado de previsões que bloqueia o valor total em escrow
    update_offer
    offers
    Edita uma oferta existente (só quando não há negociações)
    delist_offer
    offers
    Retira sua oferta do marketplace e libera o escrow bloqueado
    delete_offer
    offers
    Exclui sua oferta para sempre (bloqueado se houver negociações ativas)
    engage_offer
    offers
    Entra em uma oferta aberta bloqueando o escrow correspondente
    cancel_trade
    offers
    Cancela uma negociação ativa e libera seu escrow bloqueado
    Agente para agente3 ferramentas
    request_agent_transaction
    transfer
    Solicita uma transação em nome do agente de outro usuário (exige aprovação por e-mail)
    execute_approved_transaction
    transfer
    Executa uma transação de agente aprovada antes, usando o token de execução
    update_my_agent_settings
    read_onlygrátis
    Define se transações de agente para agente exigem aprovação por e-mail e OTP
    Só no sandbox1 ferramenta
    reset_sandbox_balance
    read_onlygrátis
    Restaura os saldos do sandbox para os valores iniciais (só no sandbox)

    Rate API

    Operações avançadas de cotação de moedas via REST. Exige uma API key com escopo rate.

    Ferramenta MCP ou Rate API: qual a diferença?

    O servidor MCP já inclui get_exchange_rate como ferramenta read_only: seu agente pode chamá-la direto para obter a cotação de compra e venda de uma moeda em relação ao USD. Isso cobre a maioria dos casos de uso de agentes.

    A Rate API vai além: conversões entre pares cruzados, operações em lote, séries históricas e resumos estatísticos. Esses recursos estão disponíveis como endpoints HTTP diretos, autenticados com uma API key de escopo rate. Crie uma chave rate no painel da sua conta.

    Autenticação

    Todos os endpoints da Rate API exigem uma API key de escopo rate enviada no header x-api-key. Os equivalentes de sandbox ficam em /mcp/sandbox/rate/* e usam sua chave de sandbox (bc_test_...) com cotações simuladas fixas para testes reproduzíveis.

    URL base
    https://agentic.bananacrystal.com/mcp/rate
    GET/mcp/rate/currencies

    Lista todas as moedas aceitas

    Exemplo de requisição

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

    Exemplo de resposta

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

    Obtém a taxa de câmbio atual entre duas moedas

    Parâmetros

    NomeObrigatórioDescrição
    fromobrigatórioCódigo da moeda de origem (ex.: USD)
    toobrigatórioCódigo da moeda de destino (ex.: NGN)

    Exemplo de requisição

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

    Exemplo de resposta

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

    Converte um valor de uma moeda para outra

    Parâmetros

    NomeObrigatórioDescrição
    fromobrigatórioCódigo da moeda de origem
    toobrigatórioCódigo da moeda de destino
    amountobrigatórioValor a converter (número)

    Exemplo de requisição

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

    Exemplo de resposta

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

    Converte vários valores de moeda em uma única requisição (máx. 100)

    Exemplo de requisição

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

    Exemplo de resposta

    [
  { "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/history

    Busca o histórico de taxas de câmbio de um par de moedas

    Parâmetros

    NomeObrigatórioDescrição
    fromobrigatórioCódigo da moeda de origem
    toobrigatórioCódigo da moeda de destino
    startDateobrigatórioData inicial (ISO 8601, ex.: 2026-04-01)
    endDateobrigatórioData final (ISO 8601, ex.: 2026-04-30)

    Exemplo de requisição

    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"

    Exemplo de resposta

    [
  { "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/stats

    Obtém estatísticas de cotação (máxima, mínima, média, mais recente) em um período

    Parâmetros

    NomeObrigatórioDescrição
    fromobrigatórioCódigo da moeda de origem
    toobrigatórioCódigo da moeda de destino
    daysopcionalPeríodo em dias, de 1 a 365 (padrão: 30)

    Exemplo de requisição

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

    Exemplo de resposta

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

    Rate API no sandbox

    Troque /mcp/rate/ por /mcp/sandbox/rate/ e use sua chave de sandbox para obter cotações simuladas fixas. Os dados históricos são gerados com variação de ±2% para testes realistas. Nenhum dado real de câmbio é usado.

    Ambiente sandbox

    Teste sua integração com segurança, com saldos iniciais e sem dinheiro real.

    O que é o sandbox?

    O sandbox é um ambiente de testes totalmente isolado que espelha a produção com exatidão, com as mesmas ferramentas, a mesma API e o mesmo formato de resposta. Nenhum dinheiro real é movimentado. As API keys de sandbox começam com bc_test_ e se conectam à testnet da Hedera.

    Saldos iniciais

    Toda conta sandbox começa com estes saldos. Use reset_sandbox_balance para restaurá-los a qualquer momento.

    TokenValorMoeda
    USDb10,000USD
    NGNb5,000,000NGN
    GHSb50,000GHS
    KESb1,000,000KES
    ZARb150,000ZAR

    Sandbox x produção

    RecursoSandboxProdução
    Movimenta dinheiro realNão: apenas simuladoSim
    Verificação OTPRetornado na resposta da APIEnviado para o seu e-mail
    KYC exigido para moeda fiduciáriaNãoSim
    Limites de gasto aplicadosSim (configurável)Sim
    Prefixo da API keybc_test_...bc_live_...
    Liquidação na HederaTestnetMainnet
    Saldos iniciaisSim (restaure quando quiser)Não
    Limites de requisiçãoFlexíveisPor plano

    OTP no sandbox

    No modo sandbox, o código OTP volta direto na resposta da API request_transfer_otp em vez de ser enviado por e-mail. Isso facilita os testes automatizados sem precisar de acesso ao e-mail.

    Configuração do sandbox

    claude_desktop_config.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"
      }
    }
  }
}

    Configuração

    Conecte a BananaCrystal à sua ferramenta ou framework de IA preferido.

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

    Variáveis de ambiente

    BANANACRYSTAL_API_KEYobrigatório

    Sua API key de MCP. As chaves de sandbox começam com bc_test_, e as de produção com bc_live_.

    Padrão: N/A

    BANANACRYSTAL_API_URLopcional

    Substitui a URL do endpoint MCP. Use a URL do sandbox para testes.

    Padrão: https://agentic.bananacrystal.com/mcp

    DEBUGopcional

    Defina como true para ativar logs detalhados de requisição e resposta.

    Padrão: false

    Integrações com frameworks

    Exemplos prontos para rodar com os frameworks de agentes de IA mais populares.

    langchain_agent.py
    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())

    Qualquer framework compatível com MCP funciona. Se o seu framework aceita servidores MCP via HTTP, aponte para https://agentic.bananacrystal.com/mcp com sua API key como Bearer token.

    Arquitetura de segurança

    Várias camadas de proteção para que seu agente só faça o que você autorizar explicitamente.

    Escopos da API key

    Cada API key tem escopos de permissão explícitos. Um agente só pode fazer operações dentro dos escopos que você conceder.

    Limites de gasto

    Defina máximos fixos por transação e tetos diários móveis de 24 horas por API key. Eles são aplicados na infraestrutura.

    Verificação OTP

    Toda transferência de tokens exige um OTP de 6 dígitos enviado ao seu e-mail cadastrado. O agente não consegue concluir uma transferência sem você informar esse código.

    Limite de requisições

    Tetos por chave e por minuto impedem que agentes descontrolados sobrecarreguem a API. Os limites acompanham o seu plano.

    Trilha de auditoria imutável

    Toda chamada de ferramenta é gravada na camada de consenso da Hedera. As chamadas têm data e hora, são à prova de adulteração e podem ser verificadas publicamente on-chain. O histórico completo de auditoria está disponível via get_transaction_history.

    Fluxo de aprovação de agentes

    Transações de agente para agente podem exigir aprovação humana por e-mail antes da execução. Use update_my_agent_settings para configurar require_human_approval.

    Escopos da API key

    read_only

    Consultar saldos, cotações, histórico e limites sem movimentar fundos

    transfer

    Enviar tokens para outras contas (exige OTP)

    swap

    Trocar entre stablecoins de moedas

    fiat

    Depósitos e saques em moeda fiduciária (exige KYC)

    offers

    Criar e gerenciar ofertas e negociações no mercado de previsões

    rate

    Acessar taxas de câmbio, dados históricos, conversões e estatísticas de cotação

    Preços

    As operações somente leitura são sempre grátis. Pague só pelas transações que movimentam valor.

    Taxas por operação

    Operações somente leitura

    get_balances, get_exchange_rate, list_trades, …

    Grátis

    Transferências de tokens

    transfer_tokens

    0.3%

    Trocas de moeda

    swap_currency

    0.5%

    Depósitos em moeda fiduciária

    initiate_deposit

    Varia conforme o meio

    Saques em moeda fiduciária

    request_withdrawal

    Varia conforme o meio

    Mercado de previsões

    create_offer, engage_offer

    Taxa da plataforma na liquidação

    Planos

    Grátis

    $0operações somente leitura

    Todas as ferramentas somente leitura são sempre grátis. Não precisa de conta para consultar cotações ou saldos.

    • Todas as ferramentas somente leitura grátis para sempre
    • Ambiente sandbox incluso
    • get_balances, get_exchange_rate e mais 22
    • Suporte da comunidade
    • Liquidação na testnet da Hedera
    Obter API key
    Mais popular

    Pago por uso

    Conforme o usosem mensalidade

    Cresça no seu ritmo. Pague só pelo que usar.

    • Chamadas de API ilimitadas
    • 0.3% nas transferências
    • 0.5% nas trocas
    • Meios em moeda fiduciária (varia conforme o método)
    • Suporte por e-mail e prioritário
    • Liquidação na mainnet da Hedera
    • Trilha de auditoria completa
    Obter API key

    Enterprise

    Sob medidafale com a gente

    Descontos por volume, SLAs e infraestrutura dedicada.

    • Faixas de taxa sob medida
    • Endpoint MCP dedicado
    • Garantias de SLA
    • Limites de gasto sob medida
    • Suporte dedicado
    • Opção on-premise
    Falar com vendas

    Perguntas frequentes

    Dúvidas comuns sobre a BananaCrystal e o servidor MCP.

    Pronto para dar uma carteira ao seu agente?

    Crie sua API key e conecte seu agente a 40 ferramentas de pagamento em menos de 5 minutos. As ferramentas somente leitura são sempre grátis.

    Obter API key