How to Use the Mato Grosso do Sul Open Data MCP in Windsurf

Q: How do I connect the Mato Grosso do Sul Open Data server to Windsurf?

Edit your /.codeium/windsurf/mcpconfig.json file to include the server details. You can also use the Settings UI to add it. Click refresh, and Cascade will immediately see the new tools.

Q: Can Windsurf automatically query Mato Grosso do Sul Open Data using SQL?

Yes. Cascade uses the datastoresearchsql tool to write and execute SQL queries against the CKAN API. You just tell it what data you want, and it handles the syntax and execution.

Q: Does the agent handle API pagination?

Cascade reads the response metadata from tools like listpackages. If the total count exceeds the returned limit, it loops the request with an offset until it retrieves all records.

Pull Brazilian public records directly into your editor so Windsurf Cascade can autonomously map and query state datasets.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mato Grosso do Sul Open Data MCP to Windsurf

Create your Vinkius account to connect Mato Grosso do Sul Open Data 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 Mato Grosso do Sul Open Data with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map the State Hierarchy

The `list_organizations` and `list_groups` tools let Windsurf Cascade map the exact structure of Mato Grosso do Sul's public directories. You set a goal to find health spending records, and Cascade autonomously queries these endpoints to locate the correct departments. It reads the JSON responses, identifies the target organization ID, and plans the next step without asking you. Once the organization is found, Cascade fires the `list_packages` tool to pull every available dataset under that umbrella. This means you don't spend hours clicking through a CKAN web portal. The agent handles the pagination and filtering, presenting you with the exact package names you need for your analysis.

Windsurf SQL Data Extraction

The `datastore_search_sql` tool executes raw SQL queries directly against the state's DataStore resources via the MCP Server. Cascade writes the query based on your prompt, sends it to the endpoint, and retrieves the filtered rows. If you need all education contracts over a specific value, the agent writes the SELECT statement and fetches the exact subset. For simpler lookups, Cascade defaults to `datastore_search` to grab records by text match or limit. It chains these searches together when investigating multiple linked resources. You watch the output stream into your terminal panel while the agent does the heavy lifting.

Inspect Packages and Resources

The `get_package` tool retrieves full metadata for a specific dataset, including creation dates, update frequency, and author contacts. Cascade uses this to verify if a dataset is current before deciding to extract its contents. It checks the schema definitions so it knows exactly what columns exist. When it's time to pull the actual files, the agent calls `get_resource`. This returns the precise download URLs and format types for the data. Cascade can then write a Python script to download and parse those files locally, completing the entire extraction pipeline in one prompt.

Setup guide

Set up Mato Grosso do Sul Open Data 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 Mato Grosso do Sul Open Data 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 Mato Grosso do Sul Open Data payment history." If connected, Cascade will call the Mato Grosso do Sul Open Data tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "mato-grosso-do-sul-open-data-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 Mato Grosso do Sul Dados Abertos. 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 Mato Grosso do Sul Open Data 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 Mato Grosso do Sul Open Data MCP in Windsurf

Edit your `~/.codeium/windsurf/mcp_config.json` file to include the server details. You can also use the Settings UI to add it. Click refresh, and Cascade will immediately see the new tools.

Yes. Cascade uses the `datastore_search_sql` tool to write and execute SQL queries against the CKAN API. You just tell it what data you want, and it handles the syntax and execution.

Cascade reads the response metadata from tools like `list_packages`. If the total count exceeds the returned limit, it loops the request with an offset until it retrieves all records.

Browsing a CKAN portal manually requires downloading CSVs and parsing them by hand. Cascade uses the MCP Server to pull exactly the rows you need, write the analysis script, and generate a local report in one continuous action.

This MCP integration only reads publicly available government datasets. Windsurf sends your SQL queries and search terms to the state's CKAN API, but no private user data from your local machine is transmitted during the process.

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