How to Use the MAPA (Agricultura) MCP in Windsurf

Q: Can Cascade use MAPA (Agricultura) to build local data models in Windsurf?

Yes. Cascade can run getresource to grab raw CSV links, download the files, and write Python code to parse them inside your project.

Query Brazilian agricultural open data directly inside Windsurf to feed your data pipelines without leaving your workspace.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MAPA (Agricultura) MCP to Windsurf

Create your Vinkius account to connect MAPA (Agricultura) 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 MAPA (Agricultura) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain Brazilian crop data searches in Windsurf

Windsurf doesn't make you copy-paste API payloads. Cascade uses `search_packages` to find specific datasets like "agrofit" and then immediately triggers `get_package` to inspect the contents. It chains these steps on its own. You tell Cascade to find pesticide registries. It queries the MAPA (Agricultura) registry, grabs the resource IDs using `get_resource`, and formats the output. It does this in one go.

Audit agricultural organizations in one run

Keeping track of Brazilian ministry updates is a pain. This MCP Server lets Cascade pull the complete directory of agricultural departments using `list_organizations` without requiring manual pagination scripts. Once Cascade gets the list, it uses `get_organization` to extract active schemas. You get clean, structured JSON of Brazilian government entities dumped straight into your active workspace.

Map agricultural tags and groups autonomously

Finding specific crop data shouldn't feel like a guessing game with this MCP Server. Cascade uses `list_tags` and `list_groups` to catalog what's actually available on the MAPA servers before you write a single query. Instead of guessing endpoint names, your agent builds a local map of Brazilian agricultural datasets. It uses `list_packages` to verify the exact titles, saving you from broken API requests.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "mapa-agricultura-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 MAPA (Agricultura). 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 MAPA (Agricultura) 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 MAPA (Agricultura) MCP in Windsurf

It connects as an MCP Server in your config file. Cascade can then call the 8 agricultural tools directly to pull Brazilian government records without manual API setups.

Yes. Cascade can run `get_resource` to grab raw CSV links, download the files, and write Python code to parse them inside your project.

No. You just add the server to your configuration file. Windsurf auto-discovers the tools so Cascade can start querying right away.

The tools return the raw Portuguese metadata. Cascade translates the fields on the fly so you can work in English without checking translation sites.

It only touches public Brazilian agricultural metadata and CKAN records. No private code or local files are sent to the government servers; queries go through an isolated sandbox.

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