Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
RTC_HOMENoPasta do log e do diretório temporário do Java.~/.calculadora-rtc
RTC_NOTIFYNoMostra avisos do Windows ao conectar, quando a API fica pronta e em caso de falha.1
RTC_API_DIRNoPasta do projeto da API.../calculadora-rtc-regime-regular
RTC_BASE_URLNoURL base da API.http://localhost:8080/api
RTC_AUTOSTARTNoSobe a API Java sozinho quando ela está parada (só para URL local).1
RTC_JAVA_HOMENoJDK a usar (senão JAVA_HOME, as instalações em Program Files e o PATH).
RTC_MAX_RESULTSNoMáximo de resultados nos endpoints.100
RTC_HTTP_TIMEOUTNoTimeout em segundos.60
RTC_STOP_ON_EXITNoEncerra a API iniciada pelo MCP quando o Claude desconecta.1
RTC_STARTUP_TIMEOUTNoSegundos 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

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

Tools

Functions exposed to the LLM to take actions

NameDescription
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 explicar_erro para detalhar um código.

Dicas antes de calcular:

  • Descubra CST e cClassTrib com buscar_classificacao_tributaria / listar_situacoes_tributarias.

  • Confirme que a NCM/NBS é compatível com a cClassTrib via validar_nomenclatura_aplicavel.

  • O código do município (IBGE) sai de listar_municipios.

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 listar_tipos_dfe.

buscar_classificacao_tributariaA

Consulta classificações tributárias (cClassTrib) de CBS/IBS.

Escolhe a consulta conforme os filtros informados:

  • c_class_trib (+ sigla_dfe opcional): detalhe completo de uma cClassTrib (tipo de alíquota, percentuais de redução, crédito, nomenclatura exigida etc.).

  • cst: todas as cClassTrib de um CST.

  • fornecedor/adquirente (ATOR_ID) e/ou sigla_dfe: cClassTrib aplicáveis aos atores/DF-e.

  • nenhum dos acima: lista geral; use busca para filtrar por texto (ex: 'medicamento', 'educação', 'alimentação humana').

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 ncm OU nbs. Retorna valido: true/false. Evita o erro REG-011 no cálculo.

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_ufs. codigo_municipio: Código IBGE do município (7 dígitos). Veja listar_municipios.

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 c_class_trib para a base legal de uma classificação, ou busca para filtrar por texto.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.6/5.0

Scored across 16 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues