Nota Fiscal
Nota Fiscal Emita e gerencie notas fiscais de serviço (NFS-e) conversando com o agente, hospedado pela plataforma, sem você precisar de conta na nfe.io.
What it can do
- Notafiscal Empresas: 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).
- Notafiscal Emitir Nfse: 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
- Notafiscal Consultar Nfse: Consulta o status/detalhe de uma NFS-e emitida, por invoice_id. Bulk support: accepts invoice_ids for batched execution.
What data it sees
Do you need an account
No: the server works without sign-in
Nota Fiscal
Emita e gerencie notas fiscais de serviço (NFS-e) conversando com o agente, hospedado pela plataforma, sem você precisar de conta na nfe.io. Conecte seu CNPJ + certificado A1 e emita, consulte, baixe (PDF/XML) e cancele NFS-e.
Funciona em qualquer cliente MCP. Servidor remoto: https://api.mcp.ai/p_notafiscal
How to connect
How to connect Nota Fiscal to Claude
The server address to paste into Claude settings:
https://notafiscal-mcp--mcp-dir.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect Nota Fiscal to ChatGPT
The server address to paste into ChatGPT settings:
https://notafiscal-mcp--mcp-dir.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect Nota Fiscal to Cursor
The server address to paste into Cursor settings:
https://notafiscal-mcp--mcp-dir.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (12)
Raw names from tools/list. Only developers need these.
| notafiscal_empresas | 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). |
| notafiscal_emitir_nfse | 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. Bulk support: accepts external_ids for batched execution. |
| notafiscal_consultar_nfse | Consulta o status/detalhe de uma NFS-e emitida, por invoice_id. Bulk support: accepts invoice_ids for batched execution. |
| notafiscal_listar_nfse | Lista as NFS-e emitidas por uma empresa (paginado). |
| notafiscal_baixar_nfse | Retorna os links de PDF (DANFSe) e XML de uma NFS-e emitida. Bulk support: accepts invoice_ids for batched execution. |
| notafiscal_cancelar_nfse | 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. |
| show_version | Show the current MCP platform and adapter versions. |
| report_bug | Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. |
| connect | 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. |
| toolkit_info | Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes. |
| marketplace | 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/<slug> link that opens without login. |
| authenticate | 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: "<jwt>" } after the user pastes, or with no args to get the link. |