How to Use the NFe.io MCP in Cline

Q: Can Cline write code to handle NFe.io invoice cancellations?

Yes. Cline uses cancelserviceinvoice to test cancellation flows. It writes the backend endpoint inside VS Code, triggers the tool to verify the API response, and commits the code once the test passes.

Q: How does Cline authenticate with the NFe.io MCP Server?

Cline reads your API keys from clinemcpsettings.json. Once configured, Cline can call tools like listcompanies to pull issuer details directly into your workspace.

Q: How does Cline handle invalid city codes?

Cline catches the validation error from issueserviceinvoice and searches your VS Code workspace for the city mapping file. It then updates the local JSON dictionary to prevent future failures.

Let Cline build your billing integrations and issue NFe.io tax invoices directly from VS Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NFe.io MCP to Cline

Create your Vinkius account to connect NFe.io to Cline 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 NFe.io with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

End-to-end tax integration with Cline MCP Server

The `issue_service_invoice` and `issue_merchandise_invoice` tools allow Cline to build and test your billing pipeline in real-time. Cline doesn't just write the code; it executes these tools to verify that your system generates valid Brazilian tax documents.

Automatic invoice retrieval and debugging in Cline

The `get_service_invoice` and `get_merchandise_invoice` tools let Cline inspect the exact JSON payloads returned by the Brazilian government. When an invoice fails, Cline pulls the data to debug the schema errors directly in VS Code.

Sync company profiles and webhooks with Cline

The `list_companies` and `list_webhooks` tools give Cline complete visibility into your NFe.io account configuration. Cline uses this data to map your local environment variables to the correct company IDs.

Setup guide

Set up NFe.io MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type nfeio-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest NFe.io refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "nfeio-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 NFe.io. 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 NFe.io 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 NFe.io MCP in Cline

Yes. Cline uses `cancel_service_invoice` to test cancellation flows. It writes the backend endpoint inside VS Code, triggers the tool to verify the API response, and commits the code once the test passes.

Cline reads your API keys from `cline_mcp_settings.json`. Once configured, Cline can call tools like `list_companies` to pull issuer details directly into your workspace.

Yes. You can ask Cline to verify your active issuers, and it will run `list_companies` followed by `get_company_details` to compile a report directly in your VS Code editor.

Cline catches the validation error from `issue_service_invoice` and searches your VS Code workspace for the city mapping file. It then updates the local JSON dictionary to prevent future failures.

All sensitive payload data, including CNPJ numbers and invoice values, is processed locally within VS Code and the secure Vinkius MCP runtime. Cline never uploads your raw NFe.io credentials or customer tax records to third-party 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