io.github.ElToro1855/ozav-mcp-server
Forex, IOF tax, US accounts, stablecoins, and international payments in Brazil.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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.
الأسئلة الشائعة
ما هو io.github.ElToro1855/ozav-mcp-server؟
Forex, IOF tax, US accounts, stablecoins, and international payments in Brazil.
كيف أثبّت io.github.ElToro1855/ozav-mcp-server؟
يعمل على جهازك. في Claude Code: claude mcp add ozav-mcp-server -- npx -y ozav-mcp-server@1.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.ElToro1855/ozav-mcp-server إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل io.github.ElToro1855/ozav-mcp-server مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.ElToro1855/ozav-mcp-server؟
ينشره ElToro1855. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.