How to Use the IBGE Pesquisas — Brasil Cidades MCP in Windsurf

Q: How do I configure the IBGE Pesquisas — Brasil Cidades MCP server in Windsurf?

Add the server configuration to your /.codeium/windsurf/mcpconfig.json file under the mcpServers key. Cascade will automatically discover the tools like listpesquisas as soon as you restart the client.

Q: Can Cascade use IBGE Pesquisas — Brasil Cidades to build charts in Windsurf?

Yes, Cascade can query municipal data using getresultados and write code to generate charts in your workspace. It handles the entire chain from data retrieval to visualization.

Q: How do I find the correct survey IDs for my queries?

Use the listpesquisas tool to get a full index of available IBGE surveys. Your agent can run this first to find the ID for the census or agricultural surveys.

Get raw Brazilian municipal data and run multi-step regional analyses automatically with Cascade in Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IBGE Pesquisas — Brasil Cidades MCP to Windsurf

Create your Vinkius account to connect IBGE Pesquisas — Brasil Cidades 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 IBGE Pesquisas — Brasil Cidades with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate regional rankings in Windsurf

The `get_ranking_indicador` tool lets Cascade rank Brazilian cities based on specific socioeconomic metrics without you manual-prompting each step. Windsurf looks at your target indicator, grabs the rankings, and sorts the target municipalities in one continuous run. You don't have to write custom scripts to parse the raw numbers. Your agent chains the query, handles the sorting, and outputs clean markdown tables directly in your workspace.

Deep dive into local survey metrics

The `get_indicadores` tool retrieves specific survey data like the Censo Demográfico or agricultural production across Brazilian municipalities. Cascade pulls these complex data structures directly into your active session to build immediate context. Instead of searching through government portals, you ask for the data and let the agent fetch the exact codes. It handles the API parameters under the hood so you can focus on the actual policy analysis.

Compare municipal performance across regions

The `get_resultados` tool fetches specific research results for Brazilian states or municipalities to compare regional health and education trends. Cascade uses this data to map out regional disparities and flag outliers automatically. Connecting this MCP server to Windsurf means your agent can write a Python script, populate it with real IBGE data, and run the visualization without requiring your intervention.

Setup guide

Set up IBGE Pesquisas — Brasil Cidades 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 IBGE Pesquisas — Brasil Cidades 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 IBGE Pesquisas — Brasil Cidades payment history." If connected, Cascade will call the IBGE Pesquisas — Brasil Cidades tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "ibge-pesquisas-brasil-cidades-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 IBGE. 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 IBGE Pesquisas — Brasil Cidades 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 IBGE Pesquisas — Brasil Cidades MCP in Windsurf

Add the server configuration to your `~/.codeium/windsurf/mcp_config.json` file under the `mcpServers` key. Cascade will automatically discover the tools like `list_pesquisas` as soon as you restart the client.

Yes, Cascade can query municipal data using `get_resultados` and write code to generate charts in your workspace. It handles the entire chain from data retrieval to visualization.

No, Vinkius handles the underlying connection and authentication for you. You only need your single Vinkius endpoint token to start querying Brazilian city statistics.

Use the `list_pesquisas` tool to get a full index of available IBGE surveys. Your agent can run this first to find the ID for the census or agricultural surveys.

Yes, Vinkius runs this MCP server inside an isolated, zero-trust sandbox. The public IBGE municipal indicators and survey statistics you query are never stored or used to train models.

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