# IBGE Nomes MCP > IBGE Nomes provides direct access to Brazil's official naming statistics from IBGE. It lets you analyze how popular names were across different decades, genders, or even specific regions. Quickly check birth frequency for names like 'Maria' or rank the top 10 most common names in a given state and time period. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** demographics, brazil, census, name-trends, social-data, statistics ## Description Need to track name trends in Brazil? This MCP connects your AI agent directly to the IBGE census data. You can look up how often any specific name was born over multiple decades, giving you deep insight into cultural shifts. Beyond simple frequency checks, you can generate official rankings of the most popular names, filtering by gender or state ID. This makes it perfect for historical research or fiction writing that demands accuracy. By connecting this data source through your Vinkius subscription, your AI client treats Brazil’s naming history like a simple lookup table, allowing complex demographic questions to resolve into concrete statistics. ## Tools ### get_name_frequency Determines the number of births per decade for one or more specified names using a pipe separator (|). ### get_names_ranking Provides a ranked list of the most frequent names based on specific filters like gender and time period. ## Prompt Examples **Prompt:** ``` What is the birth frequency of the name 'Neymar' in Brazil per decade? ``` **Response:** ``` I've queried the IBGE database for 'NEYMAR'. The name saw a significant rise in the 2000s with 4,685 occurrences, compared to only 436 in the 1990s. Would you like to see the ranking for the 2010s as well? ``` **Prompt:** ``` Show me the top 10 most popular female names in Brazil during the 1980s. ``` **Response:** ``` Fetching the 1980s ranking... The top female names were Maria, Ana, and Aline. Maria remains the most frequent with over 1.6 million registrations in that decade alone. Do you want to filter this by a specific state? ``` **Prompt:** ``` Compare the popularity of 'Enzo' and 'Valentina' using IBGE data. ``` **Response:** ``` Comparing 'ENZO' and 'VALENTINA'... Both names exploded in popularity in the 2000s. Enzo reached 44,056 registrations while Valentina reached 10,033 in the same period. Would you like to see which states have the highest density for these names? ``` ## Capabilities ### Determine name birth frequency Find the number of times specific names were registered across different decades in Brazilian history. ### Generate name popularity rankings Get a ranked list of the most common names, applying filters for gender and time period. ### Compare multiple names Simultaneously check the historical frequency of several different names to spot comparative trends. ### Filter by geography Limit name statistics to specific Brazilian states or municipalities for regional analysis. ## Use Cases ### A writer needs historical character names. The writer asks their agent: 'What were the top 10 most popular female names in Bahia during the 1950s?' The agent uses `get_names_ranking` and provides a vetted, historically accurate list for immediate use. ### A sociologist is studying cultural shifts. The researcher asks their agent to compare 'João' and 'Pedro' across five decades. The agent uses `get_name_frequency` on both names, revealing a distinct spike in one name that correlates with a known social event. ### A data analyst needs multiple comparisons. The analyst asks their agent to compare the popularity of 'Alex' and 'Bruno' using `get_name_frequency`. The tool returns side-by-side metrics, allowing for quick identification of shared naming trends. ### A content creator needs regional data. The creator asks their agent to find the top male names only in São Paulo. The agent uses `get_names_ranking` with a locality filter, giving hyper-specific results that feel authentic. ## Benefits - Instead of guessing, you get official data. Use `get_name_frequency` to see exactly how 'Enzo' or 'Maria' surged in popularity during the 2000s. - Need a list of top names? Run `get_names_ranking` and filter for the best-selling female name in Brazil during the 1980s, instantly. - Writing fiction? Compare multiple names like 'Enzo' and 'Valentina' using their combined data to show how trends overlap or diverge. - The system handles complex filtering. You can combine state IDs with name counts so you know regional preferences—it’s not just national data. - It connects directly to the public IBGE Open Data API, meaning no complicated setup or proprietary keys are required for your agent. ## How It Works The bottom line is that you ask a question about Brazilian names, and this MCP pulls the verified statistics from IBGE instantly. 1. Subscribe to this MCP in Vinkius. You don't need an API key because it uses the public IBGE Open Data API. 2. Direct your AI agent (Claude, Cursor, etc.) to perform a specific query, like 'Compare the frequency of name X and Y in the 1980s.' 3. The MCP retrieves the official data points for you and presents them directly back to your chat window. ## Frequently Asked Questions **How do I use `get_name_frequency` with multiple names?** You separate the names using a pipe character (|). For example, if you want to compare 'Enzo' and 'Valentina', your query needs to list them as 'ENZO|VALENTINA'. **Is `get_names_ranking` only for national data?** No. You can filter the ranking results by specific locality IDs (states or municipalities) to understand regional naming preferences. **What time period does IBGE Nomes cover?** The MCP draws from historical census data, allowing you to check trends across multiple decades of Brazilian history. Always specify the timeframe in your prompt for best results. **Do I need an API key when using `get_name_frequency`?** No, this MCP uses the public IBGE Open Data API, so you don't have to worry about setting up or managing any keys. **What format should I expect when using `get_names_ranking` or `get_name_frequency`?** The tools return structured JSON data. Each result includes the name, the decade, and the count of births. This clean structure makes it simple for your agent to parse and present findings. **If I query a name that doesn't exist using `get_name_frequency`, what happens?** The tool returns an error message indicating the name is not found in the dataset. Always check the API response status codes first to handle these zero-result scenarios gracefully. **Are there limits on how many parameters I can use with `get_names_ranking`?** While there isn't a strict limit, querying too many filters (e.g., multiple localities and decades) simultaneously may cause timeouts. Keep your inputs focused for the fastest results. **What kind of demographic data is covered by `get_names_ranking`?** This MCP draws exclusively from historical birth records maintained by IBGE. It tracks name popularity based on recorded births, not other types of census data. **Can I compare the popularity of two different names in the same query?** Yes! Use the `get_name_frequency` tool and separate the names with a pipe symbol (e.g., 'MARIA|ANA'). The agent will return the frequency data for both names across the decades. **How do I find the most popular names from the 1990s?** You can use the `get_names_ranking` tool and provide '1990' in the `decada` parameter. This will return a list of the most frequent names recorded during that specific period. **Is it possible to filter name statistics by a specific Brazilian state?** Absolutely. Both `get_name_frequency` and `get_names_ranking` accept a `localidade` parameter. You just need to provide the IBGE ID for the target state or municipality.