Focus NFe MCP. Automate Brazilian tax document workflow
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Focus NFe. Manage the full life cycle of Brazilian fiscal documents—NFe (product) and NFS-e (service). Use this server to emit new invoices, check document status, cancel old records, and download the official XML for accounting.
It connects your AI agent directly to the required fiscal API calls.
What your AI agents can do
Cancel document
Cancels a previously issued and authorized invoice using a specified reference number.
Consult document
Checks the current status and retrieves detailed information for any given invoice reference.
Download xml
Retrieves the final, authorized XML document file for a given invoice reference.
The agent sends the required details, and the server emits a new Service Invoice, returning a reference number and initial status.
The agent sends product and item details, and the server emits a new Product Invoice, returning a reference number and initial status.
The agent provides an invoice reference, and the server checks the current status (e.g., Authorized, Processing, Cancelled) and retrieves key details.
The agent provides a reference and a mandatory justification reason, and the server attempts to cancel the document.
The agent provides a reference, and the server retrieves the final, authorized XML file for record-keeping.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Focus NFe MCP Server: 5 Tools for Brazilian Invoicing
These five tools allow your agent to execute all necessary API calls to emit, check, cancel, and download official Brazilian tax documents.
019d759dcancel document
Cancels a previously issued and authorized invoice using a specified reference number.
019d759dconsult document
Checks the current status and retrieves detailed information for any given invoice reference.
019d759ddownload xml
Retrieves the final, authorized XML document file for a given invoice reference.
019d759demit nfe
Generates and emits a new Product Invoice (NF-e), handling item-level tax details.
019d759demit nfse
Generates and emits a new Service Invoice (NFS-e), used for service-based billing.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Focus NFe, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You're dealing with Brazilian fiscal paperwork? This server handles the whole shebang for you. You connect it to your AI client, and your agent manages the full life cycle of both Product Invoices (NF-e) and Service Invoices (NFS-e).
To get started, your agent can emit a new Service Invoice (NFS-e). Just send over the required details, and the server spits out a reference number and the initial status. You can also have your agent emit a new Product Invoice (NF-e); you just gotta send product and item details, and the server gives you a reference number and the starting status for that product bill.
Need to know what's up with an invoice? Your agent can consult the document status by giving it an invoice reference. The server checks the current status—whether it's Authorized, Processing, or Cancelled—and pulls up all the key details. If the document needs to go, your agent can cancel an issued invoice by providing both the reference number and the required justification reason.
For your books, your agent can download the official XML file by giving the server a reference number, grabbing the final, authorized XML needed for record-keeping.
How Focus NFe MCP Works
- 1 Subscribe to the server and provide your Focus NFe API Token and Base URL.
- 2 Your AI agent calls the required function (e.g.,
emit_nfe) using the specific payload details. - 3 The server executes the API call, processes the response, and returns the result (e.g., the new reference or the XML data) to the agent.
The bottom line is, your agent handles the conversational part, and the server handles the direct, compliant communication with the Brazilian tax API.
Who Is Focus NFe MCP For?
Accountants, back-office operations managers, and SaaS developers building financial tools. This is for anyone who processes high volumes of Brazilian tax documents and needs to automate the entire workflow—from initial emission to final XML archival—without manual API calls.
Automates bulk invoice emission (both NF-e and NFS-e) and retrieves the necessary XML files for month-end closing and tax filing.
Handles complex, multi-step document lifecycles, such as emitting a product invoice, checking its status later, and then cancelling it with a required justification.
Integrates compliant fiscal capabilities into a platform's core logic, allowing users to generate and manage Brazilian tax documents without building the API wrapper themselves.
What Changes When You Connect
- Manage the entire document lifecycle: You don't just emit an invoice; you can check its status with
consult_document, cancel it withcancel_document, and then download the final XML usingdownload_xml. - Handle both service and product billing: The server separates logic for service invoices (
emit_nfse) and product invoices (emit_nfe), ensuring you use the correct fiscal path for the payment type. - Reduce manual lookups: Instead of logging into multiple portals to verify status, your agent runs
consult_documentand gets the current, authoritative status immediately. - Ensure audit readiness: Every transaction generates a downloadable XML via
download_xml, providing the required legal proof for accounting and compliance. - Streamline corrections: If an invoice needs to be voided, you use
cancel_documentand provide the mandatory justification, leaving a clear audit trail. - Write code faster: Developers integrating this don't worry about the tax API handshake; they just call the function, and the server handles the complexity.
Real-World Use Cases
Client needs to verify invoice status before payment.
A financial analyst needs to know if Invoice REF-456 is authorized. They ask their agent to run consult_document. The agent gets the status (e.g., 'Authorized') and reports back, confirming the payment can proceed. They don't waste time checking multiple screens.
Automating month-end billing for a consultancy.
An accountant needs to process 50 service invoices. They prompt the agent to 'Process all services for Q3.' The agent loops through the client list, calling emit_nfse for each one, and then collects the resulting references for a final report.
Handling a necessary invoice correction.
A sales manager issues a product invoice (emit_nfe), but the client changes their mind. The manager asks the agent to 'Cancel the invoice for product X.' The agent calls cancel_document, providing the required justification reason, and confirms the cancellation.
Archiving documentation for tax audit.
The compliance team needs the final, official record for a specific transaction. They ask the agent to 'Get the XML for invoice REF-123.' The agent executes download_xml and provides the file, ready for permanent storage.
The Tradeoffs
Treating invoices as single events
Attempting to manage the full lifecycle (create, check, cancel) by calling three separate, non-sequenced tools without state management. This results in missing context or assuming a document status that isn't current.
→
Always start by calling consult_document to verify the document's current state. Then, use the appropriate tool (emit_nfe, cancel_document, etc.) based on that verified state. The agent handles the sequence.
Ignoring mandatory tax rules
Manually building the payload for emit_nfe and forgetting the required ICMS rate or product tax code. The API call fails, and the user has no idea why.
→ Rely on the server's structured inputs. The tool is designed to enforce the correct Brazilian fiscal structure. Focus on the data, not the tax rules.
Assuming success on emission
Calling emit_nfse and assuming the invoice is immediately authorized. If the external API is slow or fails, the user thinks the transaction went through when it didn't.
→
After any emission tool (emit_nfe or emit_nfse), immediately call consult_document to confirm the status. This verifies the transaction actually completed successfully.
When It Fits, When It Doesn't
Use this server if your workflow requires managing the complete lifecycle of Brazilian fiscal documents—meaning you need to emit, check, cancel, and archive (NFe/NFS-e). The server handles the compliance complexity of the Brazilian tax API. Don't use this if you only need to read a simple database field or send a basic message; those are general-purpose tools. If your task is simply 'write a document,' use a general text generation tool. If your task is 'ensure tax compliance and generate a legally binding document,' use Focus NFe.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Focus NFe. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 5 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tax document compliance shouldn't involve API guesswork.
Today, handling invoice documents means jumping between multiple systems: the accounting ledger, the tax authority portal, and your CRM. You have to manually copy reference numbers, check status codes, and ensure the data structure matches the latest SEFAZ requirements. It’s tedious, error-prone, and requires constant vigilance.
With the Focus NFe MCP Server, your agent handles the whole process. You tell it, 'Invoice X needs to be emitted.' The agent runs the necessary tool (`emit_nfe` or `emit_nfse`), and the server returns the final, compliant reference number and status. It takes the guesswork out of tax compliance.
Focus NFe MCP Server: Manage the entire document flow from chat.
The biggest time sink is the document lifecycle itself. You used to emit an invoice, then wait for confirmation, then manually check if it passed validation, and finally download the XML. This was a three-step, multi-system process.
Now, your AI agent orchestrates it. It runs the emission tool, gets the reference, and can immediately run `consult_document` or `download_xml` in the same conversation. The process is fully automated, minimizing reconciliation time.
Common Questions About Focus NFe MCP
Does it support both NFS-e and NF-e? +
Yes! The tools allow emitting and managing both Service Invoices (nfse) and Product Invoices (nfe) seamlessly.
How do I get my API Token? +
Log in to the Focus NFe portal and navigate to the API section to generate your token.
Can I download the authorized XML? +
Yes, use the download_xml tool with the document reference to retrieve the full XML content.
Is it homologated for all Brazilian cities? +
Focus NFe covers thousands of cities for NFS-e emission. You can check their API documentation for the complete list of supported IBGE city codes.
How do I use the `emit_nfe` tool to issue a Product Invoice (NF-e)? +
You provide the necessary product details, values, and item list. The server handles the secure transmission and returns the unique reference number and status. This process is critical for fully detailing product sales records.
What happens if I need to cancel an invoice using the `cancel_document` tool? +
You must include the document's reference number and a valid justification reason. The tool verifies the status and, if permissible, sends the cancellation request. Successful cancellation confirms the document is voided.
Can the Focus NFe server handle bulk document processing for my accounting team? +
Yes, your agent can automate this. By calling the emit_nfse tool repeatedly with a list of transactions, you process many service invoices in one workflow. This saves time compared to manual entry.
If a document fails to process, how does the `consult_document` tool help me troubleshoot? +
The consult_document tool returns the current status code and any specific error messages from the API. This gives you immediate visibility into why an invoice failed, helping you fix the issue fast.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Pricefx
Equip your AI with advanced enterprise CPQ capabilities — fetch products, manage customers, and generate automated pricing quotes directly via chat.
Odoo eCommerce
List shop products, manage eCommerce orders, browse categories and customers — Odoo Website & eCommerce through natural conversation.
IP Parking
Manage PARCS operations: sites, tariffs, gates, and ANPR events via IP Parking API.
You might also like
Innform
Manage learners, courses, and results via Innform LMS API.
CardanoScan (Cardano Block Explorer API)
Access real-time Cardano blockchain data — query addresses, transactions, blocks, and stake pools directly from your AI agent.
AntChain
Alibaba's enterprise blockchain API hub — query blocks, transactions, smart contracts, and accounts on AntChain BaaS.