NFe.io Connector for AI agents.
10 live capabilities
Automate Brazilian NFS-e service invoices and municipal tax compliance.
Waiting for input…
Why people use NFe.io
NFe.io for Automating Brazilian NFS-e Tax Compliance
With this Connector, your agent handles those steps for you. It pulls the correct codes, issues the NFS-e, and grabs the download links in one go. You get a clean workflow where the agent does the heavy lifting and you just check the results.
What Vinkius changes
That you turn your AI into a Brazilian tax clerk that handles the paperwork for you.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
SaaS Billing Automation
A founder asks the agent to issue a service invoice for a new customer in São Paulo.
- Real-world use case 02
Audit Preparation
An accountant asks the agent to find all XML files for last month's invoices.
- Real-world use case 03
Company Onboarding
An ops person asks the agent to register a new company for a new branch.
Complete set · 10capabilities
The complete NFe.io capability set.
These are the exact actions your AI can choose when you ask it to work with NFe.io.
01—04
4 capabilities in this set.
Part of 10 available through NFe.io.
- 01 Capability
Cancel service invoice
Cancels a previously issued Service Invoice (NFS-e). This is useful for voiding incorrect service charges.
- 02 Capability
Create company
Registers a new company issuer in your NFe.io account. Use this to set up new business entities for invoicing.
- 03 Capability
Cancel merchandise invoice
Cancels a previously issued Merchandise Invoice (NF-e). It helps you quickly void incorrect shipping documents.
- 04 Capability
Get company details
Pulls detailed fiscal information for a specific company issuer. It helps you check current configurations before issuing docs.
05—07
3 capabilities in this set.
Part of 10 available through NFe.io.
- 05 Capability
Get merchandise invoice
Retrieves the full details of a specific Merchandise Invoice (NF-e). Use this to check the status of a goods shipment.
- 06 Capability
Get service invoice
Retrieves the full details of a specific Service Invoice (NFS-e). This lets you see the status of a service charge.
- 07 Capability
Issue merchandise invoice
Generates a new Merchandise Invoice (NF-e) for goods. Use this to create shipping documents for products.
08—10
3 capabilities in this set.
Part of 10 available through NFe.io.
- 08 Capability
Issue service invoice
Generates a new Service Invoice (NFS-e) for services. This is the primary capability for billing service-based customers.
- 09 Capability
List companies
Shows all companies currently registered in your account. Use this to find the correct issuer ID for an invoice.
- 10 Capability
List webhooks
Displays all configured webhooks in your account. This helps you monitor real-time events for your invoices.
Set up in minutes
One URL. Then ask NFe.io to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use NFe.io from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_qnxTvOplXh9uce8AMFJ0y3HxvwIx1fg8AXlunLyq/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it NFe.io, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable NFe.io for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_qnxTvOplXh9uce8AMFJ0y3HxvwIx1fg8AXlunLyq/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the NFe.io URL.
- Step 03
Save and start
Save the connection and enable NFe.io in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"nfeio": {
"url": "https://edge.vinkius.com/vk_preview_qnxTvOplXh9uce8AMFJ0y3HxvwIx1fg8AXlunLyq/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using NFe.io
Open Agent mode in chat and ask: "Using NFe.io, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"nfeio": {
"url": "https://edge.vinkius.com/vk_preview_qnxTvOplXh9uce8AMFJ0y3HxvwIx1fg8AXlunLyq/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using NFe.io
Ask Copilot: "Using NFe.io, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"nfeio": {
"url": "https://edge.vinkius.com/vk_preview_qnxTvOplXh9uce8AMFJ0y3HxvwIx1fg8AXlunLyq/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using NFe.io
Open Cascade and ask: "Using NFe.io, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"nfeio": {
"url": "https://edge.vinkius.com/vk_preview_qnxTvOplXh9uce8AMFJ0y3HxvwIx1fg8AXlunLyq/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using NFe.io
Ask Cline: "Using NFe.io, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add nfeio --transport http "https://edge.vinkius.com/vk_preview_qnxTvOplXh9uce8AMFJ0y3HxvwIx1fg8AXlunLyq/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using NFe.io
Ask Claude: "Using NFe.io, show me...". 10 tools are ready
Where the request belongs
Work NFe.io can move forward.
This is for the Brazilian SaaS founder who is tired of manual invoicing and the accountant who needs to pull hundreds of XML files for tax season without clicking through dozens of tabs.
Brazilian SaaS Founder
Automates recurring billing for customers across different states and cities.
Tax Accountant
Pulls monthly invoice summaries and XML files for audit preparation.
Finance Operations Manager
Validates city codes and manages company fiscal configurations for new branches.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse Connectors
PIS/COFINS Tax Calculator
Calculate PIS and COFINS tax liabilities for cumulative and non-cumulative regimes.
NF-e Access Key Validator
Validate the structural integrity and compliance of Brazilian NF-e access keys.
DAS Payment Scheduler
Automated annual calendar generator for Brazilian Simples Nacional tax payments, handling holiday-based date shifts and overdue period alerts.
ICMS Calculator
Calculate Brazilian ICMS taxes, including tax substitution (ST), tax differentials (DIFAL), and tax-inclusive base calculations.
Focus NFe
Emit, consult, cancel and download XML for NFS-e and NF-e via Focus NFe API.
Focus Varejo
Emit NFC-e, NFCom, manifest documents and manage retail invoices via Focus NFe API.
Bring your own AI
Change the model, client or framework. Keep NFe.io connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about NFe.io.
The practical details behind the request, access and result.
Does NFe.io MCP support all Brazilian cities?
Yes, it validates IBGE codes for cities across Brazil to ensure your service invoices are compliant with local municipal rules.
Can I use NFe.io to issue service invoices?
Yes, it is designed to issue Service Invoices (NFS-e) directly through your AI client for customers in different Brazilian cities.
Can the AI agent download the XML files for me?
Yes, the Connector retrieves the direct download links for both PDF and XML documents so you can save them to your records instantly.
Is NFe.io good for Brazilian SaaS businesses?
It is ideal for SaaS companies that need to automate recurring service invoices for customers across various Brazilian states.
How do I manage different companies in NFe.io?
You can list all registered companies in your account and pull specific details for each one to ensure correct fiscal configurations.
Can I cancel an invoice if I made a mistake?
Yes, you can ask your agent to cancel either a service or a merchandise invoice if you need to void an incorrect document.
Can my AI automatically issue an NFS-e for a specific customer?
Yes! Use the issue_service_invoice capability 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 capability 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 capability with the unique Invoice ID. Your agent will return the metadata, including official links to download the PDF and XML versions of the document.
One connection away
Give your agent a direct line to NFe.io.
Connect NFe.io once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available