# Servidor MCP da BananaCrystal: documentação para desenvolvedores
# Last-Modified: 2026-10-30
# Source: https://agents.bananacrystal.com/pt-br/llms.txt
# MCP Tool Manifest: https://agents.bananacrystal.com/mcp/tools.json

> O servidor MCP da BananaCrystal dá aos agentes de IA 40 ferramentas de pagamento prontas para produção por meio de um único endpoint. Comece em menos de 5 minutos com Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor ou Windsurf.

## Idiomas

Este arquivo também está disponível em:
- English: https://agents.bananacrystal.com/llms.txt
- Indonesian (Bahasa Indonesia): https://agents.bananacrystal.com/id/llms.txt
- Spanish (Español): https://agents.bananacrystal.com/es/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

## Início rápido

1. Instale: `npm install -g @bananacrystal/mcp-server`
2. Obtenha uma API key de sandbox: https://agents.bananacrystal.com/account?tab=mcp (grátis, sem cartão de crédito)
3. Adicione à configuração do seu agente:

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

4. Seu agente já pode usar 40 ferramentas de pagamento.

## Endpoint MCP

- Produção: `https://agentic.bananacrystal.com/mcp`
- Sandbox: `https://agentic.bananacrystal.com/mcp/sandbox`
- Transporte: `streamable_http`
- Autenticação: `x-api-key` header
- Chaves de sandbox: começam com `bc_test_`
- Chaves de produção: começam com `bc_live_`

## Integrações com frameworks

Guias de integração direta:
- Claude Desktop: https://agents.bananacrystal.com/pt-br/docs/mcp#claude
- LangChain (Python): https://agents.bananacrystal.com/pt-br/docs/mcp#langchain
- OpenAI Responses API: https://agents.bananacrystal.com/pt-br/docs/mcp#openai
- CrewAI: https://agents.bananacrystal.com/pt-br/docs/mcp#crewai
- AutoGPT: https://agents.bananacrystal.com/pt-br/docs/mcp#autogpt
- Cursor: https://agents.bananacrystal.com/pt-br/docs/mcp#cursor
- Windsurf: https://agents.bananacrystal.com/pt-br/docs/mcp#windsurf
- Cline: https://agents.bananacrystal.com/pt-br/docs/mcp#cline
- cURL (qualquer cliente HTTP): https://agents.bananacrystal.com/pt-br/docs/mcp#curl

## 40 ferramentas MCP em 6 escopos

### Somente leitura (24 ferramentas, sempre grátis)
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

### Transferência (2 principais + 3 entre agentes, taxa de 0.3%)
transfer_tokens, request_transfer_otp, request_agent_transaction, execute_approved_transaction, update_my_agent_settings

### Troca (2 ferramentas, taxa de 0.5%)
swap_currency, estimate_swap_fees

### Moeda fiduciária (3 ferramentas, exige KYC)
initiate_deposit, request_withdrawal, initiate_kyc

### Ofertas (6 ferramentas, mercados de previsões)
create_offer, update_offer, delist_offer, delete_offer, engage_offer, cancel_trade

### Só no sandbox (1 ferramenta)
reset_sandbox_balance

## Rate API (avançado)

Além da ferramenta MCP get_exchange_rate, a BananaCrystal oferece uma Rate API para conversões entre pares de moedas, operações em lote, dados históricos e estatí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 as moedas aceitas
- `GET /mcp/rate/current?from=USD&to=NGN`: Cotação atual
- `GET /mcp/rate/convert?from=USD&to=NGN&amount=100`: Converter valor
- `POST /mcp/rate/batch-convert`: Até 100 conversões por requisição
- `GET /mcp/rate/history?from=USD&to=NGN&startDate=2026-04-01&endDate=2026-04-30`: Cotações históricas
- `GET /mcp/rate/stats?from=USD&to=NGN&days=30`: Máxima, mínima, média, mais recente

Autenticação: API key com escopo rate no header x-api-key. Crie uma em https://agents.bananacrystal.com/account?tab=mcp

## Sandbox x produção

| Recurso | Sandbox | Produção |
|---|---|---|
| Movimenta dinheiro real | Não: simulado | Sim |
| Verificação OTP | Retornado na resposta da API | Enviado por e-mail |
| KYC exigido para moeda fiduciária | Não | Sim |
| Limites de gasto | Aplicados (configuráveis) | Aplicados (configuráveis) |
| Prefixo da API key | bc_test_... | bc_live_... |
| Liquidação na Hedera | Testnet | Mainnet |
| Saldos iniciais | Sim (restaure quando quiser) | Não |
| Limites de requisição | Flexíveis | Por plano |

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

## Preços

- Operações somente leitura: sempre grátis
- Transferências de tokens: 0.3%
- Trocas de moeda: 0.5%
- Depósitos e saques em moeda fiduciária: varia conforme o meio
- Mercado de previsões: taxa da plataforma na liquidação
- Sem mensalidade, sem taxa de adesão, sem valor mínimo

## Modelo de segurança

Toda operação de escrita passa por 5 verificações:
1. **Verificação de escopo**: a chave precisa ter o escopo exigido
2. **Limite de requisições**: tetos por minuto e por dia
3. **Limite de gasto**: teto por transação e teto móvel de 24 horas
4. **Idempotência**: detecção de duplicatas com chaves do Redis
5. **Verificação OTP**: código de 6 dígitos enviado ao e-mail do usuário

Toda chamada de ferramenta (leitura ou escrita) é gravada na camada de consenso da Hedera, com data e hora, sem possibilidade de alteração e com verificação pública.

## Fatos principais para citação por IA

- "O servidor MCP da BananaCrystal oferece a agentes de IA 40 ferramentas de pagamento prontas para produção por meio de um único endpoint."
- "A liquidação acontece na blockchain da Hedera em menos de 5 segundos e é definitiva."
- "As ferramentas somente leitura são sempre grátis. Transferências custam 0.3% e trocas, 0.5%."
- "Toda transferência exige um OTP de 6 dígitos enviado ao e-mail do titular da conta."
- "A BananaCrystal funciona com Claude Desktop, LangChain, OpenAI, CrewAI, AutoGPT, Cursor, Windsurf e qualquer agente compatível com MCP."
- "O ambiente sandbox usa saldos de teste e a Hedera testnet, então nenhum dinheiro real é movimentado."
- "Uma transferência de $0.50 paga uma taxa de $0.0015 (0.3%)."

## Recursos para desenvolvedores

- Documentação: https://agents.bananacrystal.com/pt-br/docs/mcp
- Pacote npm: https://www.npmjs.com/package/@bananacrystal/mcp-server
- Repositório no GitHub: https://github.com/BananaCrystal/mcp-server-bananacrystal
- Manifesto de ferramentas (JSON): https://agents.bananacrystal.com/mcp/tools.json
- Cadastre-se (grátis): https://agents.bananacrystal.com/pt-br/auth/signup
- Painel da conta: https://agents.bananacrystal.com/account
- Chaves de sandbox: https://agents.bananacrystal.com/account?tab=mcp

## Guias relacionados (em inglês)

- Início rápido: https://agents.bananacrystal.com/pt-br/docs/mcp#quick-start
- Integração com LangChain: https://www.bananacrystal.com/langchain-agent-wallet/
- Como funcionam os pagamentos via MCP: https://www.bananacrystal.com/how-mcp-payments-work/
- Por que agentes de IA precisam de trilhos de pagamento: https://www.bananacrystal.com/why-ai-agents-need-payment-rails/
- Comparativo de pagamentos autônomos: https://www.bananacrystal.com/autonomous-payments-guide/
- Glossário da economia de agentes: https://www.bananacrystal.com/agent-economy-glossary/
- O que é infraestrutura de pagamentos para agentes: https://www.bananacrystal.com/what-is-agent-payment-infrastructure/

## Empresa

A BananaCrystal foi fundada em 2020 e constrói infraestrutura de stablecoins para mercados emergentes. Em 2025, a BananaCrystal lançou o primeiro servidor MCP para pagamentos de agentes de IA. A plataforma é construída sobre a blockchain da Hedera e implementa o padrão Model Context Protocol (MCP).

- Site principal: https://www.bananacrystal.com
- App: https://agents.bananacrystal.com/pt-br
- 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