# IBGE Data MCP MCP > IBGE Serviços de Dados connects you directly to official Brazilian statistics, geographic maps, and socio-economic records from the IBGE. It lets your agent query complex data sets—like national inflation rates or historical name frequencies—using natural language. You get access to classifications (CNAE), state meshes, census demographics, and current news updates all in one place. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** brazil, statistics, geography, socio-economic, census, data-services ## Description Need official Brazilian data? This MCP connects your AI client directly to the IBGE's full suite of socio-economic services. Forget piecing together information from multiple government websites or struggling with outdated datasets. You can ask for anything: the average employment rate in a specific state, the most common first name recorded in the 2010 Census, or which business sector corresponds to a given code. It pulls accurate data across several domains—from deep demographic history to current market classifications (CNAE). When you connect this MCP via Vinkius, your agent can handle all these complex queries using simple conversation. Whether you're tracking economic indicators over time or mapping out regional boundaries, the raw, official statistics are ready for immediate analysis. It’s a single source of truth for Brazilian data. ## Tools ### get_agregados Pulls specific statistical aggregates from various IBGE surveys, like employment or production metrics. ### get_nome_geografico Looks up a geographical name in the official Brazilian database (BNGB) to ensure accuracy. ### get_calendario Retrieves the schedule of future publications and survey results for a given research area. ### get_cnae_classe Looks up and provides detailed classifications for national economic activities (CNAE). ### get_malha_estado Fetches the precise geographic mesh data required to map an entire state's boundaries. ### get_metadados Retrieves background details and documentation about specific IBGE surveys or datasets. ### get_nomes_frequencia Calculates how often specific first names appear across different decades of census records. ### get_noticias Searches for and provides the latest news releases, updates, or reports published by IBGE. ## Prompt Examples **Prompt:** ``` What is the frequency of the name 'João' in Brazil according to IBGE? ``` **Response:** ``` I've queried the 2010 Census data. The name 'João' has a total frequency of 2,971,335 occurrences. The decade with the highest frequency was the 1950s with 418,174 births. ``` **Prompt:** ``` Show me the latest news from IBGE about the 'Censo'. ``` **Response:** ``` I found several recent updates regarding the Census. The most recent release is 'IBGE releases new demographic coordinates from the 2022 Census'. Would you like the full summary? ``` **Prompt:** ``` What are the CNAE classes related to code 0111-3? ``` **Response:** ``` The CNAE class 0111-3 refers to 'Cultivation of cereals'. It includes activities like growing corn, wheat, rice, and other grains. Is there a specific sub-category you need? ``` ## Capabilities ### Querying Economic Time Series Retrieve complex statistical aggregates covering inflation, employment, and production metrics from various IBGE surveys. ### Mapping Geographic Boundaries Fetch state-level geographic meshes or look up specific geographical names using official Brazilian databases. ### Identifying Business Sectors Browse the National Classification of Economic Activities (CNAE) to accurately categorize businesses and economic sectors. ### Analyzing Demographics Check historical name frequencies or pull census data, filtered by region or gender. ### Monitoring Official Releases Get the latest news and monitor the schedule for upcoming statistical reports and survey results. ## Use Cases ### Comparing Historical Name Trends A genetic researcher needs to understand regional population shifts over time. They ask their agent, which uses `get_nomes_frequencia`, to compare the frequency of 'Maria' versus 'João' in three different regions across 1950 and 2000. ### Validating Business Scope A consultant is vetting a new client. They use `get_cnae_classe` to confirm the exact economic scope of the business, then use `get_agregados` to benchmark that sector's growth against national averages. ### Mapping State-Level Projects An infrastructure developer needs precise borders. They run `get_malha_estado` for a target state and then use `get_nome_geografico` to confirm the proper names of all surrounding municipalities. ### Pre-empting Data Gaps A journalist is preparing an article on poverty. They first check `get_calendario` for the next available census data release, then use `get_noticias` to see if any preliminary reports have already been published. ## Benefits - Stop guessing on data definitions. Use `get_metadados` to get the full context and scope of any IBGE survey before you even start querying. - Never miss a deadline again. Run `get_calendario` to map out exactly when the next round of economic or demographic reports will drop, planning your analysis around confirmed dates. - Accurately categorize businesses using `get_cnae_classe`. This ensures your market comparison is based on official national standards, not rough estimates. - Visualize regional differences easily. Use `get_malha_estado` to pull the precise geographic boundaries needed for mapping state-level economic performance. - Understand population trends by running a query with `get_nomes_frequencia`. You can track changes in common names over decades, providing social insights. - Stay current and informed. Use `get_noticias` to get immediate reports on any new data releases or major announcements from the IBGE. ## How It Works The bottom line is you ask a question, and this MCP runs the query against decades of official Brazilian records to give you the answer. 1. Subscribe to this MCP through Vinkius. No complicated authentication is needed because it handles public data access. 2. Tell your AI client what you need—for example, 'What was the inflation rate for Q4 2023?' 3. The agent uses the necessary tool (like `get_agregados`) to pull the official figure and presents the result in natural conversation. ## Frequently Asked Questions **How do I find out if IBGE has released new data? (get_noticias)** You use `get_noticias` to check the current stream of information. This tool pulls the latest official reports and announcements, letting you know immediately what's available for analysis. **Which tool should I use if I need a map of a Brazilian state? (get_malha_estado)** `get_malha_estado` is the correct tool. It provides the detailed, official geographic mesh needed for accurate mapping, ensuring your boundaries are precise. **Can I track name popularity in Brazil? (get_nomes_frequencia)** Yes, use `get_nomes_frequencia`. This tool queries the census data to calculate how often specific names appeared across different decades and regions. **What is the best way to check available statistics? (get_metadados)** Run `get_metadados` first. It gives you metadata on the surveys, which tells you exactly what data is being collected and how it was measured. **I need to find out about a specific industry sector; how does using `get_cnae_classe` help me?** It returns detailed classifications for business sectors. You provide the code, and it gives you the description, scope, and related activities for that CNAE class. This lets you map complex industrial data accurately. **If I need to analyze economic trends over many years, how do I use `get_agregados`?** You query specific indicators like inflation or production metrics across a given time range. The tool pulls multiple time-series data points into one dataset for comparison and analysis. **I'm writing code that needs accurate place names; what is the purpose of `get_nome_geografico`?** This tool retrieves official geographic names from the BNGB database. Use it when you need to ensure a location name matches Brazilian standards, preventing ambiguity in your data. **How can I check future release dates for statistical surveys using `get_calendario`?** It provides the publication schedule for specific research. You input the survey ID and get a timeline of expected reports, helping you plan when to expect new data releases. **Can I check the popularity of a specific name in Brazil over time?** Yes! Use the `get_nomes_frequencia` tool with a name. It returns the frequency of births per decade based on the 2010 Census data. **How do I find out when the next inflation data (IPCA) will be released?** You can use the `get_calendario` tool and provide 'IPCA' as the survey name. It will return the scheduled dates for upcoming publications. **Is it possible to search for IBGE news by specific keywords?** Yes, the `get_noticias` tool includes a `busca` parameter. You can filter official news and releases by any term, such as 'PIB' or 'Censo'.