NFe.io MCP. Issue, validate, and manage Brazilian invoices.

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.