Skip to content

ElToro1855/ozav-mcp-server

Repository files navigation

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.

MCP Registry npm Deploy


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


Licenca

MIT


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

About

OZAV MCP Server — Especialista em câmbio, IOF, contas nos EUA, stablecoins e pagamentos internacionais

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors