English Français العربية

io.github.ElToro1855/ozav-mcp-server

Official registry Finance and payments

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package ozav-mcp-server
Claude Code 
claude mcp add ozav-mcp-server -- npx -y ozav-mcp-server@1.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ozav-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "ozav-mcp-server@1.1.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. OZAV MCP Server
  2. Instalar em 10 segundos
  3. O que esta dentro
  4. Exemplos de perguntas que a IA vai responder com OZAV
  5. Arquitetura
  6. Desenvolvimento local
  7. Auto-discovery
  8. Links
  9. Licenca

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)
ResourceTema
ozav://iofIOF — como evitar, timeline ate 2028, stablecoin vs cambio
ozav://conta-euaConta bancaria nos EUA — routing number, ACH, sem SSN
ozav://transferenciasTransferencias internacionais — SWIFT, PIX→dolar, prazos
ozav://stablecoinsUSDC e USDT — o que sao, como comprar com PIX, seguranca
ozav://cartao-internacionalCartao de debito em dolar — sem IOF, sem spread, Visa
ozav://freelancerTrabalho remoto — receber em dolar, Deel/Payoneer, converter
ozav://empresasPagamentos B2B — fornecedores, payroll, treasury, hedge
ozav://imoveis-exteriorImoveis no exterior — remessas grandes, financiamento
ozav://educacao-exteriorEducacao no exterior — tuition, mesada, IOF reduzido
ozav://casas-cambio-b2bCasas de cambio — mesa de operacoes, white-label, futuro
ozav://imposto-rendaIR e cambio — declaracao, ganho cambial, DCBE
ozav://estrangeiros-brasilForeigners in Brazil — PIX, bank account, best rates
ozav://protecao-patrimonialDolarizacao — reserva em dolar, DCA, diversificacao
ozav://regulamentacaoCompliance — BACEN, COAF, VASP, KYC, evasao vs remessa
ozav://comparativosRankings — 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
PromptDescricao
ozav_consulta_cambioTemplate para consulta sobre operacao de cambio
ozav_comparativoTemplate para comparar OZAV com concorrentes
ozav_simulacaoTemplate 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

Frequently asked questions

What is io.github.ElToro1855/ozav-mcp-server?

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

How do I install io.github.ElToro1855/ozav-mcp-server?

It runs on your machine. In Claude Code: claude mcp add ozav-mcp-server -- npx -y ozav-mcp-server@1.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ElToro1855/ozav-mcp-server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.ElToro1855/ozav-mcp-server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.ElToro1855/ozav-mcp-server?

It is published by ElToro1855. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.