calculadora-rtc
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RTC_HOME | No | Pasta do log e do diretório temporário do Java. | ~/.calculadora-rtc |
| RTC_NOTIFY | No | Mostra avisos do Windows ao conectar, quando a API fica pronta e em caso de falha. | 1 |
| RTC_API_DIR | No | Pasta do projeto da API. | ../calculadora-rtc-regime-regular |
| RTC_BASE_URL | No | URL base da API. | http://localhost:8080/api |
| RTC_AUTOSTART | No | Sobe a API Java sozinho quando ela está parada (só para URL local). | 1 |
| RTC_JAVA_HOME | No | JDK a usar (senão JAVA_HOME, as instalações em Program Files e o PATH). | |
| RTC_MAX_RESULTS | No | Máximo de resultados nos endpoints. | 100 |
| RTC_HTTP_TIMEOUT | No | Timeout em segundos. | 60 |
| RTC_STOP_ON_EXIT | No | Encerra a API iniciada pelo MCP quando o Claude desconecta. | 1 |
| RTC_STARTUP_TIMEOUT | No | Segundos de espera pela API subir. | 180 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
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
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| calcular_tributosA | Calcula CBS, IBS (estadual e municipal) e Imposto Seletivo de uma operação do regime geral. Usa o endpoint de observabilidade: cada item é calculado de forma independente e, se um item
tiver erro de entrada, os demais ainda são calculados (o item com problema vem com
estadoItem=INCONSISTENCIA_ENTRADA e a lista de erros). Use Dicas antes de calcular:
Args: municipio: Código IBGE do município da operação (7 dígitos), ex: 4314902 (Porto Alegre). itens: Itens da operação. dh_fato_gerador: Data/hora do fato gerador ISO 8601 com fuso, ex: '2027-03-10T10:00:00-03:00'. Se omitido, usa agora. uf: Sigla da UF, ex: 'RS'. tp_doc: Modelo do DF-e de origem (55=NF-e, 65=NFC-e, ...). compra_governamental: Preencha apenas em compras governamentais. |
| explicar_erroA | Retorna a descrição de um código de erro devolvido pelo cálculo (ex: 'REG-011', 'CAL-001', 'VAL-001'). |
| calcular_base_calculo_unificadaB | Calcula a base de cálculo unificada de CBS/IBS da NF-e/NFC-e a partir dos componentes do item. Mostra o que soma e o que é deduzido (PIS/COFINS, ICMS, ISSQN etc. conforme o ano de transição). Args: ano_fato_gerador: Ano do fato gerador, ex: 2026. natureza: 'bem' ou 'servico'. tipo_documento: Modelo do documento (55=NF-e, 65=NFC-e). vProd..vISSQN: Valores dos componentes (informe só os que existirem). |
| listar_situacoes_tributariasA | Lista os CSTs de CBS/IBS, cada um com as cClassTrib vinculadas (código e descrição). Bom ponto de partida para escolher CST + cClassTrib de uma operação. Args:
data: Data do fato gerador (yyyy-MM-dd). Padrão: hoje.
sigla_dfe: Filtra pelo DF-e (ex: 'NFE', 'NFCE', 'NFSE'). Veja |
| buscar_classificacao_tributariaA | Consulta classificações tributárias (cClassTrib) de CBS/IBS. Escolhe a consulta conforme os filtros informados:
Args: data: Data do fato gerador (yyyy-MM-dd). Padrão: hoje. c_class_trib: Código da cClassTrib (6 dígitos). cst: Código do CST (3 dígitos). sigla_dfe: Sigla do DF-e (ex: 'NFE', 'NFCE', 'NFSE'). fornecedor: ATOR_ID do fornecedor. adquirente: ATOR_ID do adquirente. busca: Texto para filtrar por código/descrição (listas). limite: Máximo de itens retornados em listas (padrão 50). |
| validar_nomenclatura_aplicavelA | Valida se uma NCM (mercadoria) ou NBS (serviço) é compatível com a cClassTrib na data. Informe |
| consultar_ncmA | Consulta uma NCM (8 dígitos, sem pontos): descrição hierárquica e se é tributada pelo Imposto Seletivo. |
| consultar_nbsB | Consulta uma NBS (código de serviço, sem pontos): descrição e dados de tributação. |
| consultar_aliquotas_referenciaA | Consulta as alíquotas padrão/de referência: CBS (União), IBS estadual (UF) e IBS municipal. Sempre consulta a da União; a da UF e a do município só se os códigos forem informados. Quando não houver alíquota cadastrada para a data, o item correspondente traz o erro. Args:
data: Data (yyyy-MM-dd). Padrão: hoje.
codigo_uf: Código IBGE da UF (2 dígitos), ex: 43 (RS). Veja |
| listar_ufsA | Lista as UFs com sigla, nome e código IBGE. |
| listar_municipiosA | Lista os municípios de uma UF com o código IBGE (usado no cálculo). Args: sigla_uf: Sigla da UF, ex: 'RS'. busca: Parte do nome para filtrar (ignora acentos), ex: 'porto alegre'. limite: Máximo de itens (padrão 50). |
| consultar_fundamentacao_legalA | Consulta a fundamentação legal (LC 214/2025) de cada cClassTrib. Informe Args: data: Data (yyyy-MM-dd). Padrão: hoje. c_class_trib: Código da cClassTrib. busca: Texto livre (ex: 'medicamento', 'art. 138'). limite: Máximo de itens (padrão 10; os textos legais são longos). |
| listar_tipos_dfeB | Lista os tipos de DF-e (NF-e, NFC-e, NFS-e...) com sigla e modelo, agrupados (mercadorias/serviços). |
| nfse_classificacoes_por_nbsB | NFS-e: lista os CSTs e cClassTrib aplicáveis a um serviço (código NBS, sem pontos). |
| nfse_local_operacaoC | NFS-e: indica o local da operação (onde o IBS é devido) a partir do Indicador de Operação. Args: c_ind_op: Código do Indicador de Operação (6 dígitos). data: Data do fato gerador (yyyy-MM-dd). Padrão: hoje. |
| status_conexaoA | Mostra se está tudo conectado: o MCP ligado ao Claude, a API Java da calculadora (online, iniciando, offline ou erro), a versão do banco de dados e onde ver os logs. Use quando o usuário perguntar se a calculadora está funcionando, ou quando outra ferramenta falhar por conexão. Se a API estiver parada, ela é iniciada em segundo plano. Args: iniciar_se_offline: Se a API estiver parada, iniciar em segundo plano (padrão: sim). |
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 16 tools
Most tools target clearly distinct queries (NCM, NBS, UF, município, alíquotas, fundamentação legal). There is mild overlap between listar_situacoes_tributarias and buscar_classificacao_tributaria, and between nfse_classificacoes_por_nbs and buscar_classificacao_tributaria with sigla_dfe, but the descriptions clarify the intended use. calcular_tributos vs calcular_base_calculo_unificada could also be momentarily confused, though they clearly differ in scope.
13 of 16 tools follow a predictable verb_noun pattern (calcular_, listar_, buscar_, consultar_, validar_, explicar_). Three deviate to noun-first (nfse_classificacoes_por_nbs, nfse_local_operacao, status_conexao), but these are still readable and the nfse_ prefix groups them coherently.
16 tools is slightly above the ideal 3-15 range, but for a complex tax engine covering classification, nomenclature, aliquots, legal basis, and calculation, each tool covers a distinct piece. No tool appears redundant or filler.
The surface covers the full lifecycle of a tax calculation: discovery (CST/cClassTrib), validation (NCM/NBS compatibility), aliquots, base calculation, full calculation, error explanation, legal basis, and connection status. Minor gaps exist around batch/multi-item simulation workflows and no explicit mechanism to persist or compare past calculations.