API e MCP grátis da NFS-e nacional e da reforma tributária
Consulte códigos, calcule ISS, simule IBS e CBS, valide a DPS e saiba se o município já emite pelo Emissor Nacional, em JSON ou direto no Claude, no ChatGPT e no Cursor. Os mesmos dados das tabelas fiscais do binobo, das tabelas oficiais.
A API do binobo é gratuita e aberta: não pede cadastro nem chave, responde em JSON com CORS liberado e tem servidor MCP para assistentes de IA. Cada resposta traz a versão da tabela oficial e o link da ficha, para você citar a fonte.
O que dá para fazer
Adesão ao Emissor Nacional
O município já emite NFS-e pelo portal nacional? Com a data de vigência, conferido todo dia.
Calculadora de ISS e retenção
Alíquota oficial do município, onde o ISS é devido e se o tomador retém.
Simulador de IBS e CBS
IBS e CBS de cada ano da transição, com a redução da cClassTrib.
Tabelas oficiais
cTribNac, LC 116, NBS, cClassTrib, CST e indOp com as correlações.
Endpoints
Respostas em JSON UTF-8, com CORS aberto. Cada objeto traz url (a ficha em HTML) e versao.
Base: https://www.binobo.com.br/tabelas/api/v1 · especificação OpenAPI 3.1
| Endpoint | O que devolve |
|---|---|
GET /ctribnac?q=software | Busca de códigos de tributação nacional pela descrição do serviço |
GET /ctribnac/{codigo} | Ficha do cTribNac: LC 116, onde o ISS é devido, NBS, cClassTrib, CST, indOp e alíquota de ISS mais comum |
GET /lc116/{subitem} | Subitem da LC 116/2003 com os cTribNac e NBS correlacionados |
GET /nbs/{codigo} | Código NBS 2.0 com hierarquia e serviços correlacionados |
GET /cclasstrib?cst=200&nfse=true | Classificações tributárias do IBS/CBS, com filtros |
GET /cclasstrib/{codigo} | cClassTrib: CST, redução de alíquota, vigência, base legal e serviços |
GET /cst e /cst/{codigo} | CST do IBS e da CBS e as classificações de cada grupo |
GET /indop e /indop/{codigo} | Indicador de operação (onde a operação é considerada realizada) |
GET /iss/{ibge}?ctribnac={codigo} | Alíquota de ISS do município, de um serviço ou de todos |
GET /iss?municipio=Curitiba&uf=PR | A mesma consulta por nome e UF |
GET /adesao/{ibge} e /adesao | O município já emite pelo Emissor Nacional (e o resumo do país) |
GET /calculo/iss?ibge=&ctribnac=&valor= | ISS da nota, onde é devido e retenção |
GET /simulacao/ibs-cbs?valor=&cclasstrib=&ano= | IBS e CBS no ano da transição |
GET /sugestao/servico?cnae= ou ?cnpj= | Código de serviço sugerido pela atividade |
POST /validacao/dps | Validação do XML da DPS (corpo XML ou {"xml": ...}) |
GET /versao | Data de carga e versão de cada tabela oficial |
Exemplo
curl https://www.binobo.com.br/tabelas/api/v1/ctribnac/010101
{
"codigo": "010101",
"descricao": "...",
"subitemLc116": "1.01",
"issDevido": "...",
"cclasstrib": [{ "codigo": "...", "cst": "...", "sugerida": true }],
"nbs": [{ "codigo": "..." }],
"url": "https://www.binobo.com.br/tabelas/tributacao-nacional/010101",
"versao": "2026-10-26"
}Servidor MCP
Para Claude, ChatGPT, Cursor, VS Code e outros clientes MCP.
URL: https://www.binobo.com.br/tabelas/mcp (streamable HTTP, sem estado, sem autenticação).
{
"mcpServers": {
"binobo-tabelas-fiscais": { "type": "http", "url": "https://www.binobo.com.br/tabelas/mcp" }
}
}Ferramentas: consultar_ctribnac, buscar_servico, consultar_cclasstrib, listar_cclasstrib, consultar_cst, consultar_indop, consultar_nbs, aliquota_iss, consultar_adesao_municipio, calcular_iss, simular_ibs_cbs, sugerir_codigo_servico, validar_dps e versao_tabelas, todas só de leitura.
Limites
- 60 requisições por minuto e 5.000 por dia por IP (HTTP 429 com
Retry-After) - Respostas com cache de uma hora no cliente e de um dia na borda
- Corpo do MCP de até 16 KB, uma requisição JSON-RPC por vez
Perguntas frequentes
A API é gratuita?
Sim. Não pede cadastro nem chave. O limite é de 60 requisições por minuto e 5.000 por dia por IP; como as tabelas mudam no máximo uma vez por mês, guarde as respostas em cache.
De onde vêm os dados?
Das tabelas oficiais do Portal Nacional da NFS-e (lista de serviços nacional, correlações com IBS/CBS, municípios e alíquotas de ISS) e do portal SVRS (cClassTrib e CST), reproduzidas sem interpretação. Tabelas carregadas em 26/10/2026; cada resposta traz a versão.
Como usar com o Claude, o ChatGPT ou o Cursor?
Adicione o servidor MCP https://www.binobo.com.br/tabelas/mcp como conector remoto (transporte HTTP, sem autenticação). As ferramentas consultam cTribNac, cClassTrib, CST, indOp, NBS e alíquota de ISS por município.
Posso usar os dados no meu sistema?
Sim. São dados públicos; cite a fonte e a versão. Para emitir a NFS-e com esses campos preenchidos automaticamente, o binobo faz isso na tela, pelo WhatsApp ou em lote.
Fontes: Anexo B v1.01 (22/01/2026), Portal Nacional da NFS-e · Anexo C v1.01, Portal Nacional da NFS-e · Portal SVRS, publicação 2026-10-01 · tabela de alíquotas do Portal Nacional da NFS-e (20260903) · Tabelas carregadas em 26/10/2026. Os dados são reproduzidos das tabelas oficiais sem interpretação; confira a legislação do seu município antes de emitir. Também em API e MCP gratuitos.