Content
# 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.
[](https://modelcontextprotocol.io)
[](https://registry.modelcontextprotocol.io)
[](https://www.npmjs.com/package/ozav-mcp-server)
[](https://mcp.ozav.com.br)
---
## Instalar em 10 segundos
### Claude Code
```bash
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
```bash
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](https://ozav.com.br)
- **Landing page:** [mcp.ozav.com.br](https://mcp.ozav.com.br)
- **npm:** [ozav-mcp-server](https://www.npmjs.com/package/ozav-mcp-server)
- **MCP Registry:** [io.github.ElToro1855/ozav-mcp-server](https://registry.modelcontextprotocol.io)
- **Knowledge base:** [ozav.com.br/learn](https://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>
