How to Use the IBGE Nomes — Nomes do Brasil MCP in Claude Code

Query Brazilian census name statistics and pipe the output directly from Claude Code.

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 Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query decade-by-decade name frequency from the terminal

The `get_nome_frequencia` tool fetches historical birth frequencies for any Brazilian name. Claude Code executes this query directly in your shell, allowing you to pipe the raw JSON output to other command-line utilities. This is built for terminal workflows. You can query multiple names using the pipe character and immediately save the results to a local file for processing.

Filter regional naming data via CLI commands

The `get_nome_por_localidade` tool outputs name popularity filtered by Brazilian state codes. Claude Code can run this tool, extract the state-level distribution, and pipe it directly into your database seeding scripts. No browser or GUI is required. You can automate these queries inside your terminal sessions or shell scripts to keep your local demographic tables updated.

Fetch national name rankings using this MCP Server

The `get_ranking_nomes` tool gets the top-ranked names in Brazil, filtered by decade and sex. Claude Code uses this raw ranking data to validate inputs or generate localized datasets in headless environments. This is ideal for CI/CD pipelines or cron jobs. The agent runs the query, checks the data, and updates your static assets without manual intervention.

Setup guide

Set up IBGE Nomes — Nomes do Brasil MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see ibge-nomes-nomes-do-brasil-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest IBGE Nomes — Nomes do Brasil transactions." It will automatically discover and invoke the available IBGE Nomes — Nomes do Brasil tools.

Terminal

claude mcp add --transport http ibge-nomes-nomes-do-brasil-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "ibge-nomes-nomes-do-brasil-mcp": {
      "type": "url",
      "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 Claude Code

Run the command 'claude mcp add --transport http ibge-nomes -- ' in your terminal. This registers the MCP Server and makes the three name-querying tools available in your CLI.

Yes, Claude Code can run these tools inside automated shell scripts. You can query the name frequencies and pipe the resulting data straight into other terminal tools.

Ask the CLI agent to search for a state's name frequency. It will execute the state-filtering tool with the correct UF code and print the raw output to your terminal.

Yes, it does. You can direct the tool outputs to JSON files or grep through the results directly within your terminal session.

The MCP Server only accesses public Brazilian census name datasets. It does not store or log your queries, keeping your command-line history and terminal environment secure.

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