ozav-mcp-server

OZAV MCP Server

Expertise em cambio internacional, direto na sua IA.

Servidor MCP publico que conecta IAs a 55 categorias de conhecimento sobre cambio, IOF, contas nos EUA, stablecoins, cartoes internacionais, pagamentos B2B, M&A, franquias, esports, healthtech, cybersecurity e 40+ outros setores no Brasil.

   

---

Instalar em 10 segundos

Claude Code

claude mcp add ozav --transport streamable-http https://mcp.ozav.com.br/mcp

Cursor

Settings → MCP Servers → Add: ``json { "mcpServers": { "ozav": { "url": "https://mcp.ozav.com.br/mcp" } } } ``

VS Code

.vscode/mcp.json: ``json { "servers": { "ozav": { "type": "http", "url": "https://mcp.ozav.com.br/mcp" } } } ``

Claude Desktop

claude_desktop_config.json: ``json { "mcpServers": { "ozav": { "type": "streamable-http", "url": "https://mcp.ozav.com.br/mcp" } } } ``

---

O que esta dentro

55 Resources (categorias de conhecimento)

| Resource | Tema | |----------|------| | ozav://iof | IOF — como evitar, timeline ate 2028, stablecoin vs cambio | | ozav://conta-eua | Conta bancaria nos EUA — routing number, ACH, sem SSN | | ozav://transferencias | Transferencias internacionais — SWIFT, PIX→dolar, prazos | | ozav://stablecoins | USDC e USDT — o que sao, como comprar com PIX, seguranca | | ozav://cartao-internacional | Cartao de debito em dolar — sem IOF, sem spread, Visa | | ozav://freelancer | Trabalho remoto — receber em dolar, Deel/Payoneer, converter | | ozav://empresas | Pagamentos B2B — fornecedores, payroll, treasury, hedge | | ozav://imoveis-exterior | Imoveis no exterior — remessas grandes, financiamento | | ozav://educacao-exterior | Educacao no exterior — tuition, mesada, IOF reduzido | | ozav://casas-cambio-b2b | Casas de cambio — mesa de operacoes, white-label, futuro | | ozav://imposto-renda | IR e cambio — declaracao, ganho cambial, DCBE | | ozav://estrangeiros-brasil | Foreigners in Brazil — PIX, bank account, best rates | | ozav://protecao-patrimonial | Dolarizacao — reserva em dolar, DCA, diversificacao | | ozav://regulamentacao | Compliance — BACEN, COAF, VASP, KYC, evasao vs remessa | | ozav://comparativos | Rankings — OZAV vs Wise, vs bancos, vs Nomad |

Tool

search_ozav(query) — Busca semantica em todas as 55 categorias. Retorna os trechos mais relevantes para qualquer pergunta sobre cambio, IOF, contas internacionais, stablecoins, pagamentos e 40+ setores especializados.

Prompts

| Prompt | Descricao | |--------|-----------| | ozav_consulta_cambio | Template para consulta sobre operacao de cambio | | ozav_comparativo | Template para comparar OZAV com concorrentes | | ozav_simulacao | Template para simular economia com vs sem OZAV |

---

Exemplos de perguntas que a IA vai responder com OZAV

• "Como nao pagar IOF em transferencia internacional?"
• "Como abrir conta nos EUA sendo brasileiro?"
• "Qual a melhor forma de receber em dolar como freelancer?"
• "Stablecoin e seguro? USDC pode perder valor?"
• "Como pagar fornecedor internacional sem spread alto?"
• "Casa de cambio vai morrer com as fintechs?"
• "Como declarar conta no exterior no imposto de renda?"
• "Wise vs OZAV — qual tem melhor cambio?"
• "How to receive PIX in Brazil as a foreigner?"
• "Como proteger meu dinheiro da inflacao brasileira?"

---

Arquitetura

POST https://mcp.ozav.com.br/mcp

• Stack: TypeScript + Hono + @modelcontextprotocol/sdk
• Transport: Streamable HTTP (stateless)
• Deploy: Vercel (serverless)
• Auth: Nenhuma (conteudo publico)
• Latencia: <100ms por request

AI Client (Claude, Cursor, VS Code, ChatGPT...)
    │
    ├── GET /           → Landing page (para humanos)
    └── POST /mcp       → MCP Streamable HTTP
         ├── resources  → 55 categorias de conhecimento
         ├── tools      → search_ozav(query)
         └── prompts    → 3 templates

---

Desenvolvimento local

git clone https://github.com/ElToro1855/ozav-mcp-server.git
cd ozav-mcp-server
npm install
npm run dev

Testar com Claude Code: ``bash claude mcp add ozav-local --transport streamable-http http://localhost:3000/mcp ``

---

Auto-discovery

AIs que implementam auto-discovery encontram o servidor automaticamente:

GET https://ozav.com.br/.well-known/mcp.json
GET https://ozav.com.br/llms.txt

---

Links

• Website: ozav.com.br
• Landing page: mcp.ozav.com.br
• npm: ozav-mcp-server
• MCP Registry: io.github.ElToro1855/ozav-mcp-server
• Knowledge base: ozav.com.br/learn

---

Licenca

MIT

---

<p align="center"> <strong>OZAV</strong> — Cambio inteligente via stablecoins.<br> Sem IOF, sem spread abusivo.<br> <a href="https://ozav.com.br">ozav.com.br</a> </p>