io.github.ElToro1855/ozav-mcp-server
Forex, IOF tax, US accounts, stablecoins, and international payments in Brazil.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
ozav-mcp-serverclaude mcp add ozav-mcp-server -- npx -y ozav-mcp-server@1.1.0
{
"mcpServers": {
"ozav-mcp-server": {
"command": "npx",
"args": [
"-y",
"ozav-mcp-server@1.1.0"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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:
{
"mcpServers": {
"ozav": {
"url": "https://mcp.ozav.com.br/mcp"
}
}
}
VS Code
.vscode/mcp.json:
{
"servers": {
"ozav": {
"type": "http",
"url": "https://mcp.ozav.com.br/mcp"
}
}
}
Claude Desktop
claude_desktop_config.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:
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
OZAV — Cambio inteligente via stablecoins.
Sem IOF, sem spread abusivo.
Questions fréquentes
Qu'est-ce que io.github.ElToro1855/ozav-mcp-server ?
Forex, IOF tax, US accounts, stablecoins, and international payments in Brazil.
Comment installer io.github.ElToro1855/ozav-mcp-server ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add ozav-mcp-server -- npx -y ozav-mcp-server@1.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.ElToro1855/ozav-mcp-server ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.ElToro1855/ozav-mcp-server est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.ElToro1855/ozav-mcp-server ?
Il est publié par ElToro1855. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.