How to Use the BrasilAPI MCP in Cline

Q: How does Cline handle errors when a CEP is not found on BrasilAPI?

If getcepdetails returns an error for an invalid postal code, Cline analyzes the failure message. It then writes error-handling logic into your code to gracefully catch invalid inputs.

Let Cline write code, build tests, and populate databases using live BrasilAPI data directly in 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 BrasilAPI MCP to Cline

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Cline write integration tests with real Brazilian data

Cline uses the BrasilAPI MCP Server to run `get_cnpj_details` to fetch actual corporate records and write unit tests for your checkout pipeline. It creates mock data files using real-world registry information instead of placeholder text. When writing address validation tests, Cline runs `get_cep_details` to fetch valid postal structures. It inserts these directly into your test suite and runs the test command in your terminal to verify everything passes.

Populate database tables with current Brazilian bank details

Cline calls `list_brazilian_banks` to pull the complete roster of active financial institutions. It then writes a migration script to populate your database with official bank codes. To organize your users by region, Cline uses `list_brazilian_states` to fetch the standard state codes. It updates your database seeds and edits your frontend dropdowns to match the official IBGE list.

Build automated vehicle pricing dashboards with the FIPE tool

Cline calls `get_fipe_vehicle_price` to fetch current market valuations for cars, motorcycles, or trucks. It creates a dashboard component in your project, imports the pricing logic, and configures the API calls. Because Cline has full terminal access, it installs any required plotting libraries and runs your local development server. You can see the live vehicle data rendered in your UI without manually writing a single fetch request.

Setup guide

Set up BrasilAPI 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 brasilapi-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 BrasilAPI 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": {
    "brasilapi-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 BrasilAPI. 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 BrasilAPI 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 BrasilAPI MCP in Cline

Open the Cline sidebar, click the MCP icon, and add the server URL under the remote servers tab. Cline will instantly load all six tools, making them available for your coding tasks.

Yes, Cline can generate a Node.js or Python script that calls `get_fipe_vehicle_price`. It will write the code, configure the scheduler, and test the execution directly in your workspace.

If `get_cep_details` returns an error for an invalid postal code, Cline analyzes the failure message. It then writes error-handling logic into your code to gracefully catch invalid inputs.

Yes, you can instruct Cline to build a searchable select component. It will fetch the bank roster using `list_brazilian_banks` and write the React or Vue code to display them.

Yes, all queries are processed in our zero-trust V8 sandbox. We do not log or persist any of the CNPJ records, FIPE vehicle codes, or CEP details that Cline requests.

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