How to Use the Focus NFe MCP in Windsurf

Q: How do I configure the Focus NFe MCP server in my Windsurf workspace?

Open your Windsurf settings and add the server to your mcpconfig.json file. Once saved, Cascade immediately discovers the tools and lets you start issuing Brazilian tax documents.

Q: What happens if a municipal service invoice endpoint goes down?

The emitnfse tool returns the specific error code from the local prefeitura. Your agent reads this response and can write a retry loop or log the failure to your database for later processing.

Let Windsurf autonomously chain Brazilian invoice emission and XML downloads directly inside your Cascade workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Focus NFe MCP to Windsurf

Create your Vinkius account to connect Focus NFe to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Focus NFe with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Brazilian Product Invoice Generation

The `emit_nfe` tool executes product invoice emissions directly through your Cascade agent. Windsurf reads your payload context, formats the JSON according to SEFAZ rules, and sends the request without manual field mapping. If the emission returns a validation error, Cascade reads the response and fixes the payload on the fly. You get a fully authorized invoice in seconds instead of debugging XML structures manually.

Automated Service Invoice Workflows

The `emit_nfse` tool handles municipal tax document generation inside your Windsurf workspace. This tool abstracts the mess of dealing with hundreds of different city prefeitura schemas into a single call. Cascade chains this with other tools to pull client data from your database and generate the invoice. It handles the entire sequence from data retrieval to final emission in one autonomous run.

Instant Document Status Checks and Downloads

The `consult_document` tool retrieves real-time status updates for any issued tax document using our MCP server. Your Windsurf agent calls this to verify SEFAZ authorization before proceeding with logistics or billing updates. Once authorized, Cascade triggers `download_xml` to grab the official file and store it in your local directory. If you need to revert a transaction, the agent uses `cancel_document` to handle the rollback.

Setup guide

Set up Focus NFe MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Focus NFe MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Focus NFe payment history." If connected, Cascade will call the Focus NFe tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "focus-nfe-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Focus NFe now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Focus NFe MCP in Windsurf

Windsurf reads the validation error returned by the MCP server. Cascade then scans your local code or database mapping, corrects the tax code or recipient detail, and retries the emission automatically.

Yes. You ask Cascade to process a list of pending transactions. It chains multiple `emit_nfe` or `emit_nfse` calls, checking the status of each document sequentially without needing manual prompts for every step.

Open your Windsurf settings and add the server to your mcp_config.json file. Once saved, Cascade immediately discovers the tools and lets you start issuing Brazilian tax documents.

The `emit_nfse` tool returns the specific error code from the local prefeitura. Your agent reads this response and can write a retry loop or log the failure to your database for later processing.

All XML data and fiscal payloads containing sensitive corporate tax IDs process locally in a secure sandbox. The server routes requests directly to the Focus NFe API without storing your invoice data on external servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript