calcular_custo_total_veiculo_tco

Calcula o TCO (Total Cost of Ownership / Custo Total de Propriedade) de um veículo. Soma todos os custos anuais: depreciação (curva exponencial), IPVA, seguro, combustível, manutenção e financiamento. Revela o custo real além da parcela mensal. Calcula custo por km rodado e TCO acumulado no perío...

Server Contaí — Calculadoras Fiscais Brasileiras @contai-evoluke/mcp-server
Category Read
Risk class Low
Parameters 112 required

What calcular_custo_total_veiculo_tco does on Contaí — Calculadoras Fiscais Brasileiras

AI agents call calcular_custo_total_veiculo_tco to retrieve information from Contaí — Calculadoras Fiscais Brasileiras without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

ParameterTypeRequiredDescription
anosTco integer Horizonte de análise do TCO em anos (1 a 10). Define o período total de custo calculado. Default: 5
kmAnuais integer Quilômetros rodados por ano (1.000 a 200.000). Default: 15.000 km/ano
tipoVeiculo string Yes Tipo do veículo, que define a taxa de depreciação e manutenção estimada: "carro_popular" (depr 12%, manu 4%), "carro_medio" (depr 10%, manu 5%), "carro_premium"
seguroAnualCents integer Prêmio anual do seguro em centavos. Ex: R$ 3.000 → 300000. Default: 300000 (R$ 3.000)
consumoKmPorLitro number Consumo médio do veículo em km por litro (3 a 30). Ex: 12 = 12 km/L. Default: 12
valorVeiculoCents integer Yes Valor de mercado atual do veículo em centavos. Ex: R$ 50.000 → 5000000
ipvaAliquotaPercent number Alíquota do IPVA em % (0 a 5). Varia por estado: SP 4%, MG 4%, RJ 4%, outros 1-4%. Default: 2%
manutencaoAnualCents integer Manutenção anual em centavos (peças + mão de obra). Se omitido, usa estimativa padrão por tipo de veículo (4-7% do valor). Ex: R$ 2.000 → 200000
parcelaFinanciamentoCents integer Parcela mensal de financiamento em centavos (0 se veículo quitado). Ex: R$ 800/mês → 80000. Default: 0
custosObrigatoriosAnuaisCents array Custos obrigatórios anualizados (DPVAT, licenciamento, emplacamento, taxa de cadastro do financiamento, seguro prestamista, transferência de propriedade, outro)
precoCombustivelCentsPorLitro integer Preço do combustível por litro em centavos (máx. R$ 20,00 = 2000). Ex: R$ 6,00/L → 600. Default: 600

Parameters from the server's own tool schema.

Why calcular_custo_total_veiculo_tco needs a policy

This is a financial calculator/analyzer that takes vehicle parameters as input and returns computed metrics (annual costs, per-km cost, accumulated TCO). It retrieves or derives values through mathematical formulae but does not create, modify, delete data, execute external commands, or move money. The output is informational analysis only.

From the tool's definition Tool performs calculation of vehicle total cost of ownership (TCO) by summing depreciatory, tax, insurance, fuel, maintenance, and financing costs. No description indicates modification, deletion, execution of external operations, or financial transactions.

Risk signalsHigh parameter count (14 properties)

Questions about calcular_custo_total_veiculo_tco

What does the calcular_custo_total_veiculo_tco tool do? +

Calcula o TCO (Total Cost of Ownership / Custo Total de Propriedade) de um veículo. Soma todos os custos anuais: depreciação (curva exponencial), IPVA, seguro, combustível, manutenção e financiamento. Revela o custo real além da parcela mensal. Calcula custo por km rodado e TCO acumulado no período de análise. Depreciação varia ano a ano (exponencial); demais custos são constantes por ano. Manutenção pode ser informada ou estimada automaticamente (4-7% do valor do veículo por ano). It is categorised as a Read tool in the Contaí — Calculadoras Fiscais Brasileiras MCP Server, which means it retrieves data without modifying state.

What parameters does calcular_custo_total_veiculo_tco accept? +

calcular_custo_total_veiculo_tco accepts 11 parameters: anosTco, kmAnuais, tipoVeiculo, seguroAnualCents, consumoKmPorLitro, valorVeiculoCents, ipvaAliquotaPercent, manutencaoAnualCents, parcelaFinanciamentoCents, custosObrigatoriosAnuaisCents, precoCombustivelCentsPorLitro. Required: tipoVeiculo, valorVeiculoCents. The full parameter table on this page comes from the server's own tool schema.

How do I enforce a policy on calcular_custo_total_veiculo_tco? +

Register the Contaí — Calculadoras Fiscais Brasileiras MCP server in PolicyLayer and add a rule for calcular_custo_total_veiculo_tco: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Contaí — Calculadoras Fiscais Brasileiras. Nothing to install.

What risk level is calcular_custo_total_veiculo_tco? +

calcular_custo_total_veiculo_tco is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit calcular_custo_total_veiculo_tco? +

Yes. Add a rate_limit block to the calcular_custo_total_veiculo_tco rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block calcular_custo_total_veiculo_tco completely? +

Set action: deny in the PolicyLayer policy for calcular_custo_total_veiculo_tco. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides calcular_custo_total_veiculo_tco? +

calcular_custo_total_veiculo_tco is provided by the Contaí — Calculadoras Fiscais Brasileiras MCP server (@contai-evoluke/mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.