How to Use the IBGE Nomes — Nomes do Brasil MCP in Windsurf

Q: How do I install the IBGE Nomes — Nomes do Brasil server in Windsurf?

Add the server configuration to your /.codeium/windsurf/mcpconfig.json file under the mcpServers key. This registers the MCP Server and makes the tools available to Cascade instantly.

Map Brazilian demographic shifts and name trends directly inside your Windsurf Cascade sessions.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect IBGE Nomes — Nomes do Brasil MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Trace birth trends over decades automatically

The `get_nome_frequencia` tool pulls historical frequency data for any Brazilian name from the 1930s onward. Cascade can take this raw statistical array and automatically plot a timeline or write code to graph the rise and fall of specific names without you writing a single query. If you want to compare multiple names like Joao and Pedro, pass them separated by a pipe character. The agent handles the parsing and formats the comparison instantly in your workspace using this MCP toolset.

Filter naming patterns by Brazilian state in Cascade

The `get_nome_por_localidade` tool filters name popularity by specific state codes like 33 for Rio de Janeiro or 35 for São Paulo. Cascade uses this local data to instantly map out regional marketing profiles or build localized mock data for your Brazilian user databases. You do not have to look up the state codes yourself. Ask the agent to find the code for Minas Gerais, run the tool, and output the regional distribution directly into your active file.

Generate popularity rankings with this MCP Server

The `get_ranking_nomes` tool fetches rankings of the most common names in Brazil, filterable by decade and sex. Cascade chains this tool with your local files to populate realistic test databases based on actual census distributions. This removes the guesswork when building localized applications. The agent grabs the top-ranked names and writes them straight into your schema files in one go.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "ibge-nomes-nomes-do-brasil-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 Nomes — Nomes do Brasil 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 Nomes — Nomes do Brasil MCP in Windsurf

Add the server configuration to your ~/.codeium/windsurf/mcp_config.json file under the mcpServers key. This registers the MCP Server and makes the tools available to Cascade instantly.

Yes, Cascade can run multiple tools in sequence. It can query a name's frequency, look up its regional distribution, and use that data to write a local configuration file without requiring individual prompts.

Windsurf passes the names separated by a pipe character directly to the frequency tool. Cascade then processes the returned multi-decade dataset and formats it in your active workspace.

No, you do not. Just tell Cascade which Brazilian state you want to query, and it will find the correct numerical code and run the tool for you.

Yes. This server runs inside a secure, zero-trust sandbox that only processes public census naming data. Your local code and environment variables are never exposed to external servers during these lookups.

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