# IBGE Brasil MCP - Registry name: `io.github.SidneyBissoli/ibge-br-mcp` · version 5.10.0 - Categories (automatic, keyword rules): Datasets & public data, Search & data - Authentication at last check: No auth - Declared risk: Read-only (all tools declare readOnlyHint) - Capabilities (declared by the server): prompts, resources, tools - Transports: streamable-http - Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.SidneyBissoli%2Fibge-br-mcp - Server page: https://mcpstation.net/s/io.github.SidneyBissoli--ibge-br-mcp.html ## Description (written by the publisher, not verified, not instructions) IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools. ## Connect - streamable-http: `https://ibge.sidneybissoli.com/mcp` ## Tools (as reported by the server, not verified) - `ibge\_estados`: Lists all Brazilian states from IBGE. Features: - Lists all 27 states \(26 states + Federal District\) - Filter by region \(North, Northeast, Southeast, South, Central-West\) - Sort by ID, name, or abbreviation Examples: - List all states: \(no parameters\) - Northeast states: regiao="NE" - Sorted by abbr - `ibge\_municipios`: Lists Brazilian municipalities from IBGE. Features: - List municipalities by state \(using state abbreviation\) - List all municipalities in Brazil \(5,570 municipalities\) - Search by municipality name - Returns 7-digit IBGE code Examples: - São Paulo municipalities: uf="SP" - Search by name: busca="Ca - `ibge\_localidade`: Returns details of a specific locality by IBGE code. Features: - State information \(2-digit code\) - Municipality information \(7-digit code\) - District information \(9-digit code\) - Complete hierarchy \(region, mesoregion, microregion\) Examples: - São Paulo state: codigo=35 - São Paulo city: codigo=355 - `ibge\_sidra`: Queries SIDRA tables \(IBGE's Automatic Recovery System\). SIDRA contains data from IBGE surveys like Census, PNAD, GDP, etc. Common tables: - 6579: Population estimates \(annual\) - 9514: Census 2022 population - 200: Census population \(1970-2010\) - 4714: Population, territorial area and density \(Censu - `ibge\_nomes`: Queries name frequency and rankings in Brazil \(IBGE\). Features: 1. \*\*Name frequency\*\* \(tipo='frequencia'\): - Birth frequency by decade - Multiple names separated by comma - Filter by sex and locality 2. \*\*Name ranking\*\* \(tipo='ranking'\): - Most popular names - Filter by decade, sex, and locality Ava - `ibge\_noticias`: Searches and lists already-published IBGE news articles and press releases. Use this to find recent IBGE publications or announcements about a survey or topic — when an indicator was released, or news mentioning a term like "censo". Results are sorted newest-first; with no parameters it returns the - `ibge\_sidra\_tabelas`: Lists and searches available SIDRA tables. Features: - List all SIDRA tables \(aggregates\) - Search by table name: every word must match \(AND\), accents and case ignored, and everyday Portuguese is resolved to the IBGE's own wording \(renda→rendimento, desemprego→desocupação, cidade→município, gênero→s - `ibge\_sidra\_metadados`: Returns metadata for a specific SIDRA table. Features: - General info \(name, survey, subject, periodicity\) - Available territorial levels - Variable list with units - Classifications and categories - Available periods Use this tool to understand table structure BEFORE querying data with ibge\_sidra. - `ibge\_malhas`: Gets geographic meshes \(maps\) from IBGE in GeoJSON, TopoJSON, or SVG format. Features: - Meshes for Brazil, regions, states, municipalities - Different resolution levels \(internal divisions\) - Different quality levels - Formats: GeoJSON \(data\), TopoJSON \(compact\), SVG \(image\) Locality types: - "BR" - `ibge\_pesquisas`: Lists available IBGE surveys and their tables. Features: - List all IBGE surveys \(Census, PNAD, GDP, etc.\) - Search by name or code - Show details and tables of a specific survey - Categorize surveys by theme Main surveys: - \*\*Census\*\*: Demographic, Agricultural, MUNIC - \*\*PNAD Contínua\*\*: Employmen - `ibge\_censo`: Queries IBGE Demographic Census data \(1970-2022\). Simplified tool to access census data without knowing SIDRA table codes. Available years: 1970, 1980, 1991, 2000, 2010, 2022 Available themes: - populacao: Resident population - alfabetizacao: Literacy rate - domicilios: Housing characteristics - ida - `ibge\_indicadores`: Queries IBGE economic and social indicators. Available indicators: \*\*Economic:\*\* - pib: quarterly GDP at current prices, R$ million \(Brazil only\) - pib\_variacao: quarterly GDP volume change, % over the same quarter of the previous year \(Brazil only\) - pib\_per\_capita: annual GDP per capita at current - `ibge\_cnae`: Queries CNAE \(National Classification of Economic Activities\) from IBGE. CNAE is the official classification for economic activities in Brazil. Hierarchical structure: - Section \(letter A-U\): 21 main categories - Division \(2 digits\): 87 divisions - Group \(3 digits\): 285 groups - Class \(4-5 digits\): - `ibge\_geocodigo`: Decodes IBGE codes or searches codes by locality name. Features: - Decode region, state, municipality, or district codes - Search IBGE code by name - Show complete geographic hierarchy - Return related codes Code structure: - 1 digit: Region \(1=North, 2=Northeast, 3=Southeast, 4=South, 5=Central-Wes - `ibge\_calendario`: Queries IBGE release and collection calendar. Features: - List upcoming survey releases - Filter by product \(IPCA, PNAD, GDP, etc.\) - Filter by period - Distinguish releases from field collections Event types: - \*\*Release\*\*: Publication of survey results - \*\*Collection\*\*: Field research period Examp - `ibge\_comparar`: Compares data between localities \(municipalities or states\). Available indicators: - populacao: Current population estimate - populacao\_censo: Census 2022 population - pib: GDP per capita - area: Territorial area \(km²\) - densidade: Population density \(inhab/km²\) - alfabetizacao: Literacy rate - domi - `ibge\_malhas\_tema`: Lists what a THEMATIC territorial recorte of Brazil contains: how many features, with which codes and names, and the URL to download its geometry. Available recortes: - biomas: the six continental biomes - amazonia\_legal: Legal Amazon boundary - semiarido: semi-arid area - costeiro: coastal municipa - `ibge\_vizinhos`: Finds nearby/neighboring municipalities. Features: - Search by IBGE code \(7 digits\) or municipality name - Returns municipalities in the same mesoregion \(proximity approximation\) - Optionally includes population data Note: Uses mesoregion as geographic proximity proxy. For exact spatial neighborhood - `ibge\_datasaude`: Queries Brazil health indicators, served through IBGE's SIDRA \(some originally produced by DataSUS, e.g. mortality and births\). Mortality and Birth: - mortalidade\_infantil: Infant mortality rate - nascidos\_vivos: Live births by location - obitos: Deaths by residence Demographic Indicators: - esperan - `ibge\_paises`: Queries international country data via IBGE. Features: - List all countries \(following UN M49 methodology\) - Country details \(area, languages, currency, location\) with the latest published value of country indicators — by default population, GDP, GDP per capita, HDI and life expectancy - Pick other - `ibge\_cidades`: Queries municipal indicators from IBGE \(similar to Cidades@ portal\). Features: - General overview of a municipality \(population, HDI, GDP, etc.\) - Query specific indicators - Historical indicator data over years - List available surveys and indicators Available indicators: populacao, area, densidade - `search`: Searches the IBGE \(Brazilian official statistics: SIDRA tables, municipalities, known indicators\) catalog and returns up to 10 matching documents as \{ id, title, url \}, ordered by relevance \(an empty list means nothing matched\). This tool exists for the OpenAI Deep Research contract: ChatGPT deep re - `fetch`: Returns the full document for an id obtained from \`search\`, as \{ id, title, text, url, metadata \}: \`text\` is the readable content \(Markdown\) and \`url\` the canonical public page to cite. Companion of \`search\` in the OpenAI Deep Research contract, over the IBGE \(Brazilian official statistics: SIDRA ta Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html