Focus Admin MCP. Manage NF-e and NFS-e compliance through conversation.
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 Admin lets you manage fiscal documents using the Focus NFe API. Send Correction Letters (CC-e), cancel previous CC-e entries, inutilize numbering ranges, and list all NF-e and NFS-e documents by date range.
You can also download the full XML or DANFE PDF for any document, or distribute DF-e documents by CNPJ.
What your AI agents can do
Cancel cc e
Cancels a Correction Letter (CC-e) that was previously sent for an NF-e.
Distribute dfe
Finds and distributes DF-e documents for your CNPJ using a specific NSU.
Download event xml
Downloads the XML file for a specific event that happened to an NF-e (like a manifestation or CC-e).
Send a Correction Letter for an NF-e, or cancel a CC-e that was previously issued.
Mark specific ranges of NF-e numbers as unusable via inutilize_numbering.
Retrieve the raw XML or the PDF (DANFE) for authorized NF-e documents.
List all NF-e or NFS-e documents that were issued or received between two specified dates.
Query and distribute DF-e documents for a CNPJ using a specific NSU.
Download the XML file for a specific event related to an NF-e (like a manifestation or CC-e).
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Focus Admin: 10 Tools for Fiscal Compliance
Manage every step of your electronic invoicing process, from listing documents by date to canceling errors, all through your AI agent.
019d759ccancel cc e
Cancels a Correction Letter (CC-e) that was previously sent for an NF-e.
019d759cdistribute dfe
Finds and distributes DF-e documents for your CNPJ using a specific NSU.
019d759cdownload event xml
Downloads the XML file for a specific event that happened to an NF-e (like a manifestation or CC-e).
019d759cdownload nfe danfe
Retrieves the PDF version (DANFE) of an NF-e document.
019d759cdownload nfe xml
Downloads the raw XML file for a specific NF-e document.
019d759cinutilize numbering
Marks a specific range of NF-e numbering as unusable.
019d759clist nfe by period
Lists all NF-e documents that were issued or received within a specified date range.
019d759clist nfse emitted
Lists all NFS-e documents that your company issued.
019d759clist nfse received
Lists all NFS-e documents received (tomadas) by your company.
019d759csend cc e
Sends a Correction Letter (CC-e) for an NF-e document.
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 Admin, 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
Listen up. Focus Admin hooks your AI client right into the Focus NFe API so you can manage all your fiscal documents. You can send Correction Letters (CC-e) for NF-e, or cancel a CC-e you sent before. You'll also control the numbering ranges, marking specific NF-e numbers as unusable using inutilize_numbering.
Need to pull the raw data or the PDF? You can download the XML file for a specific NF-e event using download_event_xml, or get the full XML or the PDF version (DANFE) for an NF-e document. You can also list all NF-e documents that were issued or received between two dates with list_nfe_by_period, and check all NFS-e documents your company issued using list_nfse_emitted or all NFS-e documents received using list_nfse_received.
For distribution, you can find and distribute DF-e documents for your CNPJ using a specific NSU with distribute_dfe. Finally, you can download the raw XML file for a specific NF-e document with download_nfe_xml or the PDF version (DANFE) with download_nfe_danfe.
How Focus Admin MCP Works
- 1 Subscribe to the server and provide your Focus NFe API Token and Base URL.
- 2 Your AI client sends a natural language request (e.g., 'List all NF-e from March 2026').
- 3 The agent selects and runs the appropriate tool (e.g.,
list_nfe_by_period), and the result is returned to you.
The bottom line is you manage complex fiscal operations without ever logging into the dedicated tax portal.
Who Is Focus Admin MCP For?
The Fiscal Analyst who needs to fix a document error (like a CC-e) without touching a dashboard. The Accounting Manager who needs to pull bulk data (XML/DANFE) across multiple periods. Or the Compliance Officer who must verify document distribution and audit history on demand.
Issues Correction Letters (CC-e) or marks document numbering ranges as unused when discrepancies appear.
Downloads XML and DANFE PDFs in bulk and lists documents issued or received across a specific date range.
Verifies document distribution (DF-e) and checks the complete history of received invoices (NFS-e).
What Changes When You Connect
- You can fix document errors immediately. Use
send_cc_eto issue a Correction Letter orcancel_cc_eto reverse a mistake, without navigating a dedicated web form. - Audit your entire document history. The
list_nfe_by_periodtool lets you pull all NF-e or NFS-e records issued or received over a custom date range, which is critical for tax filing. - Control your document numbering. If a sequence of NF-e numbers is lost or damaged, you use
inutilize_numberingto officially mark that range as unusable. - Get the file you need, instantly. Instead of downloading from a portal, you call
download_nfe_xmlfor the raw data, ordownload_nfe_danfefor the PDF. - Verify document circulation. The
distribute_dfetool handles querying and distributing DF-e documents using a specific NSU, keeping your compliance records clean. - Handle municipal tax records. Use
list_nfse_emittedorlist_nfse_receivedto track Service Invoices (NFS-e) separately from standard product invoices (NF-e).
Real-World Use Cases
Client needs to correct a tax invoice.
A client finds a minor data error on a shipped NF-e. Instead of manually logging into the tax portal and filling out forms, they ask their agent: 'Send a CC-e for NF-e REF-001 correcting the buyer's phone number.' The agent runs send_cc_e and confirms the correction protocol.
Month-end audit of service invoices.
The accounting team needs to reconcile all service invoices (NFS-e) from the last quarter. They prompt: 'List all NFS-e received by CNPJ X from 2026-01-01 to 2026-03-31.' The agent uses list_nfse_received and returns a clean list of documents.
Lost document number range.
The operations team realizes numbers 1000 through 1050 in a series are unusable. They instruct the agent: 'Inutilize NF-e numbering from 1000 to 1050.' The agent runs inutilize_numbering and confirms the range is marked as unavailable.
Need historical data for compliance.
A compliance officer needs to prove all tax documents related to a specific CNPJ were handled. They ask the agent to list_nfe_by_period for the last year. The agent aggregates all necessary data, solving the manual retrieval problem.
The Tradeoffs
Manually checking document status.
Logging into the tax portal, finding the document, and manually checking if a CC-e was issued or if the number was invalidated. This takes multiple logins and searching through complex menus.
→
Use send_cc_e or cancel_cc_e directly through your AI agent. The agent handles the necessary API calls and confirms the status in plain text, skipping the portal entirely.
Downloading files one by one.
Needing 10 XML files for a tax audit. The current process forces you to download each file individually, leading to repetitive clicks and a massive waste of time.
→
Use download_nfe_xml or download_nfe_danfe by referencing the document ID in a single prompt. For bulk listing, use list_nfe_by_period first, then request the downloads.
Guessing the right document type.
Confusing NF-e (goods) documents with NFS-e (services) documents, and running the wrong query, resulting in incomplete tax records.
→
Be specific in your prompt. Use dedicated tools like list_nfe_by_period for goods and list_nfse_emitted for services. The agent knows which tool to call based on your input.
When It Fits, When It Doesn't
Use this if your job requires managing the full lifecycle of electronic fiscal documents (NF-e, NFS-e). You need to perform state changes (like sending a CC-e or inutilizing numbers) or retrieve structured data (like listing records by date). Don't use this if you only need general tax advice or need to manually input data into a spreadsheet; the tools read and modify records, they don't create new business logic. If your task is simply viewing a dashboard without any API interaction, you don't need this server.
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 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually tracking tax document changes is a nightmare.
Today, fixing a simple tax document error means logging into the tax authority's portal. You have to find the original NF-e, navigate to the correction section, and manually submit the CC-e form. Then you have to download the confirmation PDF just to prove you did it.
With Focus Admin, you just tell your agent to 'Send a CC-e for NF-e X correcting the buyer's phone number.' The agent calls `send_cc_e` and gives you the confirmation protocol number—no logins, no forms, just the result.
Use Focus Admin to manage fiscal records with `list_nfe_by_period`.
Instead of exporting data from multiple internal systems and trying to match document IDs against a separate compliance report, you ask the agent to 'List all NF-e documents for CNPJ X from March 1 to March 31.' The agent runs `list_nfe_by_period` and returns a single, comprehensive list of records for that time frame.
You get a single, verifiable data source that cuts out the manual comparison steps. You don't piece together reports; you ask for the whole picture.
Common Questions About Focus Admin MCP
How do I use the `send_cc_e` tool with Focus Admin? +
To send a CC-e, you must provide the NF-e reference number and the specific correction details (e.g., 'correcting the buyer's phone number'). The agent executes the send_cc_e call and reports the new protocol number.
Can I use `list_nfe_by_period` to find service invoices? +
No, list_nfe_by_period only lists standard goods invoices (NF-e). Use list_nfse_received or list_nfse_emitted for service invoices (NFS-e) instead.
What is the difference between `download_nfe_xml` and `download_nfe_danfe`? +
The difference is the format. download_nfe_xml gets the raw, machine-readable XML file. download_nfe_danfe gets the PDF version (DANFE) that's meant for human viewing.
How do I invalidate document numbers with `inutilize_numbering`? +
You must specify the exact range of numbers and the series/model. For example, 'Inutilize NF-e numbering from 1000 to 1050 for series 1.' The agent runs inutilize_numbering and confirms the range is unusable.
Does `distribute_dfe` handle NF-e documents? +
No, distribute_dfe is specifically for distributing DF-e documents. You need to use download_nfe_xml or download_nfe_danfe for the standard NF-e documents.
How do I download a specific NF-e document's XML using `download_event_xml`? +
You must provide the specific event ID and the NF-e number. The tool downloads the XML for single events like manifestations or CC-e creation, not the whole invoice. You'll need to specify what event you're looking for.
What happens if I try to cancel a CC-e that has already been used with `cancel_cc_e`? +
The system returns an error code. You can't cancel a CC-e if the associated NF-e is already processed or used. Always verify the status of the original CC-e first.
Can I list all NFS-e documents using `list_nfse_emitted` and `list_nfse_received`? +
Yes, these tools handle service invoices (NFS-e). Use list_nfse_emitted to see documents your company issued, and list_nfse_received for service invoices received (tomadas). They operate independently.
What is a CC-e (Carta de Correção)? +
CC-e is a Correction Letter used to fix minor errors in an authorized NF-e, such as typos in the buyer's address or product descriptions. It cannot be used to change values, quantities, or tax rates.
When should I use Inutilização? +
Use Inutilização when a range of NF-e numbering has been damaged, lost, or will not be used. This tells the tax authority that those numbers are intentionally skipped.
What is DF-e Distribution? +
DF-e Distribution allows you to query all fiscal documents (NF-e, CT-e, etc.) issued against your CNPJ. Use it with the last NSU to retrieve only new documents.
Can I automate my accounting department with this? +
Yes! The 'List by Period' and 'Download XML & DANFE' tools allow your AI agent to fetch all invoices from a specific month, download the XMLs, and seamlessly integrate them into accounting workflows.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Classe365
Run your educational institution with student information management, admissions tracking, and academic planning in one platform.
Wave Financial
Manage your accounting via Wave Financial — query businesses, invoices, customers, and transactions directly from any AI agent.
Microsoft Dynamics 365
Manage accounts, opportunities, orders, and business processes on Microsoft Dynamics 365 — the unified CRM & ERP platform.
You might also like
Unsplash Extended
Access millions of high-resolution images — search photos, manage collections, and track download statistics directly from any AI agent.
Plaid Enterprise Banking
Ultimate Open Banking: balances, transactions, ML fraud logic, payroll, and asset verification.
Woodpecker
Equip your AI agent with direct access to Woodpecker — manage cold email sequences, track prospect engagement, and monitor deliverability without opening the Woodpecker platform.