io.github.ElToro1855/ozav-mcp-server
Forex, IOF tax, US accounts, stablecoins, and international payments in Brazil.
Open source Open in the app JSON README (API)
About
Forex, IOF tax, US accounts, stablecoins, and international payments in Brazil.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- eltoro1855
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.1.0
- Stars
- 1
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-04-05T05:33:23Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:50
- Updated
- 2026-08-29 03:01:50
- Origin id
io.github.ElToro1855/ozav-mcp-server
README
# 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>