How to Use the BrasilAPI MCP in VS Code Copilot

Q: How do I configure the BrasilAPI MCP server for my entire team in VS Code Copilot?

Create a .vscode/mcp.json file in your repository root and add the BrasilAPI server configuration. Once committed to Git, any team member opening the workspace in VS Code Copilot automatically inherits these tools without manual setup.

Q: Which tools are available for financial applications in this MCP server?

Your agent can access listbrazilianbanks to verify bank codes, and getcnpjdetails to inspect corporate tax IDs. These tools allow your editor to write and verify financial validation logic using real-time institutional data.

Lookup Brazilian CNPJ, CEP, and bank details right inside VS Code Copilot with this secure, team-wide BrasilAPI integration.

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 VS Code Copilot

Create your Vinkius account to connect BrasilAPI to VS Code Copilot 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Validate Brazilian Data inside VS Code Copilot

Stop leaving your editor to double-check postal codes or bank routing numbers when writing tests or seeding databases. Your VS Code Copilot agent can now run `get_cep_details` and `list_brazilian_banks` directly on your workspace files to verify user inputs or generate accurate mock data. This means you can highlight a list of raw CEP codes in a JSON file and tell Copilot to fill in the missing state and city names. It uses the raw API response to update your code in place, saving your team from manual lookups.

Audit CNPJ and State Records via MCP

Verify corporate registry details without writing custom API scrapers or leaving your terminal view. By adding this MCP server to your project, VS Code Copilot calls `get_cnpj_details` and `list_brazilian_states` to pull official IBGE and registry records directly into your active workspace. If you are building billing pipelines or customer onboarding flows, your editor can inspect your database schemas and write validation logic based on real CNPJ structures. Your team commits the config, and everyone instantly gets the same data-fetching power.

FIPE Vehicle Pricing and Holiday Calendars

Calculate vehicle depreciation or build regional checkout calendars without hardcoding static arrays. Your VS Code Copilot chat window uses `get_fipe_vehicle_price` and `get_brazilian_holidays` to inject live FIPE tables and national holiday dates directly into your code. Your team no longer has to guess if a specific date is a banking holiday in São Paulo or if a vehicle valuation is outdated. Copilot queries the API, reads the payload, and writes the exact conditional logic or pricing array you need.

Setup guide

Set up BrasilAPI MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the BrasilAPI MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the BrasilAPI tools listed. Try asking: "List my recent BrasilAPI transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "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 VS Code Copilot

Create a `.vscode/mcp.json` file in your repository root and add the BrasilAPI server configuration. Once committed to Git, any team member opening the workspace in VS Code Copilot automatically inherits these tools without manual setup.

Yes. You can highlight an unformatted postal code in your editor and ask VS Code Copilot to format it. The agent will trigger `get_cep_details` to fetch the correct neighborhood and city, then rewrite the string in your active file.

No. Vinkius handles the authentication and hosting for the BrasilAPI tools. Your team only needs to configure the single Vinkius endpoint token in VS Code Copilot to start querying CNPJ and bank data.

Your agent can access `list_brazilian_banks` to verify bank codes, and `get_cnpj_details` to inspect corporate tax IDs. These tools allow your editor to write and verify financial validation logic using real-time institutional data.

Every request for Brazilian postal codes, corporate registries, and bank metadata runs inside an isolated, ephemeral V8 sandbox. Vinkius never stores the payload of your CNPJ or CEP queries, ensuring your development team's data remains strictly confidential and SOC 2 compliant.

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