NotaMCP

io.github.CssEoCAOPublished by GitHub account CssEoCAOv1.0.0Updated Oct 29, 2026

Issue Brazilian service invoices (NFS-e Nacional) from your AI, with preview and confirmation.

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for issuing Brazilian service invoices (NFS-e Nacional) from an AI chat, with preview, explicit confirmation and prepaid credits.

What you can do
  • Prepare an invoice: build a preview with a confirmation token, using saved service/CNAE/NBS/tax configurations
  • Confirm and issue the invoice, then look up a single invoice's status or list account history
  • Cancel an authorized invoice with a reason and explicit confirmation
  • Manage frequent customers: search saved recipients by name, save or update them
  • Check credit balance, per-invoice price, environment and daily cap, and generate a Pix/card payment link to buy credits
When to use it
Useful for Brazilian service providers who want to draft, issue, track and cancel NFS-e invoices conversationally, and who already hold an A1 certificate and a NotaMCP account.
Requirements
Remote streamable HTTP endpoint at notamcp.com.br; no package or environment variables. A NotaMCP account with the user's own A1 digital certificate is required, and any tool call triggers the NotaMCP login flow.
Before you install
Issuing is a legally binding, irreversible act: the server asks assistants to confirm only after explicit user approval, and cancellation does not refund the emission credit. Each authorized invoice debits prepaid credits, and buying credits produces a real payment link. The assistant cannot download or read the returned PDF/XML links.

Installation

In SourceWeft

  1. Open NotaMCP 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.CssEoCAO%2Fnotamcp/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": {
    "notamcp": {
      "type": "http",
      "url": "https://notamcp.com.br/mcp"
    }
  }
}

Tools

10

emitir_nota

Preparar emissão de NFS-e (prévia)

Prepara uma NFS-e e devolve a PRÉVIA + confirmacao_token. NÃO emite nada. Mostre a prévia ao usuário e chame confirmar_emissao só depois do OK explícito dele. Tomador: informe tomador_id (salvo) OU tomador_doc + tomador_razao.

Parametersvalorrequiredtomador_idcompetenciatomador_docconfiguracaotomador_paistomador_tipodiscriminacaorequiredtomador_razaoconfiguracao_id

listar_configuracoes

Listar configurações fiscais recentes

Últimas combinações realmente usadas de serviço, CNAE, NBS e tributação. Use configuracao_id em emitir_nota. Se houver ambiguidade, pergunte ao usuário — não escolha nem invente código fiscal.

Parameterslimite

confirmar_emissao

Confirmar e emitir a NFS-e

Emite DE VERDADE a nota da prévia. Chame apenas depois que o usuário aprovou a prévia nesta conversa. Idempotente: o mesmo token nunca emite duas vezes. Autorizada, devolve danfse_url (PDF) e xml_url — links para o usuário abrir, que você não consegue baixar.

Parametersconfirmacao_tokenrequired

consultar_nota

Consultar uma nota

Situação de uma nota desta conta (status, número, chave de acesso, erro).

Parametersnota_idrequired

listar_notas

Listar notas

Histórico de notas da conta, com filtros opcionais.

Parameterslimitestatuscompetencia

cancelar_nota

Cancelar uma nota

Cancela uma NFS-e autorizada na SEFIN. Exige confirmar=true — peça confirmação explícita ao usuário antes. O crédito da emissão NÃO volta (a nota existiu); o cancelamento é grátis.

Parametersmotivorequirednota_idrequiredconfirmarrequiredcodigo_motivo

listar_tomadores

Listar tomadores salvos

Tomadores salvos desta conta (use o id em emitir_nota). Passe `busca` com o NOME que o usuário falou para achar o tomador sem precisar do CNPJ — ignora acento, caixa e pontuação. Se voltar mais de um, pergunte qual antes de emitir.

Parametersbusca

salvar_tomador

Salvar tomador

Salva/atualiza um tomador frequente (ex.: "salva a Shopee como tomador").

Parametersdocpaistiporazaorequired

saldo

Créditos de notas e limites

Quantidade de notas disponíveis, preço por nota, ambiente e teto diário. O nome técnico saldo é mantido por compatibilidade.

Takes no parameters.

comprar_creditos

Adicionar créditos de notas

Gera um link de pagamento (Pix/cartão) para adicionar créditos de notas. Entregue o link ao usuário — o pagamento acontece no navegador dele e as notas entram após a confirmação.

Parametersvalor_centavosrequired

Version history

1
  1. v1.0.0LatestOct 29, 2026

Score

83% 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.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.