rtc-calculadora-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RTC_URL | No | The URL of the official RTC calculator API. Defaults to http://localhost:8080/api/calculadora. | http://localhost:8080/api/calculadora |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Ferramentas sobre a calculadora oficial da Reforma Tributaria do Consumo (LC 214/2025), publicada pela Receita Federal. Use-as em vez de calcular CBS, IBS ou Imposto Seletivo de cabeca.
calcular_tributos: calcula uma operacao (itens com NCM ou NBS, CST, cClassTrib e base de calculo). Em 2026 a calculadora usa as aliquotas de referencia oficiais; a partir de 2027 as aliquotas sao obrigatorias em
aliquotasNominaisde cada item.Antes de calcular um item com cClassTrib desconhecido, consulte consultar_classificacao_tributaria e verificar_enquadramento.
Os valores devolvidos sao os da calculadora; repasse-os sem recalcular nem arredondar de novo.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| calcular_tributosA | Calcula CBS, IBS (UF e municipio) e Imposto Seletivo de uma operacao com a calculadora oficial.
Por padrao (estrito=false) cada item e calculado de forma independente: itens com erro vem com
|
| descrever_erroB | Explica um codigo de erro da calculadora (ex.: REG-011), como os que aparecem em |
| consultar_classificacao_tributariaC | Le na tabela oficial uma classificacao tributaria (cClassTrib, 6 digitos) vigente na data: descricao, tratamento (ex.: "Aliquota reduzida em 60%"), percentuais de reducao de CBS/IBS, nomenclatura exigida (NCM ou NBS) e documentos fiscais em que pode ser usada. |
| listar_situacoes_tributariasB | Lista os CST oficiais vigentes na data com suas classificacoes tributarias (cClassTrib).
Informe |
| consultar_nomenclaturaA | Consulta um codigo NCM (mercadoria) ou NBS (servico) na tabela oficial vigente na data. Para NCM informa tambem se o produto e tributado pelo Imposto Seletivo. |
| verificar_enquadramentoB | Diz se um NCM ou NBS pode ser usado com a classificacao tributaria (cClassTrib) na data. Um par invalido faz o calculo do item falhar com REG-011. |
| consultar_aliquota_referenciaA | Aliquota de referencia oficial (%): uniao = CBS, uf = IBS estadual, municipio = IBS municipal.
|
| gerar_xml_grupoB | Calcula a operacao em modo estrito e gera o XML oficial dos grupos de tributacao
(IBSCBS/IS por item e totais) para o documento |
| validar_xmlA | Valida um XML contra o XSD oficial. subtipo="grupo" valida so os grupos de tributacao (como os de gerar_xml_grupo); "nota" valida o documento inteiro. Devolve "valido" ou o erro com linha e coluna. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool maps to a distinct action (describe error, look up classification, list CSTs, look up NCM/NBS, verify pairing, look up rates, generate XML, validate XML, calculate). There is some overlap: listar_situacoes_tributarias also returns cClassTrib values that consultar_classificacao_tributaria looks up individually, and gerar_xml_grupo recalculates using the same 'operacao' contract as calcular_tributos. The descriptions clarify the boundaries (one returns XML, one returns computed fields), so an agent can still pick correctly.
All nine tools use consistent snake_case Portuguese verb_noun names (consultar_*, listar_*, verificar_*, gerar_*, validar_*, calcular_*, descrever_*). No mixed conventions or casing. The pattern is predictable across the whole set.
Nine tools is well within a comfortable scope and each one covers a distinct step of the workflow (discover classifications, check validity, calculate, generate and validate XML). Nothing feels redundant or missing at the count level.
The surface covers the full calculation lifecycle: lookup of CST/cClassTrib, NCM/NBS, reference rates, pairing validation, calculation, XML generation and XSD validation, plus error decoding. Minor gaps remain: there is no lookup or search of NCM/NBS by description (only by code), and validar_xml can validate a whole nota while no tool generates the full nota XML—only the tributacao groups.