📦

io.github.ElToro1855/ozav-mcp-server

Forex, IOF tax, US accounts, stablecoins, and international payments in Brazil.

0 installs

Trust: 37 — Low

Blockchain

Ask AI about io.github.ElToro1855/ozav-mcp-server

I know everything about io.github.ElToro1855/ozav-mcp-server. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Loading tools...

Reviews

Documentation

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

Licenca

MIT

OZAV — Cambio inteligente via stablecoins.
Sem IOF, sem spread abusivo.
ozav.com.br