{"id":"io.github.SidneyBissoli/ibge-br-mcp","slug":"io-github-sidneybissoli-ibge-br-mcp","title":"IBGE Brasil MCP","description":"IBGE: geography, census, economy and health from the official APIs, with provenance. 23 tools.","version":"5.11.0","publisher":{"kind":"github","id":"SidneyBissoli","label":"@SidneyBissoli on GitHub","url":"https://github.com/SidneyBissoli"},"website":"https://ibge.sidneybissoli.com","repository":"https://github.com/SidneyBissoli/ibge-br-mcp","remotes":[{"type":"streamable-http","url":"https://ibge.sidneybissoli.com/mcp"}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"ibge-br-mcp","version":"5.11.0","transport":{"type":"stdio"}}],"published":"2026-10-28","updated":"2026-10-28","status":"online","auth":"","latency_ms":1209,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"ibge_estados","title":"Estados do Brasil","description":"Lists all Brazilian states from IBGE.\n\nFeatures:\n- Lists all 27 states (26 states + Federal District)\n- Filter by region (North, Northeast, Southeast, South, Central-West)\n- Sort by ID, name, or abbreviation\n\nExamples:\n- List all states: (no parameters)\n- Northeast states: regiao=\"NE\"\n- Sorted by abbreviation: ordenar=\"sigla\"\n\nUse a different tool when:\n- Municipalities of a state → ibge_municipio","read_only":true},{"name":"ibge_municipios","title":"Municípios do Brasil","description":"Lists Brazilian municipalities from IBGE.\n\nFeatures:\n- List municipalities by state (using state abbreviation)\n- List all municipalities in Brazil (5,570 municipalities)\n- Search by municipality name\n- Returns 7-digit IBGE code\n\nExamples:\n- São Paulo municipalities: uf=\"SP\"\n- Search by name: busca=\"Campinas\"\n- MG municipalities containing \"Belo\": uf=\"MG\", busca=\"Belo\"\n\nUse a different tool when:\n-","read_only":true},{"name":"ibge_localidade","title":"Detalhes de localidade","description":"Returns details of a specific locality by IBGE code.\n\nFeatures:\n- State information (2-digit code)\n- Municipality information (7-digit code)\n- District information (9-digit code)\n- Complete hierarchy (region, mesoregion, microregion)\n\nExamples:\n- São Paulo state: codigo=35\n- São Paulo city: codigo=3550308\n- District: codigo=355030805\n\nThis tool returns the full record of ONE locality you already h","read_only":true},{"name":"ibge_sidra","title":"Consulta de tabelas SIDRA","description":"Queries SIDRA tables (IBGE's Automatic Recovery System).\n\nSIDRA contains data from IBGE surveys like Census, PNAD, GDP, etc.\n\nCommon tables:\n- 6579: Population estimates (annual)\n- 9514: Census 2022 population\n- 200: Census population (1970-2010)\n- 4714: Population, territorial area and density (Census 2022)\n- 4099: Unemployment rate (PNAD Contínua, quarterly)\n- 5436: Average real income (PNAD Con","read_only":true},{"name":"ibge_nomes","title":"Frequência e ranking de nomes","description":"Queries name frequency and rankings in Brazil (IBGE).\n\nFeatures:\n1. **Name frequency** (tipo='frequencia'):\n   - Birth frequency by decade\n   - Multiple names separated by comma\n   - Filter by sex and locality\n\n2. **Name ranking** (tipo='ranking'):\n   - Most popular names\n   - Filter by decade, sex, and locality\n\nAvailable decades: 1930-2010\n\nExamples:\n- Frequency of \"Maria\": tipo=\"frequencia\", no","read_only":true},{"name":"ibge_noticias","title":"Notícias do IBGE","description":"Searches and lists already-published IBGE news articles and press releases.\n\nUse 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 10 most recent items.\n\nParameters:\n- busca: free-text term to match (e.g. \"PIB\", \"censo\")\n- tipo: \"","read_only":true},{"name":"ibge_sidra_tabelas","title":"Busca de tabelas SIDRA","description":"Lists and searches available SIDRA tables.\n\nFeatures:\n- List all SIDRA tables (aggregates)\n- 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→sexo); when that happens the response says so in notas_vocabulario\n- Filter by survey (Census, PNAD,","read_only":true},{"name":"ibge_sidra_metadados","title":"Metadados de tabela SIDRA","description":"Returns metadata for a specific SIDRA table.\n\nFeatures:\n- General info (name, survey, subject, periodicity)\n- Available territorial levels\n- Variable list with units\n- Classifications and categories\n- Available periods\n\nUse this tool to understand table structure BEFORE querying data with ibge_sidra.\n\nExamples:\n- Population table metadata: tabela=\"6579\"\n- Census 2022 metadata: tabela=\"9514\"\n- PNAD","read_only":true},{"name":"ibge_malhas","title":"Malhas geográficas","description":"Gets geographic meshes (maps) from IBGE in GeoJSON, TopoJSON, or SVG format.\n\nFeatures:\n- Meshes for Brazil, regions, states, municipalities\n- Different resolution levels (internal divisions)\n- Different quality levels\n- Formats: GeoJSON (data), TopoJSON (compact), SVG (image)\n\nLocality types:\n- \"BR\" or \"1\" = Entire Brazil\n- State abbreviation (e.g., \"SP\", \"RJ\")\n- State code (e.g., \"35\" for SP)\n- ","read_only":true},{"name":"ibge_pesquisas","title":"Pesquisas do IBGE","description":"Lists available IBGE surveys and their tables.\n\nFeatures:\n- List all IBGE surveys (Census, PNAD, GDP, etc.)\n- Search by name or code\n- Show details and tables of a specific survey\n- Categorize surveys by theme\n\nMain surveys:\n- **Census**: Demographic, Agricultural, MUNIC\n- **PNAD Contínua**: Employment, income, education\n- **National Accounts**: GDP, investments\n- **Economic Surveys**: Industry, C","read_only":true},{"name":"ibge_censo","title":"Censo Demográfico","description":"Queries IBGE Demographic Census data (1970-2022).\n\nSimplified tool to access census data without knowing SIDRA table codes.\n\nAvailable years: 1970, 1980, 1991, 2000, 2010, 2022\n\nAvailable themes:\n- populacao: Resident population\n- alfabetizacao: Literacy rate\n- domicilios: Housing characteristics\n- idade_sexo: Age pyramid\n- religiao: Religion distribution\n- cor_raca: Race/color\n- rendimento: Month","read_only":true},{"name":"ibge_indicadores","title":"Indicadores econômicos e sociais","description":"Queries IBGE economic and social indicators.\n\nAvailable indicators:\n\n**Economic:**\n- pib: quarterly GDP at current prices, R$ million (Brazil only)\n- pib_variacao: quarterly GDP volume change, % over the same quarter of the previous year (Brazil only)\n- pib_per_capita: annual GDP per capita at current prices, R$ (Brazil only)\n- industria: industrial production index, general industry (2022=100)\n- ","read_only":true},{"name":"ibge_cnae","title":"Classificação CNAE","description":"Queries CNAE (National Classification of Economic Activities) from IBGE.\n\nCNAE is the official classification for economic activities in Brazil.\n\nHierarchical structure:\n- Section (letter A-U): 21 main categories\n- Division (2 digits): 87 divisions\n- Group (3 digits): 285 groups\n- Class (4-5 digits): 673 classes\n- Subclass (7 digits): 1,332 subclasses\n\nFeatures:\n- Search by CNAE code\n- Search by a","read_only":true},{"name":"ibge_geocodigo","title":"Códigos geográficos do IBGE","description":"Decodes IBGE codes or searches codes by locality name.\n\nFeatures:\n- Decode region, state, municipality, or district codes\n- Search IBGE code by name\n- Show complete geographic hierarchy\n- Return related codes\n\nCode structure:\n- 1 digit: Region (1=North, 2=Northeast, 3=Southeast, 4=South, 5=Central-West)\n- 2 digits: State (11-53)\n- 7 digits: Municipality\n- 9 digits: District\n\nExamples:\n- Decode mun","read_only":true},{"name":"ibge_calendario","title":"Calendário de divulgações","description":"Queries IBGE release and collection calendar.\n\nFeatures:\n- List upcoming survey releases\n- Filter by product (IPCA, PNAD, GDP, etc.)\n- Filter by period\n- Distinguish releases from field collections\n\nEvent types:\n- **Release**: Publication of survey results\n- **Collection**: Field research period\n\nExamples:\n- Upcoming releases: (no parameters)\n- IPCA releases: produto=\"IPCA\"\n- 2024 calendar: de=\"01","read_only":true},{"name":"ibge_comparar","title":"Comparação entre localidades","description":"Compares data between localities (municipalities or states).\n\nAvailable indicators:\n- populacao: Current population estimate\n- populacao_censo: Census 2022 population\n- pib: GDP per capita\n- area: Territorial area (km²)\n- densidade: Population density (inhab/km²)\n- alfabetizacao: Literacy rate\n- domicilios: Number of households\n\nFeatures:\n- Compare up to 10 localities at once\n- Calculate statistic","read_only":true},{"name":"ibge_malhas_tema","title":"Malhas temáticas","description":"Lists what a THEMATIC territorial recorte of Brazil contains: how many features, with which codes and names, and the URL to download its geometry.\n\nAvailable recortes:\n- biomas: the six continental biomes\n- amazonia_legal: Legal Amazon boundary\n- semiarido: semi-arid area\n- costeiro: coastal municipalities\n- fronteira: border-strip municipalities\n- metropolitana: metropolitan regions\n- ride: Integ","read_only":true},{"name":"ibge_vizinhos","title":"Municípios vizinhos","description":"Finds nearby/neighboring municipalities.\n\nFeatures:\n- Search by IBGE code (7 digits) or municipality name\n- Returns municipalities in the same mesoregion (proximity approximation)\n- Optionally includes population data\n\nNote: Uses mesoregion as geographic proximity proxy.\nFor exact spatial neighborhood, mesh processing would be required.\n\nExamples:\n- By code: municipio=\"3550308\"\n- By name: municipi","read_only":true},{"name":"ibge_datasaude","title":"Indicadores de saúde","description":"Queries Brazil health indicators, served through IBGE's SIDRA (some originally produced by DataSUS, e.g. mortality and births).\n\nMortality and Birth:\n- mortalidade_infantil: Infant mortality rate\n- nascidos_vivos: Live births by location\n- obitos: Deaths by residence\n\nDemographic Indicators:\n- esperanca_vida: Life expectancy at birth\n- fecundidade: Fertility rate\n\nSanitation:\n- saneamento_agua: Wa","read_only":true},{"name":"ibge_paises","title":"Dados de países","description":"Queries international country data via IBGE.\n\nFeatures:\n- List all countries (following UN M49 methodology)\n- Country details (area, languages, currency, location) with the latest published value of\n  country indicators — by default population, GDP, GDP per capita, HDI and life expectancy\n- Pick other indicators with indicadores=\"<ids or aliases separated by |>\"\n- Indicator catalog as published by","read_only":true},{"name":"ibge_cidades","title":"Panorama municipal (Cidades@)","description":"Queries municipal indicators from IBGE (similar to Cidades@ portal).\n\nFeatures:\n- General overview of a municipality (population, HDI, GDP, etc.)\n- Query specific indicators\n- Historical indicator data over years\n- List available surveys and indicators\n\nAvailable indicators: populacao, area, densidade, pib_per_capita, idh,\nescolarizacao, mortalidade, salario_medio, receitas, despesas\n\nExamples:\n- ","read_only":true},{"name":"search","title":"Busca para Deep Research","description":"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).\n\nThis tool exists for the OpenAI Deep Research contract: ChatGPT deep research, company knowledge and research workflows over the Responses API require exactly the tools `","read_only":true},{"name":"fetch","title":"Documento para Deep Research","description":"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.\n\nCompanion of `search` in the OpenAI Deep Research contract, over the IBGE (Brazilian official statistics: SIDRA tables, municipalities, known indicators) catalog. Only ids returned by `search` are valid; an unknow","read_only":true}],"server_info":{"name":"ibge-br-mcp","version":"5.11.0","title":"IBGE Brasil MCP","websiteUrl":"https://ibge.sidneybissoli.com","icons":[{"src":"https://ibge.sidneybissoli.com/icon.png","mimeType":"image/png","sizes":["512x512"]}]},"category":"health","tags":["open-data","productivity","travel"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-01-18","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-sidneybissoli-ibge-br-mcp/"}