NFe.io MCP for AI. Issue, validate, and manage Brazilian invoices.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
NFe.io MCP Server manages Brazilian fiscal documents. Your AI agent uses this server to issue, cancel, and retrieve service and merchandise invoices (NFS-e/NF-e).
It also validates municipal codes (IBGE) and maintains corporate tax metadata directly from your workflow.
What your AI can do
Cancel service invoice
Reverses an already issued service invoice (NFS-e).
Create company
Registers a new company entity, allowing it to issue invoices through NFe.io.
Get company details
Pulls detailed fiscal and tax information for a specific company issuer ID.
Create and issue both Service Invoices (NFS-e) and Merchandise Invoices (NF-e).
Reverse issued invoices using dedicated tools for service or merchandise types.
Get the full status and details of any existing invoice by its unique ID, including download links for PDF/XML.
List all registered companies or pull detailed tax metadata for a specific corporate issuer.
Check municipal compatibility and validate IBGE codes necessary for compliant invoicing.
Ask an AI about this
Waiting for input…
NFe.io MCP Server: 10 Tools for Brazilian Fiscal Operations
Your AI agent can use these tools to manage the full lifecycle of invoicing—from company setup and code validation to issuing, canceling, and retrieving all required fiscal documents.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using NFe.io on VinkiusCancel Service Invoice
Reverses an already issued service invoice (NFS-e).
Create Company
Registers a new company entity, allowing it to issue invoices through NFe.io.
Get Company Details
Pulls detailed fiscal and tax information for a specific company issuer ID.
Get Merchandise Invoice
Retrieves all details about an existing physical goods invoice (NF-e).
Get Service Invoice
Retrieves all details about an existing service invoice (NFS-e).
Issue Merchandise Invoice
Creates and issues a new physical goods invoice (NF-e) compliant with Brazilian tax rules.
Issue Service Invoice
Generates and issues a new service invoice (NFS-e) for billing services rendered.
List Companies
Provides a list of every company entity currently registered under your NFe.io...
List Webhooks
Lists all the external webhooks you have configured for notifications from NFe.io.
Cancel Merchandise Invoice
Reverses an already issued physical goods invoice (NF-e).
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The NFe.io integration is available immediately — no restart needed.
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 NFe.io, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ 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
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by NFe.io. 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 connection provides 10 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Manually tracking invoices across multiple tabs takes forever.
Right now, generating or checking an invoice status means jumping through hoops: logging into the portal, finding the client's tax ID, navigating to the correct document type (service vs. merchandise), and then hitting 'View Status.' If you need the XML for accounting, it’s another click, often leading to outdated data or a confusing error message.
With this MCP server, that whole process collapses into one call. You tell your agent what you need—say, 'Check invoice ID X'—and it runs `get_service_invoice`. The result isn't just text; it's the structured status and direct download links for both PDF and XML.
NFe.io MCP Server: Manage invoices & company details
Before, setting up a new client meant gathering tax codes, manually verifying the IBGE code, and ensuring your internal system matched the fiscal configuration—a process that risked compliance errors before you even sent the first bill.
Now, you run `get_company_details` to pull all necessary metadata in seconds. The agent validates the company's standing right there, letting you build reliable billing workflows without any manual tax research or data entry.
What your AI can actually do with this
Listen up. If you're dealing with Brazilian fiscal documents—the whole shebang of invoices and corporate tax stuff—you need NFe.io. This isn't some flimsy API wrapper; it's a full-stack MCP that manages the entire lifecycle of your financial records, from setting up a new entity to canceling an invoice years later.
Your AI agent connects here to handle all the complex state changes in Brazilian tax law for you.
Managing Your Corporate Identity
You gotta know who you are before you can bill anybody. You tell your agent to use create_company and it registers a brand new corporate entity, giving you the necessary ID to start issuing documents through NFe.io. If you've got multiple business fronts running, list_companies spits out every company registered under your account so you can pick the right one.
Need the deep details on one specific issuer? Run get_company_details. It pulls all the granular fiscal and tax metadata for that corporate ID—everything you need to know about their compliance status.
Issuing Invoices: Goods or Services
When it's time to bill, this server handles both types of transactions. You can generate a new physical goods invoice (the NF-e) by calling issue_merchandise_invoice. This tool makes sure the resulting document is compliant with all Brazilian tax rules for merchandise sales. If you're billing for services rendered—like consulting hours or setup fees—you use issue_service_invoice to generate the required service invoice (NFS-e).
Both functions create and issue the documents, making them instantly usable.
Retrieving and Correcting Invoices
Life happens, right? Sometimes an invoice needs correcting, or you just need a copy of what was issued. To pull up all the details for any existing physical goods invoice (NF-e), your agent uses get_merchandise_invoice with the unique ID. It doesn't just give you basic info; it pulls the full status and every detail about that specific merchandise document, including links to download both the PDF and XML files.
Same deal for services: get_service_invoice retrieves all the details for an existing service invoice (NFS-e). If an invoice needs reversing—whether it's goods or services—you use dedicated tools. To reverse a physical goods transaction, call cancel_merchandise_invoice. For services, you run cancel_service_invoice. These functions ensure the reversal is processed correctly through the system.
Advanced Operations and Webhooks
Beyond just invoices, this server handles backend setup too. If your business process requires external notifications—say, when an invoice changes status—you can use list_webhooks to see every single one of those configured endpoints. You also manage the credentials for your agent; if you ever need a list of all companies registered, running list_companies is your go-to move.
019d845f-7654-70b6-944e-0842ccc8c8f2 
Here's how it actually works
The bottom line is: You hand off the complex compliance logic to the server; your AI client just needs to know which action to trigger.
First, you subscribe to the NFe.io MCP Server and log into your dashboard.
Next, you pull the API Key and Company ID credentials required for issuing transactions.
Finally, you instruct your agent (e.g., 'Issue an NFS-e for this client') and it runs the appropriate tool against the live Brazilian fiscal system.
Who is this actually for?
This is for SaaS developers building B2B platforms in Brazil, or finance teams who are tired of manually cross-referencing company tax status and invoice records across multiple dashboards. If your job involves generating revenue documents compliant with Brazilian law, you need this.
You integrate the issue_service_invoice tool into a client-facing workflow so that billing happens automatically when a user signs up.
You use the agent to bulk check and retrieve XML files for monthly reconciliation, pulling data via tools like get_service_invoice.
You monitor company records using list_companies before a major contract signing to ensure the legal entity is properly set up for invoicing.
What Changes When You Connect
Automated Billing: Instead of writing complex integration code for every tax rule, use issue_service_invoice to generate compliant NFS-e documents in one call. Your agent handles the state changes; you just provide the payload.
Instant Status Checks: Need to know if an invoice cleared? Use get_merchandise_invoice or get_service_invoice. You get immediate status updates and download links for both PDF and XML, eliminating manual portal checks.
Compliance Guardrails: Before billing, validate the location. The server lets you check municipal compatibility using IBGE codes, stopping failed invoices before they even start. This prevents costly failures down the line.
Company Setup Made Simple: Don't manually set up every client. Use create_company to register a new issuer and then use get_company_details to pull their tax metadata for immediate billing readiness.
Audit Trail Management: When an invoice needs adjustment, don't guess the process. Explicitly run cancel_service_invoice to ensure proper reversal records are created, keeping your books clean.
See it in action
Client Onboarding and Billing
A new client signs up (Problem). The agent first runs get_company_details using the provided CNPJ to check their tax status. If good, it then uses issue_service_invoice, generating the required NFS-e document automatically for billing.
Post-Sale Adjustment
A client reports an error on a recent invoice (Problem). The agent first runs get_service_invoice to pull the original ID and status. Once verified, it uses cancel_service_invoice before issuing a corrected replacement.
Bulk Reconciliation
The accounting team needs monthly records (Problem). The agent executes list_companies, gets a list of all entities, and then iterates through them using get_merchandise_invoice to pull all necessary XML data for reconciliation.
System Health Check
You need to know if your webhook setup is accurate (Problem). The agent runs list_webhooks first, and then uses the resulting list to confirm that every required billing event has a configured notification endpoint.
The honest tradeoffs
Assuming Data Consistency
The developer tries to issue an invoice (issue_service_invoice) without first confirming the client's tax status, leading to immediate API rejection and a failed transaction.
Always run get_company_details first. Validate that the company is active before calling any issuance tools. Use this sequence: get_company_details $\rightarrow$ check response $\rightarrow$ issue_service_invoice.
Mixing Invoice Types
Trying to cancel a merchandise invoice (cancel_merchandise_invoice) using the service invoice ID, causing the system to fail due to mismatched record types.
Always use the dedicated tool for the document type. For physical goods, use get_merchandise_invoice and cancel_merchandise_invoice. For services, use the 'service' tools.
Overlooking Webhooks
Building a system that relies on invoice status changes but forgets to check if webhooks are set up (list_webhooks), causing the downstream service to stall silently.
Before launching any critical workflow, run list_webhooks to verify which events (e.g., 'invoice_issued') have active listeners.
When It Fits, When It Doesn't
Use this MCP Server if your primary need is generating, managing, or validating invoices that must adhere to specific Brazilian fiscal compliance standards. You'll use it when the transaction involves tax codes (IBGE) or requires official document generation (PDF/XML).
Don't use this server if you only need simple record-keeping—if your internal system already tracks invoice status and doesn't require official government-mandated receipts, stick with your existing database. Also, don't use it just because you want to list companies; always pair list_companies with get_company_details if you need the actual tax metadata for billing.
This is a transactional tool. If failure handling and compliance are non-negotiable, this server provides the necessary structure.
Questions you might have
How do I cancel a service invoice using the `cancel_service_invoice` tool? +
You pass the specific Service Invoice ID to the tool. The server handles the reversal process and ensures all necessary accounting adjustments are recorded automatically.
Which tool should I use to list all my registered companies? Use `list_companies`. +
list_companies pulls a complete roster of every company entity associated with your account. This is the first step if you need to know which entities are available for billing.
I need to get the XML and PDF links for an invoice. Which tool should I use? Use `get_service_invoice` or `get_merchandise_invoice`. +
Both retrieval tools (get_service_invoice/get_merchandise_invoice) return a detailed payload that includes direct download links for both the PDF and XML versions, making them perfect for automated reporting.
What is the best way to start a new invoicing workflow? Use `create_company` first. +
create_company registers a new issuer entity in NFe.io. This must happen before you can successfully issue any invoices for that specific legal entity.
Before I run `get_company_details`, what credentials do I need for authentication? +
You must use an API Key and your Company ID. The server requires these two parameters to authenticate the request. Always grab your keys from the NFe.io Dashboard settings before calling any company-specific tool.
If I use `issue_service_invoice` with incorrect fiscal data, how do I know what went wrong? +
The tool returns a structured error code and message. It doesn't just fail; it tells you exactly which field—like the IBGE code or tax ID—is incompatible with Brazilian standards. Check the response payload for specific validation errors.
How can I monitor real-time updates using `list_webhooks`? +
You don't use list_webhooks to receive data; you use it to see what webhooks are configured. To actually monitor changes, you must set up a webhook endpoint in the NFe.io Dashboard that points back to your system.
When I run `get_merchandise_invoice`, does it provide all related tax metadata? +
Yes, it provides a detailed payload containing not only the invoice status but also the associated fiscal records and tax coefficients. This means your AI agent gets enough data to process compliance reports without needing extra calls.
Can my AI automatically issue an NFS-e for a specific customer? +
Yes! Use the issue_service_invoice tool with the Company ID and a JSON payload containing the customer data and service values. Your agent will trigger the issuance process with the relevant municipality.
How do I find the correct IBGE code for a Brazilian city? +
You can use the list_cities tool to search for municipalities by name or state. The agent will return the official IBGE codes required for fiscal document validation.
Can I retrieve the download link for an invoice PDF? +
Yes! Use the get_service_invoice tool with the unique Invoice ID. Your agent will return the metadata, including official links to download the PDF and XML versions of the document.
We've already built the connector for NFe.io. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 10 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.