How to Use the Focus Varejo MCP in Windsurf

Q: How does Focus Varejo handle high-volume sales inside Windsurf?

Cascade runs a loop that calls emitnfce for each transaction, handling the queue in the background. It catches network errors and retries automatically without requiring your manual intervention.

Q: Does Windsurf Cascade support automated error correction for Focus Varejo?

It does. If emitnfce returns a validation error due to a missing postal code, Cascade reads the schema, fixes the payload, and re-submits the invoice autonomously using the MCP Server.

Q: How do I monitor incoming service invoices?

Your agent uses listreceivednfse to pull all NFS-e documents issued to your tax ID. It can then parse the XML payloads and log them into your local accounting database.

Issue Brazilian retail invoices and manifest inbound cargo autonomously using Windsurf Cascade.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Focus Varejo MCP to Windsurf

Create your Vinkius account to connect Focus Varejo 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 Varejo with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated retail checkouts

Windsurf Cascade handles the entire sales pipeline by executing `emit_nfce` the second a transaction completes. Because Cascade chains actions without asking for step-by-step approval, your agent registers the sale, gets the tax response, and updates your ledger without interrupting your dev flow. If a transaction fails or needs a quick reversal, Cascade can autonomously call `cancel_nfce` to void the document. It reads the error codes directly from the Focus Varejo MCP Server, correcting common input mistakes on the fly without making you click through menus.

Inbound cargo manifestation

Managing incoming freight requires multiple steps that Cascade handles by calling `manifest_nfe` to confirm receipt of goods. The agent observes your incoming logistics queue and executes the correct actions sequentially. To acknowledge transport documents from shipping partners, the agent can also trigger `manifest_cte`. You don't have to write custom cron jobs when Cascade can handle these multi-step tax filings on its own.

Telecom invoice auditing

Telecommunication services require specialized billing documents that your agent generates using `emit_nfcom`. This tool verifies that each entry complies with current state tax regulations before submission. When an audit is needed, your agent invokes `consult_nfcom` to verify historical statuses. This MCP Server setup ensures your billing records match SEFAZ registries without manual data entry.

Setup guide

Set up Focus Varejo 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 Varejo 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 Varejo payment history." If connected, Cascade will call the Focus Varejo tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "focus-varejo-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 Varejo 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 Varejo MCP in Windsurf

Cascade runs a loop that calls `emit_nfce` for each transaction, handling the queue in the background. It catches network errors and retries automatically without requiring your manual intervention.

Yes, you just point the MCP Server to the Focus NFe staging environment. Cascade can run test transactions and inspect the responses using `consult_nfce` before you push to production.

It does. If `emit_nfce` returns a validation error due to a missing postal code, Cascade reads the schema, fixes the payload, and re-submits the invoice autonomously using the MCP Server.

Your agent uses `list_received_nfse` to pull all NFS-e documents issued to your tax ID. It can then parse the XML payloads and log them into your local accounting database.

Your tax ID, invoice values, and customer details never leave your local Windsurf instance except when sent directly to the Focus NFe API. The connection uses a secure, single endpoint token managed by Vinkius, meaning no raw API credentials are ever exposed in your workspace.

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