Skip to main content
Glama

Server Details

Issue and manage Brazilian service invoices (NFS-e) by chatting with your agent, platform-hosted, no

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
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
mcp-dir/notafiscal-mcp
GitHub Stars
2
Server Listing
Nota Fiscal
ChatGPT
–
Claude
–

TDQS

A3.8/5.0

Scored across 12 tools

Disambiguation4/5

The notafiscal_* tools each target a distinct lifecycle action (emit, cancel, consult, list, download, list companies), and the platform tools are largely separable. However, authenticate vs connect vs toolkit_info all touch connection/auth state, creating mild overlap that could confuse selection.

Naming Consistency3/5

The six notafiscal_* tools follow a clean prefix_verb_noun pattern (notafiscal_emitir_nfse, notafiscal_cancelar_nfse), but the platform tools break convention with bare nouns/verbs (marketplace, authenticate, connect) and scattered snake_case (report_bug, show_version). Mixed but still readable.

Tool Count4/5

12 tools is a reasonable, well-scoped set for an invoicing server plus platform plumbing. Slightly heavy given ~5 of them are generic platform/meta tools rather than domain operations, but nothing feels redundant.

Completeness4/5

The NFS-e lifecycle is well covered: list companies, emit, consult status, list issued notes, download PDF/XML, and cancel. Minor gaps (no update/correction flow, no explicit credential setup per company) but these are largely inherent to fiscal documents.

Available Tools

12 tools
authenticateA
Idempotent
Inspect

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header Authorization: Bearer <token> for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "" } after the user pastes, or with no args to get the link.

Inputs: token.

connectA
Read-onlyIdempotent
Inspect

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Inputs: no named parameters.

marketplaceAInspect

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/ link that opens without login.

Inputs: limit, query, action, mcp_id, +19 more.

notafiscal_baixar_nfseA
Read-onlyIdempotent
Inspect

Retorna os links de PDF (DANFSe) e XML de uma NFS-e emitida.

Bulk support: accepts invoice_ids for batched execution.

Inputs: invoice_id (required), company, invoice_ids.

notafiscal_cancelar_nfseA
Destructive
Inspect

Cancela uma NFS-e emitida (IRREVERSÍVEL, sujeito ao prazo de cancelamento do município). Confirme antes de chamar.

Bulk support: accepts invoice_ids for batched execution.

Inputs: invoice_id (required), company, invoice_ids.

notafiscal_consultar_nfseA
Read-onlyIdempotent
Inspect

Consulta o status/detalhe de uma NFS-e emitida, por invoice_id.

Bulk support: accepts invoice_ids for batched execution.

Inputs: invoice_id (required), company, invoice_ids.

notafiscal_emitir_nfseAInspect

Emite uma NFS-e (nota fiscal de serviço) para uma empresa conectada. Cria um DOCUMENTO FISCAL REAL — confirme os dados antes de chamar.

  • 'nfse': corpo da nota no schema da nfe.io (JSON string), com ao menos: cityServiceCode, description, servicesAmount, e borrower:{ federalTaxNumber, name, email?, address? }.

  • 'external_id' (opcional): chave de idempotência — reuse a mesma para não duplicar a nota numa re-tentativa. Retorna o id da nota e o status de processamento. Se a resposta disser que a empresa NÃO está habilitada para emitir (município sem emissão homologada, cadastro em homologação), o problema não é o payload: não re-tente — confira notafiscal_empresas e oriente o usuário.

Bulk support: accepts external_ids for batched execution.

Inputs: nfse (required), company, external_id, external_ids.

notafiscal_empresasA
Read-onlyIdempotent
Inspect

Lista as empresas (CNPJs) conectadas a este install e a situação de cada uma (company_id, razão social, município, validade do certificado, situacao_fiscal e pode_emitir). CHAME ANTES DE EMITIR: só empresa com pode_emitir=true (situacao_fiscal=Active) consegue emitir NFS-e; 'aviso' explica o bloqueio quando houver.

Inputs: no named parameters.

notafiscal_listar_nfseB
Read-onlyIdempotent
Inspect

Lista as NFS-e emitidas por uma empresa (paginado).

Inputs: company, page_count, page_index.

report_bugA
Idempotent
Inspect

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Inputs: message (required), context, conversation.

show_versionA
Read-onlyIdempotent
Inspect

Show the current MCP platform and adapter versions.

Inputs: no named parameters.

toolkit_infoA
Read-onlyIdempotent
Inspect

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to issue, track, and cancel Brazilian NFS-e service invoices through Emissor Nacional without a digital certificate, while managing company credentials, customers, and services. It includes previews and confirmation safeguards for actions with real tax effect.
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.