NFe.io MCP Server for Windsurf 10 tools — connect in under 2 minutes
Windsurf brings agentic AI coding to a purpose-built IDE. Connect NFe.io through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
ASK AI ABOUT THIS MCP SERVER
Vinkius supports streamable HTTP and SSE.
Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install NFe.io and 2,500+ MCP Servers from a single visual interface.
{
"mcpServers": {
"nfeio": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About NFe.io MCP Server
Connect your AI agents to NFe.io, the leading Brazilian platform for fiscal document automation. This MCP provides 10 tools to manage the full lifecycle of Service Invoices (NFS-e), validate Brazilian municipal codes (IBGE), and monitor corporate metadata for companies integrated into your billing environment.
Windsurf's Cascade agent chains multiple NFe.io tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 10 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
What you can do
- Invoice Orchestration — Issue, cancel, and retrieve Service Invoices (NFS-e) for multiple cities across Brazil
- Company Management — List and inspect registered companies and their current fiscal configurations
- Service Definition — Manage service codes and tax metadata to ensure accurate fiscal reporting
- Fiscal Intelligence — Retrieve detailed city capabilities and validate IBGE codes for seamless municipal integration
- PDF Retrieval — Generate and retrieve download links for official invoice PDF and XML documents programmatically
The NFe.io MCP Server exposes 10 tools through the Vinkius. Connect it to Windsurf in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
How to Connect NFe.io to Windsurf via MCP
Follow these steps to integrate the NFe.io MCP Server with Windsurf.
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Add the server
Paste the JSON configuration above into mcp_config.json
Save and reload
Windsurf will detect the new server automatically
Start using NFe.io
Open Cascade and ask: "Using NFe.io, help me...". 10 tools available
Why Use Windsurf with the NFe.io MCP Server
Windsurf provides unique advantages when paired with NFe.io through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 10 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
NFe.io + Windsurf Use Cases
Practical scenarios where Windsurf combined with the NFe.io MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from NFe.io and generate models, types, or handlers based on real API responses
Live debugging: query NFe.io tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from NFe.io and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine NFe.io data with Cascade's code generation to scaffold entire features in minutes
NFe.io MCP Tools for Windsurf (10)
These 10 tools become available when you connect NFe.io to Windsurf via MCP:
cancel_merchandise_invoice
Cancel an issued Merchandise Invoice (NF-e)
cancel_service_invoice
Cancel an issued Service Invoice (NFS-e)
create_company
Register a new company (issuer) in NFe.io
get_company_details
Get detailed info for a specific company issuer
get_merchandise_invoice
Retrieve details for a specific Merchandise Invoice (NF-e)
get_service_invoice
Retrieve details for a specific Service Invoice (NFS-e)
issue_merchandise_invoice
Issue a Merchandise Invoice (NF-e)
issue_service_invoice
Issue a Service Invoice (NFS-e)
list_companies
List all companies (issuers) registered in your NFe.io account
list_webhooks
List all configured webhooks in NFe.io
Example Prompts for NFe.io in Windsurf
Ready-to-use prompts you can give your Windsurf agent to start working with NFe.io immediately.
"List all active companies in my NFe.io account."
"Check the status of service invoice ID 'inv_nfe_999888'."
"Find the IBGE code for the city of 'São Paulo'."
Troubleshooting NFe.io MCP Server with Windsurf
Common issues when connecting NFe.io to Windsurf through the Vinkius, and how to resolve them.
Server not connecting
NFe.io + Windsurf FAQ
Common questions about integrating NFe.io MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Connect NFe.io with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
Type-safe agent development for Python with first-class MCP support.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Connect NFe.io to Windsurf
Get your token, paste the configuration, and start using 10 tools in under 2 minutes. No API key management needed.