Skip to main content
Glama
rtc-calculadora-mcp

rtc-calculadora-mcp

by tmoreiradev

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
RTC_URLNoThe 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 aliquotasNominais de 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
calcular_tributosA

Calcula CBS, IBS (UF e municipio) e Imposto Seletivo de uma operacao com a calculadora oficial.

operacao segue o contrato de POST /regime-geral da calculadora: {"dhFatoGerador": "2027-03-10T10:00:00-03:00", "municipio": 4314902 (codigo IBGE), "uf": "RS", "itens": [{"numero": 1, "ncm": "10063021" (ou "nbs" para servicos), "cst": "200", "cClassTrib": "200003", "baseCalculo": 100.00, "quantidade": 20, "unidade": "KG", "aliquotasNominais": {"cbs": 8.8, "ibsEstadual": 0.05, "ibsMunicipal": 0.05}, "impostoSeletivo": {"cst": "000", "cClassTrib": "000001", "baseCalculo": 150.00, "quantidade": 12, "unidade": "LT", "impostoInformado": 15.00}}]} aliquotasNominais e proibido antes de 2027 e obrigatorio a partir de 2027 (valores em %). id e versao sao preenchidos se faltarem.

Por padrao (estrito=false) cada item e calculado de forma independente: itens com erro vem com estadoItem = INCONSISTENCIA_ENTRADA e a lista erros, e os totais somam so os itens calculados. Com estrito=true a operacao inteira falha no primeiro erro. Campos do resultado: vBC (base), pCBS/pIBSUF/pIBSMun (aliquotas %), gRed.pAliqEfet (aliquota efetiva apos reducao), vCBS, vIBSUF, vIBSMun, vIBS, e no grupo IS: vBCIS, pIS, vIS.

descrever_erroB

Explica um codigo de erro da calculadora (ex.: REG-011), como os que aparecem em erros[].code.

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 cst (ex.: "200") para receber so as classificacoes daquele CST.

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. codigo_ibge e o codigo da UF (ex.: 43) ou do municipio (ex.: 4314902). A tabela oficial so tem aliquotas para 2026; a partir de 2027 a consulta falha e as aliquotas vao em aliquotasNominais.

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 tipo. Mesmo formato de operacao de calcular_tributos.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 9 tools

Disambiguation4/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues