Skip to main content
Glama

NotaMCP

by io.github.CssEoCAO
OverviewDiscussionsAdmin

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL

TDQS

Score is being calculated.

Available Tools

10 tools
cancelar_notaCancelar uma nota
Destructive
Inspect

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.

NameRequiredDescriptionDefault
motivoYesMotivo em texto (vai para a SEFIN).
nota_idYes
confirmarYesPrecisa ser true — confirmação do usuário nesta conversa.
codigo_motivoNo1=erro na emissão · 2=serviço não prestado · 4=duplicidade.
comprar_creditosAdicionar créditos de notasInspect

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.

NameRequiredDescriptionDefault
valor_centavosYesValor da recarga em centavos: 1000 (R$10), 2500 (R$25), 5000 (R$50) ou 10000 (R$100).
confirmar_emissaoConfirmar e emitir a NFS-e
Destructive
Inspect

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.

NameRequiredDescriptionDefault
confirmacao_tokenYesToken devolvido por emitir_nota.
consultar_notaConsultar uma nota
Read-onlyIdempotent
Inspect

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

NameRequiredDescriptionDefault
nota_idYesId da nota (veio da emissão ou de listar_notas).
emitir_notaPreparar emissão de NFS-e (prévia)Inspect

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.

NameRequiredDescriptionDefault
valorYesValor do serviço em reais, ex.: "1250,00".
tomador_idNoId de um tomador salvo (listar_tomadores).
competenciaNoMês de referência YYYY-MM. Vazio = mês atual.
tomador_docNoCNPJ (14 dígitos) ou CPF (11) do tomador.
configuracaoNoConfiguração fiscal só desta nota. Campos omitidos herdam o cadastro/configuracao_id. Nunca invente códigos fiscais.
tomador_paisNoPaís ISO2 do tomador estrangeiro (ex.: "SG").
tomador_tipoNoUse "exterior" para tomador estrangeiro.
discriminacaoYesDescrição do serviço, como sai impressa na nota.
tomador_razaoNoRazão social ou nome do tomador.
configuracao_idNoId de uma combinação devolvida por listar_configuracoes.
listar_configuracoesListar configurações fiscais recentes
Read-onlyIdempotent
Inspect

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

NameRequiredDescriptionDefault
limiteNoMáximo de combinações (1–20, padrão 8).
listar_notasListar notas
Read-onlyIdempotent
Inspect

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

NameRequiredDescriptionDefault
limiteNoMáx. de notas (1–100, padrão 20).
statusNoFiltro por status.
competenciaNoFiltro YYYY-MM.
listar_tomadoresListar tomadores salvos
Read-onlyIdempotent
Inspect

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.

NameRequiredDescriptionDefault
buscaNoNome (ou parte) da empresa, ou o documento. Ex.: "acai" acha "Açaí & Cia Ltda".
saldoCréditos de notas e limites
Read-onlyIdempotent
Inspect

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

NameRequiredDescriptionDefault

No parameters

salvar_tomadorSalvar tomador
Destructive
Inspect

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

NameRequiredDescriptionDefault
docNoCNPJ ou CPF (só números ou formatado).
paisNoISO2, só para exterior.
tipoNo
razaoYesRazão social ou nome.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 10 tool updates
    • First observedcancelar_nota
    • First observedcomprar_creditos
    • First observedconfirmar_emissao
    • First observedconsultar_nota
    • First observedemitir_nota
    • First observedlistar_configuracoes
    • First observedlistar_notas
    • First observedlistar_tomadores
    • First observedsaldo
    • First observedsalvar_tomador

Related MCP Connectors

Related MCP Servers

  • brazil-invoice-mcp

    junter1989k-ai
    A
    license
    Not graded
    quality
    B
    maintenance
    MCP server that lets AI agents issue Brazilian NFS-e service invoices via Focus NFe, with tools for creating, querying, and canceling invoices.
    MIT

  • mcp-nfse-nacional

    SamuelMoraesF
    A
    license
    A
    quality
    D
    maintenance
    MCP server for querying Brazilian electronic service invoices (NFSe) from the national portal. Allows AI agents to authenticate with digital certificates and search, detail, and download PDFs of issued NFSe.
    3
    23 npm
    18
    ISC
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources