How to Use the MDIC (Comércio Exterior) MCP in Windsurf

Q: Can Cascade chain multiple MDIC (Comércio Exterior) tools in Windsurf?

Yes, that is where Cascade shines. It can start with searchpackages to find a dataset, use getpackage to check the files, and then run searchdatastore to grab the records, all in one single run.

Run Cascade to pull Brazilian trade data directly into your workspace with the MDIC (Comércio Exterior) MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MDIC (Comércio Exterior) MCP to Windsurf

Create your Vinkius account to connect MDIC (Comércio Exterior) 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 MDIC (Comércio Exterior) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Explore Brazilian Trade Datasets in Windsurf

The `list_packages` tool lets your agent fetch the complete catalog of Brazilian trade datasets directly from the MDIC portal. Cascade can run this search, find the dataset you need, and immediately queue up the next step to extract the raw numbers without waiting for you to tell it what to do. If you need to filter down to specific topics like soybean exports or automotive imports, `search_packages` scans the metadata for matching terms. This allows the agent to narrow down the target files in seconds, bypassing the usual manual search on the government portal.

Query Live Trade Records with Cascade

The `search_datastore` tool executes direct queries against the underlying Brazilian trade database to pull raw import and export statistics. Cascade handles the query construction, retrieves the tabular data, and formats it for your local analysis files. You don't have to download CSVs manually anymore. Your agent can chain this database search with local Python scripts to instantly plot trade balances or calculate year-over-year growth metrics.

Pull Trade File Schemas Using This MCP Server

The `get_package` tool retrieves complete metadata for a specific trade dataset, giving your agent the exact structure of the target files. Cascade uses this structural information to understand the column layouts before writing any data parsing scripts. Once the package is identified, `get_resource` extracts the specific data file references. Your agent can then download the exact CSV or database partition needed for your economic models, keeping your workflow entirely inside the IDE.

Setup guide

Set up MDIC (Comércio Exterior) 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 MDIC (Comércio Exterior) 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 MDIC (Comércio Exterior) payment history." If connected, Cascade will call the MDIC (Comércio Exterior) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "mdic-comercio-exterior-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 MDIC (Comércio Exterior). 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 MDIC (Comércio Exterior) 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 MDIC (Comércio Exterior) MCP in Windsurf

Windsurf connects directly to the server via your configuration file, exposing the trade database tools to Cascade. Your agent can then search, inspect, and query Brazilian import and export data autonomously during your chat sessions.

Yes, that is where Cascade shines. It can start with `search_packages` to find a dataset, use `get_package` to check the files, and then run `search_datastore` to grab the records, all in one single run.

You just need to add the server details under the mcpServers key in your mcp_config.json file. Once saved, Cascade auto-discovers the tools and makes them available for your next prompt.

No, you do not have to write manual queries. Tell Cascade what data you need, and it will use `search_datastore` to handle the parameters and pull the records for you.

Your queries and the resulting Brazilian trade metadata remain strictly local to your active Windsurf session. Vinkius runs the server in an isolated sandbox, meaning your custom analytical queries and fetched trade records are never stored or exposed.

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