Kalvi — NFS-e e IBS/CBS

io.github.marcogorrasi-hubPublished by GitHub account marcogorrasi-hubv0.1.0Updated Oct 24, 2026

Confere a NFS-e brasileira para IBS/CBS antes de transmitir. Sem cadastro e sem chave.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

A remote MCP server that checks Brazilian NFS-e service invoices against IBS/CBS tax rules, suggests tax codes, and explains official rejection codes.

What you can do
Validate a DPS XML against official IBS/CBS rules and see what would be rejected, with the official rejection code and the offending XML field, without storing the invoice data. Suggest CST and cClassTrib candidates from the LC 116 item or national taxation code, the provider's regime, municipality and competence date, with justification, current rates and the official source of each rule. Explain a national NFS-e rejection code by returning the official rule text, the XML field it refers to and whether it rejects the invoice. Every response includes a tables_version to cite.
When to use it
Use it before transmitting a DPS, when unsure which tax classification code applies to a service, or when the national system returns a rejection code you need to interpret. Useful for Brazilian service providers and accountants working with IBS/CBS reform rules.
Requirements
A remote streamable HTTP endpoint; no package installation. The registry declares no authentication, environment variables or headers, and the description says no registration and no key.
Before you install
The server receives invoice XML content, so check what data leaves your environment even though it says nothing is stored. Tax answers depend on the table version, so cite tables_version and confirm results against official sources before transmitting.

Installation

In SourceWeft

  1. Open Kalvi — NFS-e e IBS/CBS in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.marcogorrasi-hub%2Fkalvi-nfse/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "kalvi-nfs-e-e-ibs-cbs": {
      "type": "http",
      "url": "https://api.kalvi.com.br/v1/mcp"
    }
  }
}

README

This repository has no README.

Tools

3

validar_nfse

Conferir uma NFS-e antes de transmitir

Confere o XML da DPS (NFS-e do padrão nacional) contra as regras oficiais de IBS/CBS e devolve o que seria recusado, com o código oficial de rejeição e o campo do XML que causou. Use antes de transmitir. Nada da nota é guardado.

Parametersxmlrequired

classificar_servico

Descobrir o CST e o cClassTrib de um serviço

A partir do item da LC 116 (ou do código de tributação nacional), do regime do prestador, do município e da data de competência, devolve os candidatos de CST e cClassTrib com justificativa, alíquotas vigentes e a fonte oficial de cada regra. Use quando a pergunta for 'qual código eu uso neste serviço'.

Parametersnbs_codetax_regimerequiredservice_coderequiredcompetence_daterequiredoperation_naturemunicipality_coderequired

explicar_rejeicao

Explicar um código de rejeição da NFS-e

Recebe um código de rejeição da NFS-e nacional (E0958, E0855, E0959...) e devolve o texto oficial da regra, o campo do XML a que ela se refere e se o efeito é recusar a nota. Use quando a pergunta for 'o que significa este erro'.

Parameterscodigorequired

Version history

1
  1. v0.1.0LatestOct 24, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.