# Calculadora da Reforma Tributária (CBS/IBS) — how to use (mcp.ai)

Calcule CBS, IBS (UF e município) e Imposto Seletivo da Reforma Tributária do Consumo (LC 214/2025) no regime regular e no Simples Nacional, com memória de cálculo por item, alíquotas de referência, tabelas oficiais (CST, cClassTrib, NCM, NBS, fundamentação legal) e geração e validação do XML. Usa o código aberto oficial da Receita Federal (regime regular 1.6.1, Simples Nacional 0.0.6, base V0059 de 30/09/2026), sem recálculo próprio. Serviço independente, sem vínculo com a Receita Federal. Grátis. Base oficial V0059: só tem alíquotas de referência de 2026. Não substitui a análise do seu contador.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_calculadora_rtc?ms=1795117920000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `calculadora_rtc_aliquotas`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/calculadora_rtc`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/calculadora_rtc/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/calculadora_rtc/aliquotas` — Alíquotas de REFERÊNCIA de CBS (União), IBS estadual (UF) e IBS municipal vigentes numa data, direto da base oficial. Recebe `data` (AAAA-MM-DD) ou `ano`, e opcionalmente `uf` (sigla ou código IBGE) e
  - body: { data?: string, ano?: integer, uf?: string, municipio_ibge?: string }
- `POST https://api.mcp.ai/api/calculadora_rtc/base/calculo` — Base de cálculo UNIFICADA oficial de um item de NF-e/NFC-e (documento 'nfe') ou NFS-e ('nfse'): devolve as bases do regime regular, do Imposto Seletivo e do Simples Nacional, aplicando a vigência de c
  - body: { documento?: string, entrada: object }
- `POST https://api.mcp.ai/api/calculadora_rtc/consultar/tabela` — Consulta as tabelas oficiais da calculadora numa data de vigência. tipo: cst (CST de CBS/IBS com suas classificações), cclasstrib (classificação tributária: descrição, reduções, documentos, fundamenta
  - body: { tipo: string, codigos?: string[], busca?: string, data?: string, ano?: integer }
- `POST https://api.mcp.ai/api/calculadora_rtc/explicar/erro` — Explica códigos de erro das calculadoras oficiais: REG-xxx (regime regular) e VSN-xxx (Simples Nacional), com título, descrição e orientação do catálogo oficial. Aceita uma lista de códigos. Cálculo o
  - body: { codigos: string[] }
- `POST https://api.mcp.ai/api/calculadora_rtc/gerar/xml` — Calcula a operação do regime regular (modo estrito: qualquer item inválido recusa a operação inteira) e gera o XML dos grupos de tributação IBS/CBS/IS para o documento fiscal (`tipo`: nfe, nfce, cte, 
  - body: { operacao: object, tipo?: string }
- `POST https://api.mcp.ai/api/calculadora_rtc/regime/regular` — Calcula CBS, IBS (UF e município) e Imposto Seletivo de uma operação do REGIME REGULAR (LC 214/2025) pela calculadora oficial da Receita, com erros por item (um item inválido não derruba os outros). R
  - body: { operacao: object }
- `POST https://api.mcp.ai/api/calculadora_rtc/simples/nacional` — Calcula CBS e IBS de uma operação de empresa do SIMPLES NACIONAL pela calculadora oficial da Receita (NT 2026.005), com erros por item. Recebe `operacao` no JSON oficial. Exemplo: {"id":"op-1","versao
  - body: { operacao: object }
- `POST https://api.mcp.ai/api/calculadora_rtc/validar/xml` — Valida um XML contra o XSD oficial: só os grupos de tributação (subtipo 'grupo') ou a nota completa ('nota'). Devolve `valido` e, se inválido, a linha/coluna do erro. Cálculo oficial das calculadoras 
  - body: { xml: string, tipo?: string, subtipo?: string }

## Example prompts
- "Calcule a CBS e o IBS de um serviço de consultoria empresarial de R$ 5.000 prestado em Campo Grande/MS em março de 2026, com tributação integral. Mostre a memória de cálculo por item e a versão da calculadora usada."
- "O que significa o cClassTrib 200028? Qual a redução de alíquota, em que documentos ele vale e qual a fundamentação legal?"
- "Confira se o grupo de IBS/CBS deste XML de NF-e está válido no leiaute oficial e, se não estiver, diga a linha e o erro: [cole o XML]"

## More
- Page: https://mcp.ai/calculadora_rtc
- Agent spec (llms.txt): https://mcp.ai/calculadora_rtc/llms.txt
- Postman collection: https://mcp.ai/calculadora_rtc/postman.json
