calcular_margem_contribuicao
Calcula a Margem de Contribuição (MC) e uma DRE (Demonstração de Resultado) simplificada. Margem de Contribuição = Receita Líquida − Custos Variáveis. MC% = MC / Receita Líquida × 100 — percentual que cada R$1 de receita contribui para cobrir custos fixos. Quando custosFixos informado: Resultado ...
This record as markdown: /tools/io-github-lfhillesheim-contai-mcp-server/calcular-margem-contribuicao.md
What calcular_margem_contribuicao does on Contaí — Calculadoras Fiscais Brasileiras
AI agents call calcular_margem_contribuicao to retrieve information from Contaí — Calculadoras Fiscais Brasileiras without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
deducoesCents | integer | — | Total de deduções da receita bruta em centavos (impostos sobre faturamento, devoluções, descontos). Receita Líquida = Receita Bruta − Deduções. Default: 0. Ex: |
custosFixosCents | integer | — | Total de custos fixos do período em centavos (aluguel, salários, contador). Quando informado, calcula o resultado operacional e o ponto de equilíbrio. Default: |
receitaBrutaCents | integer | Yes | Receita bruta total do período em centavos (faturamento antes de deduções). Ex: R$ 50.000 → 5000000 |
custosVariaveisCents | integer | Yes | Total agregado de custos variáveis em centavos (matéria-prima, comissão de vendas, frete). Ignorado quando "custosVariaveisDetalhados" tem itens. Devem ser meno |
custosVariaveisDetalhados | array | — | Custos variáveis detalhados por categoria (materia_prima, frete_logistica, marketing, mao_de_obra, software_assinaturas, outro). Cada item: { categoria, valorCe |
Parameters from the server's own tool schema.
Why calcular_margem_contribuicao is rated Low
This tool retrieves or computes derived financial metrics from provided inputs (revenue, variable costs, fixed costs) without modifying, creating, deleting, or persisting data. It is purely computational and analytical—similar to a calculator or query that returns read-only analysis. No side effects, reversible operations, or irreversible actions are performed.
From the tool's definition Tool performs financial calculations and analysis: 'Calcula a Margem de Contribuição (MC) e uma DRE (Demonstração de Resultado) simplificada' with formulas like 'MC = Receita Líquida − Custos Variáveis' and 'MC% = MC / Receita Líquida × 100'.
Attacks that exploit this kind of access
The rule that runs calcular_margem_contribuicao safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Contaí — Calculadoras Fiscais Brasileiras, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For calcular_margem_contribuicao, this is the rule to start with:
calcular_margem_contribuicao is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect Contaí — Calculadoras Fiscais Brasileiras, apply this rule, and every calcular_margem_contribuicao call is checked against it from then on.
Questions about calcular_margem_contribuicao
Calcula a Margem de Contribuição (MC) e uma DRE (Demonstração de Resultado) simplificada. Margem de Contribuição = Receita Líquida − Custos Variáveis. MC% = MC / Receita Líquida × 100 — percentual que cada R$1 de receita contribui para cobrir custos fixos. Quando custosFixos informado: Resultado Operacional = MC − Custos Fixos; Ponto de Equilíbrio = Custos Fixos / MC%; Folga = receita atual − PE. Custos variáveis podem ser informados como total agregado OU como array categorizado (custosVariaveisDetalhados). It is categorised as a Read tool in the Contaí — Calculadoras Fiscais Brasileiras MCP Server, which means it retrieves data without modifying state.
calcular_margem_contribuicao accepts 5 parameters: deducoesCents, custosFixosCents, receitaBrutaCents, custosVariaveisCents, custosVariaveisDetalhados. Required: receitaBrutaCents, custosVariaveisCents. The full parameter table on this page comes from the server's own tool schema.
Register the Contaí — Calculadoras Fiscais Brasileiras MCP server in PolicyLayer and add a rule for calcular_margem_contribuicao: 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.
calcular_margem_contribuicao is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the calcular_margem_contribuicao 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.
Set action: deny in the PolicyLayer policy for calcular_margem_contribuicao. 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.
calcular_margem_contribuicao 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.
More on Contaí — Calculadoras Fiscais Brasileiras, and thousands of servers like it.
Across the catalogue