IBGE Brasil MCP
An MCP server providing 23 tools to query official IBGE APIs for Brazilian geographic, demographic, economic, and health data. It returns live, exact figures with provenance, including table names, periods, and source URLs, supporting queries about population, GDP, unemployment, and municipal distributions.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://ibge.sidneybissoli.com/mcpWhat its tools do
23 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (23)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Query population data from the 2022 Census
- List municipalities by state
- Compare GDP of Southeast capitals
- Retrieve unemployment rates by quarter
Source and maintenance
Community listingRegistry 5.11.0
- Maintenance checked
Protocol and capabilities
- Server
- ibge-br-mcp 5.11.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 23 advertised
- Resources
- 5 advertised
- Resource templates
- 0 advertised
- Prompts
- 2 advertised
Server-advertised capabilities
{
"tools": {
"listChanged": true
},
"prompts": {
"listChanged": true
},
"resources": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
23 advertised
ibge_estados — Estados do Brasil
Advertised read-onlyOpen-world
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 abbreviation: ordenar="sigla" Use a different tool when: - Municipalities of a state → ibge_municipios - Details/hierarchy of one locality by code → ibge_localidade Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown table.
ibge_estados input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"regiao": {
"enum": [
"N",
"NE",
"SE",
"S",
"CO"
],
"type": "string",
"description": "Filtrar por região: N (Norte), NE (Nordeste), SE (Sudeste), S (Sul), CO (Centro-Oeste)"
},
"ordenar": {
"enum": [
"id",
"nome",
"sigla"
],
"type": "string",
"default": "nome",
"description": "Campo para ordenação dos resultados"
}
},
"additionalProperties": false
}ibge_estados output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"estados",
"total",
"provenance",
"attribution"
],
"properties": {
"total": {
"type": "number",
"description": "Total de estados retornados"
},
"estados": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"sigla",
"nome",
"regiao"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE do estado"
},
"nome": {
"type": "string",
"description": "Nome do estado"
},
"sigla": {
"type": "string",
"description": "Sigla da UF"
},
"regiao": {
"type": "string",
"description": "Nome da região"
}
},
"additionalProperties": false
},
"description": "Lista de estados"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
}
},
"additionalProperties": false
}ibge_estados annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_municipios — Municípios do Brasil
Advertised read-onlyOpen-world
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="Campinas" - MG municipalities containing "Belo": uf="MG", busca="Belo" Use a different tool when: - Resolve/decode a code at any level (region, state, district), not just municipalities → ibge_geocodigo - Full details/hierarchy of one locality by code → ibge_localidade - Neighboring municipalities → ibge_vizinhos Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown table.
ibge_municipios input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"uf": {
"type": "string",
"description": "Estado por sigla (SP), nome (São Paulo) ou código IBGE (35). Se não informado, retorna todos os municípios do Brasil."
},
"busca": {
"type": "string",
"description": "Termo para buscar no nome do município"
},
"limite": {
"type": "number",
"default": 100,
"maximum": 5570,
"minimum": 1,
"description": "Número máximo de resultados (padrão: 100, máximo: 5570)"
}
},
"additionalProperties": false
}ibge_municipios output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"municipios",
"total",
"provenance",
"attribution"
],
"properties": {
"uf": {
"type": "string",
"description": "UF informada no filtro (como recebida na entrada)"
},
"busca": {
"type": "string",
"description": "Termo de busca aplicado ao nome do município"
},
"total": {
"type": "number",
"description": "Total de municípios encontrados antes do limite"
},
"municipios": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE do município"
},
"nome": {
"type": "string",
"description": "Nome do município"
}
},
"additionalProperties": false
},
"description": "Lista de municípios retornados (após filtro e limite)"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
}
},
"additionalProperties": false
}ibge_municipios annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_localidade — Detalhes de localidade
Advertised read-onlyOpen-world
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=3550308 - District: codigo=355030805 This tool returns the full record of ONE locality you already have the code for. Use a different tool when: - You have a name and need the code → ibge_municipios (municipalities) or ibge_geocodigo (any level) - You want to decompose/understand a code's structure → ibge_geocodigo Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown record.
ibge_localidade input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"codigo"
],
"properties": {
"tipo": {
"enum": [
"estado",
"municipio",
"distrito"
],
"type": "string",
"description": "Tipo da localidade. Se não informado, será inferido pelo tamanho do código."
},
"codigo": {
"type": "number",
"description": "Código IBGE da localidade (estado: 2 dígitos, município: 7 dígitos, distrito: 9 dígitos)"
}
},
"additionalProperties": false
}ibge_localidade output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tipo",
"id",
"nome",
"provenance",
"attribution"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE da localidade"
},
"nome": {
"type": "string",
"description": "Nome da localidade"
},
"tipo": {
"enum": [
"estado",
"municipio",
"distrito"
],
"type": "string",
"description": "Tipo da localidade retornada"
},
"sigla": {
"type": "string",
"description": "Sigla da UF (apenas para estados)"
},
"estado": {
"type": "object",
"required": [
"id",
"sigla",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE do estado"
},
"nome": {
"type": "string",
"description": "Nome do estado"
},
"sigla": {
"type": "string",
"description": "Sigla da UF"
}
},
"description": "Estado da localidade (município ou distrito)",
"additionalProperties": false
},
"regiao": {
"type": "object",
"required": [
"id",
"sigla",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE da região"
},
"nome": {
"type": "string",
"description": "Nome da região"
},
"sigla": {
"type": "string",
"description": "Sigla da região"
}
},
"description": "Região do estado (apenas para estados)",
"additionalProperties": false
},
"municipio": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE do município"
},
"nome": {
"type": "string",
"description": "Nome do município"
}
},
"description": "Município ao qual o distrito pertence (apenas para distritos)",
"additionalProperties": false
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"mesorregiao": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE da mesorregião"
},
"nome": {
"type": "string",
"description": "Nome da mesorregião"
}
},
"description": "Mesorregião do município",
"additionalProperties": false
},
"microrregiao": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE da microrregião"
},
"nome": {
"type": "string",
"description": "Nome da microrregião"
}
},
"description": "Microrregião do município",
"additionalProperties": false
},
"regiaoImediata": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE da região imediata"
},
"nome": {
"type": "string",
"description": "Nome da região imediata"
}
},
"description": "Região imediata do município",
"additionalProperties": false
},
"regiaoIntermediaria": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "Código IBGE da região intermediária"
},
"nome": {
"type": "string",
"description": "Nome da região intermediária"
}
},
"description": "Região intermediária do município",
"additionalProperties": false
}
},
"additionalProperties": false
}ibge_localidade annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_sidra — Consulta de tabelas SIDRA
Advertised read-onlyOpen-world
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 (Census 2022) - 4099: Unemployment rate (PNAD Contínua, quarterly) - 5436: Average real income (PNAD Contínua, quarterly) - 1846: Quarterly GDP at current prices (Brazil) - 5938: Municipal GDP at current prices (annual, down to municipality) - 6784: Annual GDP and GDP per capita (Brazil) Territorial levels: - 1: Brazil - 2: Region (North, Northeast, etc.) - 3: State (UF) - 6: Municipality - 7: Metropolitan Region Examples: - Brazil population 2023: tabela="6579", periodos="2023" - Population by state: tabela="6579", nivel_territorial="3" - Census 2022 by municipality: tabela="9514", nivel_territorial="6", localidades="3550308" What each number is: every record carries the SIDRA period column (code and label, e.g. "Mês (Código)" 202403 / "Mês" "março 2024") and the "Variável" label — the only place that says whether a value is a monthly change, a year-to-date or 12-month accumulation, an index number or a level; read it before adding, subtracting or comparing values. A PNAD rolling quarter ("jun-jul-ago 2026") is a three-month window that moves every month, not a calendar quarter. Revisions: values are what SIDRA publishes at the extraction instant (retrieved_at); IBGE revises published figures (quarterly GDP at each release, PNAD reweighting, annual revisions of PIM/PMC/PMS) and the API keeps no earlier version. Statistics mode: for **largest/smallest/mean/median/distribution/ranking** questions ("which municipality has the largest population?", "median GDP by state") use estatisticas=true — it computes min/max/mean/median/std-dev/labeled percentiles over ALL data rows BEFORE pagination and returns top/bottom rankings (default 10, cap 100 via topN), so one call answers what would otherwise require paging thousands of records. With agruparPor="<column label>" (e.g. "Unidade da Federação", "Ano") it ranks groups by descending sum, each with its own mini-distribution. Queries mixing several variables auto-group by "Variável" (units differ). SIDRA absence markers ("-", "..", "...", "X") are excluded from n. In this mode pagina/campos/formato are ignored and registros comes empty. Very large queries are refused by the source (since 2026-09-16 SIDRA tables are read through the Aggregates API, whose ceiling is lower than SIDRA's old 100,000-value cap: all municipalities × 12 yearly periods fails, × 8 works) — narrow periodos (e.g. "last 4") or raise nivel_territorial. ibge_sidra is the low-level engine. Prefer a friendlier wrapper when it fits: - Census themes (1970–2022) → ibge_censo - Economic/social time series → ibge_indicadores - Rank/compare 2–10 localities → ibge_comparar - One municipality's panel → ibge_cidades Use ibge_sidra_tabelas and ibge_sidra_metadados to find a table code and its structure before querying. Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.
ibge_sidra input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tabela"
],
"properties": {
"topN": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)"
},
"campos": {
"type": "string",
"description": "Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta. Omitir traz todas."
},
"pagina": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Página de resultados (100 registros por página)"
},
"tabela": {
"type": "string",
"description": "Código da tabela SIDRA (ex: 6579 para estimativas de população, 9514 para censo 2022)"
},
"formato": {
"enum": [
"json",
"tabela"
],
"type": "string",
"default": "tabela",
"description": "Formato de saída: 'json' para dados brutos ou 'tabela' para formato legível"
},
"periodos": {
"type": "string",
"default": "last",
"description": "Períodos: 'last' para último, 'all' para todos, ou anos específicos (ex: 2020,2021,2022)"
},
"variaveis": {
"type": "string",
"default": "allxp",
"description": "IDs das variáveis separados por vírgula, ou 'allxp' para todas"
},
"agruparPor": {
"type": "string",
"description": "Com estatisticas=true, agrupa pela coluna informada (rótulo, ex: 'Unidade da Federação', 'Ano') e ranqueia os grupos por soma decrescente (grupos[0] = maior total), cada grupo com sua mini-distribuição. Nome curto ('UF', 'estado', 'cidade', 'região') e rótulo parcial ('Federação') são resolvidos, e a resposta diz em `aviso` por qual coluna agrupou; rótulo que casa com duas colunas é recusado em vez de escolhido"
},
"localidades": {
"type": "string",
"default": "all",
"description": "Códigos das localidades separados por vírgula, ou 'all' para todas"
},
"estatisticas": {
"type": "boolean",
"default": false,
"description": "Computa estatísticas (mínimo/máximo/média/mediana/desvio-padrão/percentis) sobre TODOS os registros da consulta, antes da paginação, + ranking top/bottom. Use para 'qual o maior/menor', 'média', 'mediana', 'distribuição', 'ranking'. Quando true, ignora pagina, campos e formato"
},
"classificacoes": {
"type": "string",
"description": "Classificações no formato 'id[categorias]' (ex: '2[6794]' para sexo masculino)"
},
"nivel_territorial": {
"type": "string",
"default": "1",
"description": "Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Município, 7=Região Metropolitana, 8=Mesorregião, 9=Microrregião, 10=Distrito, 11=Subdistrito, 13=RM/RIDE, 14=RIDE, 15=Aglomeração Urbana, 17=Região Geográfica Imediata, 18=Região Geográfica Intermediária, 105=Macrorregião de Saúde, 106=Região de Saúde, 114=Aglomerado Subnormal, 127=Amazônia Legal, 128=Semiárido"
}
},
"additionalProperties": false
}ibge_sidra output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tabela",
"nome",
"totalRegistros",
"colunas",
"registros",
"unidades",
"paginacao",
"provenance",
"attribution"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome da tabela (quando conhecido)"
},
"tabela": {
"type": "string",
"description": "Código da tabela SIDRA consultada"
},
"colunas": {
"type": "array",
"items": {
"type": "string"
},
"description": "Rótulos das colunas, na ordem"
},
"unidades": {
"type": "array",
"items": {
"type": "object",
"required": [
"variavel",
"nomeVariavel",
"unidade",
"multiplicador"
],
"properties": {
"unidade": {
"type": [
"string",
"null"
],
"description": "Unidade de medida como a fonte publica, com a escala no texto (ex.: 'Mil pessoas', 'Milhões de Reais'); null se a fonte não diz"
},
"variavel": {
"type": [
"string",
"null"
],
"description": "Código da variável SIDRA (null se a resposta não tem a dimensão Variável)"
},
"nomeVariavel": {
"type": [
"string",
"null"
],
"description": "Nome da variável"
},
"multiplicador": {
"type": [
"number",
"null"
],
"description": "Multiplicador de escala publicado à parte; o SIDRA não publica — sempre null, a escala está no texto da unidade"
}
},
"additionalProperties": false
},
"description": "Unidade de medida de cada variável da resposta, FORA de `registros`: não some com `campos` nem com a paginação. Leia antes de citar um valor — 'Mil pessoas' significa que 1.234 são 1,234 milhão de pessoas"
},
"paginacao": {
"type": "object",
"required": [
"pagina",
"porPagina",
"totalPaginas",
"temMais"
],
"properties": {
"pagina": {
"type": "number",
"description": "Página devolvida (o pedido é ajustado ao intervalo 1..totalPaginas)"
},
"temMais": {
"type": "boolean",
"description": "true quando há página seguinte (use pagina+1); sempre false com estatisticas=true"
},
"porPagina": {
"type": "number",
"description": "Registros por página (fixo em 100)"
},
"totalPaginas": {
"type": "number",
"description": "Total de páginas disponíveis"
}
},
"description": "Metadados de paginação para continuação",
"additionalProperties": false
},
"registros": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"description": "Registros da página atual: cada um mapeia rótulo da coluna -> valor"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"estatisticas": {
"type": "object",
"required": [
"colunaValor",
"registrosConsiderados",
"registrosSemValor"
],
"properties": {
"top": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Maiores valores, com as colunas de identificação do registro (sem agruparPor)"
},
"aviso": {
"type": "string",
"description": "Avisos sobre agrupamento automático, mistura de unidades ou truncamento"
},
"bottom": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Menores valores (sem agruparPor)"
},
"grupos": {
"type": "array",
"items": {
"type": "object",
"required": [
"n",
"soma",
"minimo",
"maximo",
"media",
"mediana",
"desvioPadrao",
"percentis",
"grupo"
],
"properties": {
"n": {
"type": "number",
"description": "Registros com valor numérico considerados"
},
"soma": {
"type": "number",
"description": "Soma dos valores considerados"
},
"grupo": {
"type": "string"
},
"media": {
"type": "number",
"description": "Média aritmética"
},
"maximo": {
"type": "number",
"description": "Maior valor"
},
"minimo": {
"type": "number",
"description": "Menor valor"
},
"mediana": {
"type": "number",
"description": "Mediana (percentil 50, interpolação linear)"
},
"percentis": {
"type": "array",
"items": {
"type": "object",
"required": [
"percentil",
"valor",
"rotulo"
],
"properties": {
"valor": {
"type": "number"
},
"rotulo": {
"type": "string",
"description": "Enunciado por extenso, pronto para citar ao leitor"
},
"percentil": {
"type": "number",
"description": "Percentil (50 = mediana)"
}
},
"additionalProperties": false
},
"description": "Percentis 25, 50, 75, 90, 95 e 99, cada um com o enunciado por extenso em rotulo"
},
"desvioPadrao": {
"type": "number",
"description": "Desvio-padrão populacional (divide por n: os dados são censitários, não amostra)"
}
},
"additionalProperties": false
},
"description": "Grupos ordenados por soma decrescente, cada um com sua mini-distribuição (com agruparPor)"
},
"agrupadoPor": {
"type": "string",
"description": "Rótulo da coluna de agrupamento (com agruparPor)"
},
"colunaValor": {
"type": "string",
"description": "Rótulo da coluna numérica analisada (sempre 'Valor' no SIDRA)"
},
"totalGrupos": {
"type": "number",
"description": "Total de grupos existentes antes do teto (com agruparPor)"
},
"distribuicao": {
"type": "object",
"required": [
"n",
"soma",
"minimo",
"maximo",
"media",
"mediana",
"desvioPadrao",
"percentis"
],
"properties": {
"n": {
"type": "number",
"description": "Registros com valor numérico considerados"
},
"soma": {
"type": "number",
"description": "Soma dos valores considerados"
},
"media": {
"type": "number",
"description": "Média aritmética"
},
"maximo": {
"type": "number",
"description": "Maior valor"
},
"minimo": {
"type": "number",
"description": "Menor valor"
},
"mediana": {
"type": "number",
"description": "Mediana (percentil 50, interpolação linear)"
},
"percentis": {
"type": "array",
"items": {
"type": "object",
"required": [
"percentil",
"valor",
"rotulo"
],
"properties": {
"valor": {
"type": "number"
},
"rotulo": {
"type": "string",
"description": "Enunciado por extenso, pronto para citar ao leitor"
},
"percentil": {
"type": "number",
"description": "Percentil (50 = mediana)"
}
},
"additionalProperties": false
},
"description": "Percentis 25, 50, 75, 90, 95 e 99, cada um com o enunciado por extenso em rotulo"
},
"desvioPadrao": {
"type": "number",
"description": "Desvio-padrão populacional (divide por n: os dados são censitários, não amostra)"
}
},
"description": "Distribuição do conjunto inteiro (sem agruparPor)",
"additionalProperties": false
},
"registrosSemValor": {
"type": "number",
"description": "Registros excluídos por marcador de ausência SIDRA ('-', '..', '...', 'X') ou valor não numérico"
},
"registrosConsiderados": {
"type": "number",
"description": "Registros com valor numérico (contam no n)"
}
},
"description": "Bloco estatístico presente quando estatisticas=true (registros vem vazio nesse modo)",
"additionalProperties": false
},
"totalRegistros": {
"type": "number",
"description": "Total de registros de dados disponíveis (todas as páginas)"
}
},
"additionalProperties": false
}ibge_sidra annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_nomes — Frequência e ranking de nomes
Advertised read-onlyOpen-world
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 Available decades: 1930-2010 Examples: - Frequency of "Maria": tipo="frequencia", nomes="Maria" - Compare names: tipo="frequencia", nomes="João,José,Pedro" - 2000s ranking: tipo="ranking", decada=2000 - Female names: tipo="ranking", sexo="F" Behavior: read-only and idempotent — a live GET against the public IBGE Nomes (Censo) API. Returns a Markdown table.
ibge_nomes input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tipo"
],
"properties": {
"sexo": {
"enum": [
"M",
"F"
],
"type": "string",
"description": "Filtrar por sexo: M (masculino) ou F (feminino)"
},
"tipo": {
"enum": [
"frequencia",
"ranking"
],
"type": "string",
"description": "Tipo de consulta: 'frequencia' para buscar nomes específicos ou 'ranking' para ver os mais populares"
},
"nomes": {
"type": "string",
"description": "Para tipo='frequencia': Nome ou nomes separados por vírgula"
},
"decada": {
"type": "number",
"description": "Para tipo='ranking': Década do ranking (ex: 1990, 2000, 2010)"
},
"limite": {
"type": "number",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Para tipo='ranking': Número de nomes (padrão: 20)"
},
"localidade": {
"type": "string",
"description": "Código IBGE da localidade (UF: 2 dígitos, Município: 7 dígitos)"
}
},
"additionalProperties": false
}ibge_nomes output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tipo",
"provenance",
"attribution"
],
"properties": {
"tipo": {
"enum": [
"frequencia",
"ranking"
],
"type": "string",
"description": "Tipo da consulta realizada"
},
"ranking": {
"type": "object",
"required": [
"localidade",
"itens"
],
"properties": {
"sexo": {
"type": [
"string",
"null"
],
"description": "Sexo do ranking: M, F ou nulo"
},
"itens": {
"type": "array",
"items": {
"type": "object",
"required": [
"ranking",
"nome",
"frequencia"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome"
},
"ranking": {
"type": "number",
"description": "Posição no ranking"
},
"frequencia": {
"type": "number",
"description": "Frequência de registros do nome"
}
},
"additionalProperties": false
},
"description": "Itens do ranking, limitados pelo parâmetro 'limite'"
},
"decada": {
"type": "number",
"description": "Década do ranking, quando informada"
},
"localidade": {
"type": "string",
"description": "Código IBGE da localidade (ou BR para Brasil)"
}
},
"description": "Resultado do ranking (presente quando tipo='ranking')",
"additionalProperties": false
},
"frequencia": {
"type": "array",
"items": {
"type": "object",
"required": [
"nome",
"localidade",
"periodos",
"total"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome consultado"
},
"sexo": {
"type": [
"string",
"null"
],
"description": "Sexo do nome: M, F ou nulo"
},
"total": {
"type": "number",
"description": "Soma das frequências de todos os períodos"
},
"periodos": {
"type": "array",
"items": {
"type": "object",
"required": [
"periodo",
"frequencia"
],
"properties": {
"periodo": {
"type": "string",
"description": "Período/década (ex: '1930[', '1990,2000[')"
},
"frequencia": {
"type": "number",
"description": "Frequência de registros do nome no período"
}
},
"additionalProperties": false
},
"description": "Frequência do nome por período"
},
"localidade": {
"type": "string",
"description": "Código IBGE da localidade (ou BR para Brasil)"
}
},
"additionalProperties": false
},
"description": "Resultados de frequência (presente quando tipo='frequencia')"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
}
},
"additionalProperties": false
}ibge_nomes annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_noticias — Notícias do IBGE
Advertised read-onlyOpen-world
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 10 most recent items. Parameters: - busca: free-text term to match (e.g. "PIB", "censo") - tipo: "release" (official publication of survey results) or "noticia" (general news); omit for both - de / ate: date range, format DD/MM/AAAA (e.g. de="01/01/2024", ate="31/12/2024") - destaque: true to return only featured items - quantidade: how many to return (default 10, max 100); pagina: page number to page through more Each item returns: title, type (release/news), publication date, editoria (section), related products/surveys, a featured flag, a plain-text summary, and a link to the full article. The header reports the total count and current page. Examples: - Latest 10 news: (no parameters) - Search census: busca="censo" - 2024 news: de="01/01/2024", ate="31/12/2024" - Releases only: tipo="release" Use a different tool when: - Scheduled/upcoming release dates (not yet published) → ibge_calendario Behavior: read-only and idempotent — a live GET against the public IBGE Notícias API. Returns a Markdown list.
ibge_noticias input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"de": {
"type": "string",
"description": "Data inicial no formato DD/MM/AAAA (ex: 01/01/2024)"
},
"ate": {
"type": "string",
"description": "Data final no formato DD/MM/AAAA (ex: 31/12/2024)"
},
"tipo": {
"enum": [
"release",
"noticia"
],
"type": "string",
"description": "Tipo de publicação: 'release' ou 'noticia'"
},
"busca": {
"type": "string",
"description": "Termo para buscar nas notícias"
},
"pagina": {
"type": "number",
"default": 1,
"minimum": 1,
"description": "Número da página para paginação"
},
"destaque": {
"type": "boolean",
"description": "Filtrar apenas notícias em destaque"
},
"quantidade": {
"type": "number",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Quantidade de notícias a retornar (padrão: 10, máximo: 100)"
}
},
"additionalProperties": false
}ibge_noticias output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"noticias",
"total",
"pagina",
"totalPaginas",
"provenance",
"attribution"
],
"properties": {
"busca": {
"type": "string",
"description": "Termo de busca aplicado, se houver"
},
"total": {
"type": "number",
"description": "Total de notícias encontradas na consulta"
},
"pagina": {
"type": "number",
"description": "Página atual"
},
"noticias": {
"type": "array",
"items": {
"type": "object",
"required": [
"titulo",
"tipo",
"dataPublicacao",
"link"
],
"properties": {
"link": {
"type": "string",
"description": "URL para a publicação completa"
},
"tipo": {
"type": "string",
"description": "Tipo de publicação (ex: 'Release' ou 'Notícia')"
},
"titulo": {
"type": "string",
"description": "Título da notícia ou release"
},
"destaque": {
"type": "boolean",
"description": "Indica se a publicação está em destaque"
},
"produtos": {
"type": "string",
"description": "Produtos do IBGE relacionados à publicação"
},
"editorias": {
"type": "string",
"description": "Editoria(s) associada(s) à publicação"
},
"introducao": {
"type": "string",
"description": "Introdução/resumo da publicação (texto limpo)"
},
"dataPublicacao": {
"type": "string",
"description": "Data de publicação (formato original da API)"
}
},
"additionalProperties": false
},
"description": "Lista de notícias retornadas"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"totalPaginas": {
"type": "number",
"description": "Número total de páginas"
}
},
"additionalProperties": false
}ibge_noticias annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_sidra_tabelas — Busca de tabelas SIDRA
Advertised read-onlyOpen-world
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→sexo); when that happens the response says so in notas_vocabulario - Filter by survey (Census, PNAD, GDP, etc.) - Shows code and name of each table SIDRA contains data from various surveys: - Demographic Census - PNAD Contínua (employment, income) - National Accounts (GDP) - Industrial Survey - Agricultural Survey Examples: - List tables: (no parameters) - Search population tables: busca="população" - Census tables: pesquisa="censo" This is step 1 of the SIDRA workflow: find a table code → ibge_sidra_metadados (structure) → ibge_sidra (query). For common data, a wrapper is usually easier: ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades. Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns a Markdown table.
ibge_sidra_tabelas input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"busca": {
"type": "string",
"description": "Termos para buscar no nome das tabelas/agregados (sem distinção de acento ou caixa; AND entre as palavras; a palavra de todo dia é traduzida para a do IBGE — renda→rendimento, desemprego→desocupação, cidade→município)"
},
"limite": {
"type": "number",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Número máximo de resultados (padrão: 20)"
},
"pesquisa": {
"type": "string",
"description": "Filtrar por código ou nome da pesquisa (ex: 'censo', 'pnad', 'pib')"
}
},
"additionalProperties": false
}ibge_sidra_tabelas output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tabelas",
"total",
"provenance",
"attribution"
],
"properties": {
"busca": {
"type": "string",
"description": "Termo de busca aplicado, se houver"
},
"total": {
"type": "number",
"description": "Total de tabelas que correspondem aos critérios"
},
"tabelas": {
"type": "array",
"items": {
"type": "object",
"required": [
"codigo",
"nome"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome da tabela/agregado"
},
"codigo": {
"type": "string",
"description": "Código da tabela/agregado SIDRA"
},
"pesquisa": {
"type": "string",
"description": "Pesquisa de origem (código - nome)"
}
},
"additionalProperties": false
},
"description": "Lista de tabelas SIDRA retornadas"
},
"pesquisa": {
"type": "string",
"description": "Filtro de pesquisa aplicado, se houver"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"notas_vocabulario": {
"type": "array",
"items": {
"type": "string"
},
"description": "Quando a busca foi ampliada para a palavra que o IBGE usa (renda→rendimento), diz qual"
}
},
"additionalProperties": false
}ibge_sidra_tabelas annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_sidra_metadados — Metadados de tabela SIDRA
Advertised read-onlyOpen-world
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. Examples: - Population table metadata: tabela="6579" - Census 2022 metadata: tabela="9514" - PNAD unemployment: tabela="4714" Use this after finding a table code (ibge_sidra_tabelas) and before querying with ibge_sidra. Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown.
ibge_sidra_metadados input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tabela"
],
"properties": {
"tabela": {
"type": "string",
"description": "Código da tabela/agregado SIDRA (ex: '6579', '9514', '4714')"
},
"incluir_periodos": {
"type": "boolean",
"default": true,
"description": "Incluir lista de períodos disponíveis (padrão: true)"
},
"incluir_localidades": {
"type": "boolean",
"default": false,
"description": "Incluir níveis territoriais disponíveis (padrão: false)"
}
},
"additionalProperties": false
}ibge_sidra_metadados output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"codigo",
"nome",
"provenance",
"attribution"
],
"properties": {
"url": {
"type": "string",
"description": "URL da tabela no SIDRA"
},
"nome": {
"type": "string",
"description": "Nome da tabela"
},
"codigo": {
"type": "string",
"description": "Código da tabela/agregado SIDRA"
},
"assunto": {
"type": "string",
"description": "Assunto/tema da tabela"
},
"periodos": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"literais"
],
"properties": {
"id": {
"type": "string",
"description": "Código do período"
},
"literais": {
"type": "array",
"items": {
"type": "string"
},
"description": "Descrições textuais do período"
}
},
"additionalProperties": false
},
"description": "Períodos disponíveis para a tabela (quando incluir_periodos)"
},
"pesquisa": {
"type": "string",
"description": "Nome da pesquisa de origem"
},
"variaveis": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "ID da variável"
},
"nome": {
"type": "string",
"description": "Nome da variável"
},
"unidade": {
"type": "string",
"description": "Unidade de medida da variável"
},
"classificacoes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"nome",
"categorias"
],
"properties": {
"id": {
"type": "number",
"description": "ID da classificação"
},
"nome": {
"type": "string",
"description": "Nome da classificação"
},
"categorias": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "number",
"description": "ID da categoria"
},
"nome": {
"type": "string",
"description": "Nome da categoria"
},
"nivel": {
"type": "number",
"description": "Nível hierárquico da categoria"
},
"unidade": {
"type": "string",
"description": "Unidade da categoria"
}
},
"additionalProperties": false
},
"description": "Categorias da classificação"
}
},
"additionalProperties": false
},
"description": "Classificações aplicáveis à variável"
}
},
"additionalProperties": false
},
"description": "Variáveis da tabela, com unidades e classificações/categorias"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"periodicidade": {
"type": "object",
"properties": {
"fim": {
"type": "number",
"description": "Ano/período final da série"
},
"inicio": {
"type": "number",
"description": "Ano/período inicial da série"
},
"frequencia": {
"type": "string",
"description": "Frequência de coleta (ex: anual, mensal)"
}
},
"description": "Periodicidade da pesquisa",
"additionalProperties": false
},
"niveisTerritoriais": {
"type": "array",
"items": {
"type": "object",
"required": [
"codigo",
"nome"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome do nível territorial (ex: Brasil, UF, Município)"
},
"codigo": {
"type": "string",
"description": "Código do nível territorial (ex: N1, N3, N6)"
}
},
"additionalProperties": false
},
"description": "Níveis territoriais disponíveis para a tabela"
}
},
"additionalProperties": false
}ibge_sidra_metadados annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_malhas — Malhas geográficas
Advertised read-onlyOpen-world
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" or "1" = Entire Brazil - State abbreviation (e.g., "SP", "RJ") - State code (e.g., "35" for SP) - Municipality code (7 digits) Resolution (internal divisions): - 0 = Outline only - 2 = States - 5 = Municipalities Examples: - Brazil with states: localidade="BR", resolucao="2" - São Paulo with municipalities: localidade="SP", resolucao="5" - SVG format: localidade="BR", formato="svg" Use a different tool when: - Thematic meshes (biomes, Legal Amazon, semi-arid, metropolitan regions) → ibge_malhas_tema Behavior: read-only and idempotent — a live GET against the public IBGE Malhas API. Returns the mesh in the requested format (GeoJSON, TopoJSON, or SVG).
ibge_malhas input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"localidade"
],
"properties": {
"tipo": {
"enum": [
"paises",
"regioes",
"estados",
"mesorregioes",
"microrregioes",
"municipios",
"regioes-imediatas",
"regioes-intermediarias"
],
"type": "string",
"description": "Tipo de divisão territorial"
},
"formato": {
"enum": [
"geojson",
"topojson",
"svg"
],
"type": "string",
"default": "geojson",
"description": "Formato de saída (padrão: geojson)"
},
"qualidade": {
"enum": [
"1",
"2",
"3",
"4",
"minima",
"intermediaria",
"maxima"
],
"type": "string",
"default": "maxima",
"description": "Qualidade do traçado: 'minima', 'intermediaria' ou 'maxima' (padrão). Os números 1–4 do IBGE antigo continuam aceitos e são traduzidos."
},
"resolucao": {
"enum": [
"0",
"1",
"2",
"3",
"4",
"5"
],
"type": "string",
"default": "0",
"description": "Divisões internas a desenhar dentro da malha pedida:\n0 = Sem divisões internas (só o contorno)\n1 = Macrorregiões (apenas quando localidade=BR)\n2 = Unidades da Federação (BR ou uma região)\n3 = Mesorregiões\n4 = Microrregiões\n5 = Municípios\nCada nível aceita só as divisões menores que ele: município aceita nenhuma, UF aceita 3, 4 e 5."
},
"localidade": {
"type": "string",
"description": "Código IBGE ou sigla da localidade (ex: 'BR', 'SP', '35', '3550308')"
},
"intrarregiao": {
"type": "string",
"description": "Divisão interna pelo nome, alternativa a resolucao: 'regiao', 'UF', 'regiao-intermediaria', 'regiao-imediata', 'mesorregiao', 'microrregiao' ou 'municipio'. Quando informado, prevalece sobre resolucao."
}
},
"additionalProperties": false
}ibge_malhas output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"localidade",
"formato",
"provenance",
"attribution"
],
"properties": {
"url": {
"type": "string",
"description": "URL para download da malha completa"
},
"tipo": {
"type": "string",
"description": "Tipo de divisão territorial, quando informado"
},
"formato": {
"type": "string",
"description": "Formato de saída solicitado (geojson, topojson ou svg)"
},
"qualidade": {
"type": "string",
"description": "Qualidade do traçado solicitada"
},
"resolucao": {
"type": "string",
"description": "Resolução/divisões internas solicitada"
},
"localidade": {
"type": "string",
"description": "Código IBGE ou sigla da localidade consultada"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"intrarregiao": {
"type": "string",
"description": "Divisão interna desenhada dentro da malha (vocabulário da API v3)"
}
},
"additionalProperties": false
}ibge_malhas annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_pesquisas — Pesquisas do IBGE
Advertised read-onlyOpen-world
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**: Employment, income, education - **National Accounts**: GDP, investments - **Economic Surveys**: Industry, Commerce, Services - **Price Indices**: IPCA, INPC Examples: - List all: (no parameters) - Search population: busca="população" - PNAD details: detalhes="pnad" This lists surveys, not data. To find table codes use ibge_sidra_tabelas; to query data use ibge_sidra (or a wrapper: ibge_censo, ibge_indicadores, ibge_comparar, ibge_cidades). Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA/Pesquisas API. Returns a Markdown list.
ibge_pesquisas input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"busca": {
"type": "string",
"description": "Termo para buscar no nome ou ID da pesquisa"
},
"detalhes": {
"type": "string",
"description": "Código da pesquisa para ver detalhes e tabelas disponíveis"
}
},
"additionalProperties": false
}ibge_pesquisas output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"modo",
"provenance",
"attribution"
],
"properties": {
"modo": {
"enum": [
"lista",
"detalhes"
],
"type": "string",
"description": "Modo de consulta que originou este resultado: lista de pesquisas ou detalhes de uma"
},
"busca": {
"type": "string",
"description": "Termo de busca aplicado, se houver (modo lista)"
},
"total": {
"type": "number",
"description": "Total de pesquisas encontradas (modo lista)"
},
"pesquisa": {
"type": "object",
"required": [
"id",
"nome",
"totalTabelas",
"tabelas"
],
"properties": {
"id": {
"type": "string",
"description": "Código da pesquisa"
},
"nome": {
"type": "string",
"description": "Nome da pesquisa"
},
"tabelas": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "string",
"description": "Código da tabela (agregado)"
},
"nome": {
"type": "string",
"description": "Nome da tabela"
}
},
"additionalProperties": false
},
"description": "Tabelas disponíveis na pesquisa"
},
"totalTabelas": {
"type": "number",
"description": "Quantidade de tabelas da pesquisa"
}
},
"description": "Detalhes de uma pesquisa específica (modo detalhes)",
"additionalProperties": false
},
"pesquisas": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"nome",
"totalTabelas"
],
"properties": {
"id": {
"type": "string",
"description": "Código da pesquisa"
},
"nome": {
"type": "string",
"description": "Nome da pesquisa"
},
"totalTabelas": {
"type": "number",
"description": "Quantidade de tabelas (agregados) da pesquisa"
}
},
"additionalProperties": false
},
"description": "Lista de pesquisas (modo lista)"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
}
},
"additionalProperties": false
}ibge_pesquisas annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_censo — Censo Demográfico
Advertised read-onlyOpen-world
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 - idade_sexo: Age pyramid - religiao: Religion distribution - cor_raca: Race/color - rendimento: Monthly income - educacao: Education level - trabalho: Employment Examples: - Population 2022: ano="2022", tema="populacao" - Historical series: ano="todos", tema="populacao" - Literacy 2010 by state: ano="2010", tema="alfabetizacao", nivel_territorial="3" - List tables: tema="listar" Statistics mode: for largest/smallest/mean/median/distribution/ranking questions over census data ("which municipality had the largest 2022 population?") use estatisticas=true — full distribution + top/bottom computed over ALL rows before truncation; agruparPor="<column label>" ranks groups by descending sum. In this mode campos/formato are ignored and registros comes empty. Use a different tool when: - One municipality's current panel (estimate, HDI, GDP) → ibge_cidades - Comparing/ranking localities → ibge_comparar - An arbitrary SIDRA table → ibge_sidra Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.
ibge_censo input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ano": {
"enum": [
"1970",
"1980",
"1991",
"2000",
"2010",
"2022",
"todos"
],
"type": "string",
"description": "Ano do censo (1970, 1980, 1991, 2000, 2010, 2022) ou 'todos' para série histórica"
},
"tema": {
"enum": [
"populacao",
"alfabetizacao",
"domicilios",
"idade_sexo",
"religiao",
"cor_raca",
"rendimento",
"migracao",
"educacao",
"trabalho",
"indigenas",
"quilombolas",
"saneamento",
"deficiencia",
"nupcialidade",
"fecundidade",
"listar"
],
"type": "string",
"default": "populacao",
"description": "Tema dos dados:\n- populacao: População residente\n- alfabetizacao: Taxa de alfabetização\n- domicilios: Características dos domicílios\n- idade_sexo: Pirâmide etária\n- religiao: Distribuição por religião\n- cor_raca: Cor ou raça\n- rendimento: Rendimento mensal\n- migracao: Migração\n- educacao: Nível de instrução\n- trabalho: Ocupação e trabalho\n- indigenas: População indígena\n- quilombolas: População quilombola\n- saneamento: Abastecimento de água e esgoto\n- deficiencia: Pessoas com deficiência\n- nupcialidade: Estado civil\n- fecundidade: Taxa de fecundidade\n- listar: Lista tabelas disponíveis"
},
"topN": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)"
},
"campos": {
"type": "string",
"description": "Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta."
},
"formato": {
"enum": [
"tabela",
"json"
],
"type": "string",
"default": "tabela",
"description": "Formato de saída"
},
"agruparPor": {
"type": "string",
"description": "Com estatisticas=true, agrupa pela coluna informada (rótulo, ex: 'Unidade da Federação', 'Ano') e ranqueia os grupos por soma decrescente (grupos[0] = maior total), cada grupo com sua mini-distribuição. Nome curto ('UF', 'estado', 'cidade', 'região') e rótulo parcial ('Federação') são resolvidos, e a resposta diz em `aviso` por qual coluna agrupou; rótulo que casa com duas colunas é recusado em vez de escolhido"
},
"localidades": {
"type": "string",
"default": "all",
"description": "Códigos das localidades ou 'all'"
},
"estatisticas": {
"type": "boolean",
"default": false,
"description": "Computa estatísticas (mínimo/máximo/média/mediana/desvio-padrão/percentis) sobre TODOS os registros da consulta, antes da paginação, + ranking top/bottom. Use para 'qual o maior/menor', 'média', 'mediana', 'distribuição', 'ranking'. Quando true, ignora pagina, campos e formato"
},
"nivel_territorial": {
"type": "string",
"default": "1",
"description": "Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Município"
}
},
"additionalProperties": false
}ibge_censo output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"totalRegistros",
"colunas",
"registros",
"unidades",
"provenance",
"attribution"
],
"properties": {
"ano": {
"type": "string",
"description": "Ano(s) de referência"
},
"tema": {
"type": "string",
"description": "Tema do censo consultado"
},
"tabela": {
"type": "string",
"description": "Tabela SIDRA de origem"
},
"colunas": {
"type": "array",
"items": {
"type": "string"
},
"description": "Rótulos das colunas, na ordem"
},
"unidades": {
"type": "array",
"items": {
"type": "object",
"required": [
"variavel",
"nomeVariavel",
"unidade",
"multiplicador"
],
"properties": {
"unidade": {
"type": [
"string",
"null"
],
"description": "Unidade de medida como a fonte publica, com a escala no texto (ex.: 'Mil pessoas', 'Milhões de Reais'); null se a fonte não diz"
},
"variavel": {
"type": [
"string",
"null"
],
"description": "Código da variável SIDRA (null se a resposta não tem a dimensão Variável)"
},
"nomeVariavel": {
"type": [
"string",
"null"
],
"description": "Nome da variável"
},
"multiplicador": {
"type": [
"number",
"null"
],
"description": "Multiplicador de escala publicado à parte; o SIDRA não publica — sempre null, a escala está no texto da unidade"
}
},
"additionalProperties": false
},
"description": "Unidade de medida de cada variável da resposta, FORA de `registros`: não some com `campos` nem com a paginação. Leia antes de citar um valor — 'Mil pessoas' significa que 1.234 são 1,234 milhão de pessoas"
},
"descricao": {
"type": "string",
"description": "Descrição da tabela"
},
"registros": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"description": "Registros: cada um mapeia rótulo da coluna -> valor"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"estatisticas": {
"type": "object",
"required": [
"colunaValor",
"registrosConsiderados",
"registrosSemValor"
],
"properties": {
"top": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Maiores valores, com as colunas de identificação do registro (sem agruparPor)"
},
"aviso": {
"type": "string",
"description": "Avisos sobre agrupamento automático, mistura de unidades ou truncamento"
},
"bottom": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Menores valores (sem agruparPor)"
},
"grupos": {
"type": "array",
"items": {
"type": "object",
"required": [
"n",
"soma",
"minimo",
"maximo",
"media",
"mediana",
"desvioPadrao",
"percentis",
"grupo"
],
"properties": {
"n": {
"type": "number",
"description": "Registros com valor numérico considerados"
},
"soma": {
"type": "number",
"description": "Soma dos valores considerados"
},
"grupo": {
"type": "string"
},
"media": {
"type": "number",
"description": "Média aritmética"
},
"maximo": {
"type": "number",
"description": "Maior valor"
},
"minimo": {
"type": "number",
"description": "Menor valor"
},
"mediana": {
"type": "number",
"description": "Mediana (percentil 50, interpolação linear)"
},
"percentis": {
"type": "array",
"items": {
"type": "object",
"required": [
"percentil",
"valor",
"rotulo"
],
"properties": {
"valor": {
"type": "number"
},
"rotulo": {
"type": "string",
"description": "Enunciado por extenso, pronto para citar ao leitor"
},
"percentil": {
"type": "number",
"description": "Percentil (50 = mediana)"
}
},
"additionalProperties": false
},
"description": "Percentis 25, 50, 75, 90, 95 e 99, cada um com o enunciado por extenso em rotulo"
},
"desvioPadrao": {
"type": "number",
"description": "Desvio-padrão populacional (divide por n: os dados são censitários, não amostra)"
}
},
"additionalProperties": false
},
"description": "Grupos ordenados por soma decrescente, cada um com sua mini-distribuição (com agruparPor)"
},
"agrupadoPor": {
"type": "string",
"description": "Rótulo da coluna de agrupamento (com agruparPor)"
},
"colunaValor": {
"type": "string",
"description": "Rótulo da coluna numérica analisada (sempre 'Valor' no SIDRA)"
},
"totalGrupos": {
"type": "number",
"description": "Total de grupos existentes antes do teto (com agruparPor)"
},
"distribuicao": {
"type": "object",
"required": [
"n",
"soma",
"minimo",
"maximo",
"media",
"mediana",
"desvioPadrao",
"percentis"
],
"properties": {
"n": {
"type": "number",
"description": "Registros com valor numérico considerados"
},
"soma": {
"type": "number",
"description": "Soma dos valores considerados"
},
"media": {
"type": "number",
"description": "Média aritmética"
},
"maximo": {
"type": "number",
"description": "Maior valor"
},
"minimo": {
"type": "number",
"description": "Menor valor"
},
"mediana": {
"type": "number",
"description": "Mediana (percentil 50, interpolação linear)"
},
"percentis": {
"type": "array",
"items": {
"type": "object",
"required": [
"percentil",
"valor",
"rotulo"
],
"properties": {
"valor": {
"type": "number"
},
"rotulo": {
"type": "string",
"description": "Enunciado por extenso, pronto para citar ao leitor"
},
"percentil": {
"type": "number",
"description": "Percentil (50 = mediana)"
}
},
"additionalProperties": false
},
"description": "Percentis 25, 50, 75, 90, 95 e 99, cada um com o enunciado por extenso em rotulo"
},
"desvioPadrao": {
"type": "number",
"description": "Desvio-padrão populacional (divide por n: os dados são censitários, não amostra)"
}
},
"description": "Distribuição do conjunto inteiro (sem agruparPor)",
"additionalProperties": false
},
"registrosSemValor": {
"type": "number",
"description": "Registros excluídos por marcador de ausência SIDRA ('-', '..', '...', 'X') ou valor não numérico"
},
"registrosConsiderados": {
"type": "number",
"description": "Registros com valor numérico (contam no n)"
}
},
"description": "Bloco estatístico presente quando estatisticas=true (registros vem vazio nesse modo)",
"additionalProperties": false
},
"totalRegistros": {
"type": "number",
"description": "Total de registros de dados"
}
},
"additionalProperties": false
}ibge_censo annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_indicadores — Indicadores econômicos e sociais
Advertised read-onlyOpen-world
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 prices, R$ (Brazil only) - industria: industrial production index, general industry (2022=100) - comercio: retail sales volume index (2022=100) - servicos: services volume index (2022=100, Brazil only) **Prices:** - ipca: IPCA monthly change, % - ipca_acumulado: IPCA accumulated over 12 months, % - inpc: INPC monthly change, % **Labor:** - desemprego: Unemployment rate - ocupacao: Employed people (thousands) - rendimento: average real income from all jobs, R$ — each period is a ROLLING quarter (e.g. "jun-jul-ago 2026"), Brazil only - informalidade: Informality rate **Population:** - populacao: Population estimate - densidade: Population density Examples: - GDP: indicador="pib" - IPCA last 12 months: indicador="ipca", periodos="last 12" - Unemployment by state: indicador="desemprego", nivel_territorial="3" - List indicators: indicador="listar" Each indicator returns ONE variable — the one its name says; for another one of the same table (e.g. the year-to-date change) use ibge_sidra with variaveis. What each number is: every record carries the SIDRA period column (code and label, e.g. "Mês (Código)" 202403 / "Mês" "março 2024") and the "Variável" label — the only place that says whether a value is a monthly change, a year-to-date or 12-month accumulation, an index number or a level; read it before adding, subtracting or comparing values. A PNAD rolling quarter ("jun-jul-ago 2026") is a three-month window that moves every month, not a calendar quarter. Revisions: values are what SIDRA publishes at the extraction instant (retrieved_at); IBGE revises published figures (quarterly GDP at each release, PNAD reweighting, annual revisions of PIM/PMC/PMS) and the API keeps no earlier version. Statistics mode: for largest/smallest/mean/median/distribution/ranking questions ("which state has the highest unemployment?", "median informality rate across states") use estatisticas=true — full distribution + top/bottom over ALL rows before truncation; agruparPor="<column label>" (e.g. "Unidade da Federação", "Trimestre") ranks groups by descending sum. In this mode campos/formato are ignored and registros comes empty. Use a different tool when: - Comparing/ranking localities → ibge_comparar - Census themes → ibge_censo - One municipality's panel → ibge_cidades Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.
ibge_indicadores input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"topN": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)"
},
"campos": {
"type": "string",
"description": "Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta."
},
"formato": {
"enum": [
"tabela",
"json"
],
"type": "string",
"default": "tabela",
"description": "Formato de saída"
},
"periodos": {
"type": "string",
"default": "last",
"description": "Períodos (ex: '2023', 'last', 'last 4')"
},
"categoria": {
"enum": [
"economico",
"precos",
"trabalho",
"populacao",
"agropecuaria",
"todos"
],
"type": "string",
"description": "Filtrar por categoria de indicadores"
},
"indicador": {
"type": "string",
"description": "Nome do indicador (ex: \"pib\", \"ipca\", \"desemprego\", \"populacao\").\nUse \"listar\" para ver todos os indicadores disponíveis."
},
"agruparPor": {
"type": "string",
"description": "Com estatisticas=true, agrupa pela coluna informada (rótulo, ex: 'Unidade da Federação', 'Ano') e ranqueia os grupos por soma decrescente (grupos[0] = maior total), cada grupo com sua mini-distribuição. Nome curto ('UF', 'estado', 'cidade', 'região') e rótulo parcial ('Federação') são resolvidos, e a resposta diz em `aviso` por qual coluna agrupou; rótulo que casa com duas colunas é recusado em vez de escolhido"
},
"localidades": {
"type": "string",
"default": "all",
"description": "Códigos das localidades ou 'all'"
},
"estatisticas": {
"type": "boolean",
"default": false,
"description": "Computa estatísticas (mínimo/máximo/média/mediana/desvio-padrão/percentis) sobre TODOS os registros da consulta, antes da paginação, + ranking top/bottom. Use para 'qual o maior/menor', 'média', 'mediana', 'distribuição', 'ranking'. Quando true, ignora pagina, campos e formato"
},
"nivel_territorial": {
"type": "string",
"default": "1",
"description": "Nível territorial (código N): 1=Brasil, 2=Região, 3=UF"
}
},
"additionalProperties": false
}ibge_indicadores output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"totalRegistros",
"colunas",
"registros",
"unidades",
"provenance",
"attribution"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome do indicador"
},
"tabela": {
"type": "string",
"description": "Tabela SIDRA de origem"
},
"colunas": {
"type": "array",
"items": {
"type": "string"
},
"description": "Rótulos das colunas, na ordem"
},
"unidades": {
"type": "array",
"items": {
"type": "object",
"required": [
"variavel",
"nomeVariavel",
"unidade",
"multiplicador"
],
"properties": {
"unidade": {
"type": [
"string",
"null"
],
"description": "Unidade de medida como a fonte publica, com a escala no texto (ex.: 'Mil pessoas', 'Milhões de Reais'); null se a fonte não diz"
},
"variavel": {
"type": [
"string",
"null"
],
"description": "Código da variável SIDRA (null se a resposta não tem a dimensão Variável)"
},
"nomeVariavel": {
"type": [
"string",
"null"
],
"description": "Nome da variável"
},
"multiplicador": {
"type": [
"number",
"null"
],
"description": "Multiplicador de escala publicado à parte; o SIDRA não publica — sempre null, a escala está no texto da unidade"
}
},
"additionalProperties": false
},
"description": "Unidade de medida de cada variável da resposta, FORA de `registros`: não some com `campos` nem com a paginação. Leia antes de citar um valor — 'Mil pessoas' significa que 1.234 são 1,234 milhão de pessoas"
},
"indicador": {
"type": "string",
"description": "Chave do indicador consultado"
},
"registros": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"description": "Registros: cada um mapeia rótulo da coluna -> valor"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"estatisticas": {
"type": "object",
"required": [
"colunaValor",
"registrosConsiderados",
"registrosSemValor"
],
"properties": {
"top": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Maiores valores, com as colunas de identificação do registro (sem agruparPor)"
},
"aviso": {
"type": "string",
"description": "Avisos sobre agrupamento automático, mistura de unidades ou truncamento"
},
"bottom": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Menores valores (sem agruparPor)"
},
"grupos": {
"type": "array",
"items": {
"type": "object",
"required": [
"n",
"soma",
"minimo",
"maximo",
"media",
"mediana",
"desvioPadrao",
"percentis",
"grupo"
],
"properties": {
"n": {
"type": "number",
"description": "Registros com valor numérico considerados"
},
"soma": {
"type": "number",
"description": "Soma dos valores considerados"
},
"grupo": {
"type": "string"
},
"media": {
"type": "number",
"description": "Média aritmética"
},
"maximo": {
"type": "number",
"description": "Maior valor"
},
"minimo": {
"type": "number",
"description": "Menor valor"
},
"mediana": {
"type": "number",
"description": "Mediana (percentil 50, interpolação linear)"
},
"percentis": {
"type": "array",
"items": {
"type": "object",
"required": [
"percentil",
"valor",
"rotulo"
],
"properties": {
"valor": {
"type": "number"
},
"rotulo": {
"type": "string",
"description": "Enunciado por extenso, pronto para citar ao leitor"
},
"percentil": {
"type": "number",
"description": "Percentil (50 = mediana)"
}
},
"additionalProperties": false
},
"description": "Percentis 25, 50, 75, 90, 95 e 99, cada um com o enunciado por extenso em rotulo"
},
"desvioPadrao": {
"type": "number",
"description": "Desvio-padrão populacional (divide por n: os dados são censitários, não amostra)"
}
},
"additionalProperties": false
},
"description": "Grupos ordenados por soma decrescente, cada um com sua mini-distribuição (com agruparPor)"
},
"agrupadoPor": {
"type": "string",
"description": "Rótulo da coluna de agrupamento (com agruparPor)"
},
"colunaValor": {
"type": "string",
"description": "Rótulo da coluna numérica analisada (sempre 'Valor' no SIDRA)"
},
"totalGrupos": {
"type": "number",
"description": "Total de grupos existentes antes do teto (com agruparPor)"
},
"distribuicao": {
"type": "object",
"required": [
"n",
"soma",
"minimo",
"maximo",
"media",
"mediana",
"desvioPadrao",
"percentis"
],
"properties": {
"n": {
"type": "number",
"description": "Registros com valor numérico considerados"
},
"soma": {
"type": "number",
"description": "Soma dos valores considerados"
},
"media": {
"type": "number",
"description": "Média aritmética"
},
"maximo": {
"type": "number",
"description": "Maior valor"
},
"minimo": {
"type": "number",
"description": "Menor valor"
},
"mediana": {
"type": "number",
"description": "Mediana (percentil 50, interpolação linear)"
},
"percentis": {
"type": "array",
"items": {
"type": "object",
"required": [
"percentil",
"valor",
"rotulo"
],
"properties": {
"valor": {
"type": "number"
},
"rotulo": {
"type": "string",
"description": "Enunciado por extenso, pronto para citar ao leitor"
},
"percentil": {
"type": "number",
"description": "Percentil (50 = mediana)"
}
},
"additionalProperties": false
},
"description": "Percentis 25, 50, 75, 90, 95 e 99, cada um com o enunciado por extenso em rotulo"
},
"desvioPadrao": {
"type": "number",
"description": "Desvio-padrão populacional (divide por n: os dados são censitários, não amostra)"
}
},
"description": "Distribuição do conjunto inteiro (sem agruparPor)",
"additionalProperties": false
},
"registrosSemValor": {
"type": "number",
"description": "Registros excluídos por marcador de ausência SIDRA ('-', '..', '...', 'X') ou valor não numérico"
},
"registrosConsiderados": {
"type": "number",
"description": "Registros com valor numérico (contam no n)"
}
},
"description": "Bloco estatístico presente quando estatisticas=true (registros vem vazio nesse modo)",
"additionalProperties": false
},
"totalRegistros": {
"type": "number",
"description": "Total de registros de dados"
}
},
"additionalProperties": false
}ibge_indicadores annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_cnae — Classificação CNAE
Advertised read-onlyOpen-world
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): 673 classes - Subclass (7 digits): 1,332 subclasses Features: - Search by CNAE code - Search by activity description - List by hierarchical level - Show complete hierarchy Examples: - Search software: busca="software" - Specific code: codigo="6201-5/01" - View section: codigo="J" - List divisions: nivel="divisoes" Behavior: read-only and idempotent — a live GET against the public IBGE CNAE API. Returns Markdown.
ibge_cnae input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"busca": {
"type": "string",
"description": "Termo para buscar na descrição das atividades (ex: 'software', 'restaurante', 'comércio').\nAcento e caixa não importam, e várias palavras casam em E ('comercio varejista').\nA palavra de todo dia é traduzida para a da CNAE quando preciso — farmácia →\nprodutos farmacêuticos, academia → condicionamento físico, lixo → resíduos — e a\nresposta diz quando traduziu."
},
"nivel": {
"enum": [
"secoes",
"divisoes",
"grupos",
"classes",
"subclasses"
],
"type": "string",
"description": "Nível hierárquico para listar (padrão: mostra todos os níveis relevantes)"
},
"codigo": {
"type": "string",
"description": "Código CNAE para buscar (seção, divisão, grupo, classe ou subclasse).\nExemplos:\n- Seção: \"A\" (agricultura)\n- Divisão: \"01\" (agricultura e pecuária)\n- Grupo: \"01.1\" (produção de lavouras)\n- Classe: \"01.11\" (cultivo de cereais)\n- Subclasse: \"0111-3/01\" (cultivo de arroz)"
},
"limite": {
"type": "number",
"default": 20,
"description": "Número máximo de resultados (padrão: 20)"
}
},
"additionalProperties": false
}ibge_cnae output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"modo",
"provenance",
"attribution"
],
"properties": {
"modo": {
"enum": [
"busca",
"codigo",
"lista",
"estrutura"
],
"type": "string",
"description": "Modo de resposta que gerou os dados"
},
"busca": {
"type": "object",
"required": [
"termo",
"nivel",
"total",
"encontrados",
"resultados"
],
"properties": {
"nivel": {
"type": "string",
"description": "Nível hierárquico pesquisado (ex: subclasses, classes)"
},
"termo": {
"type": "string",
"description": "Termo pesquisado"
},
"total": {
"type": "number",
"description": "Quantidade de resultados retornados"
},
"resultados": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"descricao"
],
"properties": {
"id": {
"type": "string",
"description": "Código CNAE da atividade"
},
"descricao": {
"type": "string",
"description": "Descrição da atividade"
}
},
"additionalProperties": false
},
"description": "Atividades encontradas para o termo"
},
"encontrados": {
"type": "number",
"description": "Quantidade de atividades que casam o termo no catálogo inteiro (pode ser maior que 'total', que é limitado por 'limite')"
},
"notas_vocabulario": {
"type": "array",
"items": {
"type": "string"
},
"description": "Presente quando o termo foi traduzido para a palavra que a CNAE usa (ex: farmácia → produtos farmacêuticos)"
}
},
"description": "Presente no modo de busca por termo",
"additionalProperties": false
},
"lista": {
"type": "object",
"required": [
"nivel",
"total",
"exibidos",
"registros"
],
"properties": {
"nivel": {
"type": "string",
"description": "Nível hierárquico listado"
},
"total": {
"type": "number",
"description": "Total de registros existentes no nível"
},
"exibidos": {
"type": "number",
"description": "Quantidade de registros exibidos (limitada por 'limite')"
},
"registros": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"descricao"
],
"properties": {
"id": {
"type": "string",
"description": "Código CNAE do registro"
},
"descricao": {
"type": "string",
"description": "Descrição do registro"
}
},
"additionalProperties": false
},
"description": "Registros do nível listado"
}
},
"description": "Presente no modo de listagem por nível",
"additionalProperties": false
},
"codigo": {
"type": "object",
"required": [
"id",
"descricao",
"nivel"
],
"properties": {
"id": {
"type": "string",
"description": "Código CNAE consultado"
},
"nivel": {
"type": "string",
"description": "Nível do código (secao, divisao, grupo, classe ou subclasse)"
},
"descricao": {
"type": "string",
"description": "Descrição do código"
},
"hierarquia": {
"type": "array",
"items": {
"type": "object",
"required": [
"nivel",
"id",
"descricao"
],
"properties": {
"id": {
"type": "string",
"description": "Código do nível"
},
"nivel": {
"type": "string",
"description": "Nível hierárquico (Seção, Divisão, Grupo, Classe, Subclasse)"
},
"descricao": {
"type": "string",
"description": "Descrição do nível"
}
},
"additionalProperties": false
},
"description": "Cadeia hierárquica do código (do mais geral ao mais específico)"
},
"observacoes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Observações/notas explicativas do código"
}
},
"description": "Presente no modo de consulta por código",
"additionalProperties": false
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
}
},
"additionalProperties": false
}ibge_cnae annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_geocodigo — Códigos geográficos do IBGE
Advertised read-onlyOpen-world
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-West) - 2 digits: State (11-53) - 7 digits: Municipality - 9 digits: District Examples: - Decode municipality: codigo="3550308" - Decode state: codigo="35" - Search by name: nome="São Paulo" - Municipality in state: nome="Campinas", uf="SP" This tool decodes a code's structure and resolves name→code at any level. Use a different tool when: - You only need to list/search municipalities → ibge_municipios - You want the full detailed record of one locality → ibge_localidade Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns Markdown.
ibge_geocodigo input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"uf": {
"type": "string",
"description": "Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) para restringir a busca por nome de município"
},
"nome": {
"type": "string",
"description": "Nome da localidade para encontrar o código IBGE (estado ou município)"
},
"codigo": {
"type": "string",
"description": "Código IBGE para decodificar.\nFormatos aceitos:\n- 1 dígito: Região (1-5)\n- 2 dígitos: UF (11-53)\n- 7 dígitos: Município\n- 9 dígitos: Distrito"
}
},
"additionalProperties": false
}ibge_geocodigo output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tipo",
"provenance",
"attribution"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome da localidade resolvida"
},
"tipo": {
"enum": [
"regiao",
"uf",
"municipio",
"distrito",
"lista"
],
"type": "string",
"description": "Tipo do resultado: localidade decodificada (regiao/uf/municipio/distrito) ou lista de municípios encontrados (lista)"
},
"sigla": {
"type": "string",
"description": "Sigla da região ou UF, quando aplicável"
},
"total": {
"type": "number",
"description": "Quantidade de municípios encontrados na busca por nome (apenas tipo lista)"
},
"codigo": {
"type": "number",
"description": "Código IBGE da localidade resolvida (ausente em resultados do tipo lista)"
},
"regiao": {
"type": "string",
"description": "Nome da região à qual a UF pertence (apenas tipo uf)"
},
"estados": {
"type": "array",
"items": {
"type": "object",
"required": [
"codigo",
"sigla",
"nome"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome da UF"
},
"sigla": {
"type": "string",
"description": "Sigla da UF"
},
"codigo": {
"type": "number",
"description": "Código IBGE da UF"
}
},
"additionalProperties": false
},
"description": "Estados pertencentes à região (apenas tipo regiao)"
},
"matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"codigo",
"nome"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome do município"
},
"codigo": {
"type": "number",
"description": "Código IBGE (7 dígitos) do município"
}
},
"additionalProperties": false
},
"description": "Municípios encontrados na busca por nome (apenas tipo lista)"
},
"hierarquia": {
"type": "array",
"items": {
"type": "object",
"required": [
"nivel",
"codigo",
"nome"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome da localidade neste nível"
},
"nivel": {
"type": "string",
"description": "Nome do nível territorial (Região, UF, Município, etc.)"
},
"codigo": {
"type": "number",
"description": "Código IBGE do nível"
}
},
"additionalProperties": false
},
"description": "Hierarquia geográfica completa, da região ao município/distrito (tipo municipio/distrito)"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"codigoSidra": {
"type": "string",
"description": "Código SIDRA de 6 dígitos do município (apenas tipo municipio)"
},
"regiaoCodigo": {
"type": "number",
"description": "Código IBGE da região à qual a UF pertence (apenas tipo uf)"
}
},
"additionalProperties": false
}ibge_geocodigo annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_calendario — Calendário de divulgações
Advertised read-onlyOpen-world
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 Examples: - Upcoming releases: (no parameters) - IPCA releases: produto="IPCA" - 2024 calendar: de="01/01/2024", ate="31/12/2024" - Field collections: tipo="coleta" Use a different tool when: - Already-published news and releases → ibge_noticias Behavior: read-only and idempotent — a live GET against the public IBGE Calendário API. Returns a Markdown list.
ibge_calendario input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"de": {
"type": "string",
"description": "Data inicial no formato DD/MM/AAAA (ex: '01/01/2024')"
},
"ate": {
"type": "string",
"description": "Data final no formato DD/MM/AAAA (ex: '31/12/2024')"
},
"tipo": {
"enum": [
"divulgacao",
"coleta",
"todos"
],
"type": "string",
"default": "divulgacao",
"description": "Tipo de evento: 'divulgacao' (publicações), 'coleta' (pesquisas de campo), ou 'todos'"
},
"pagina": {
"type": "number",
"default": 1,
"description": "Número da página (padrão: 1)"
},
"produto": {
"type": "string",
"description": "Filtrar por produto/pesquisa (ex: 'IPCA', 'PNAD', 'PIB')"
},
"quantidade": {
"type": "number",
"default": 20,
"description": "Quantidade de resultados por página (padrão: 20)"
}
},
"additionalProperties": false
}ibge_calendario output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"eventos",
"total",
"provenance",
"attribution"
],
"properties": {
"total": {
"type": "number",
"description": "Total de eventos disponíveis para os critérios"
},
"pagina": {
"type": "number",
"description": "Página atual retornada"
},
"eventos": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"titulo",
"produto",
"dataDivulgacao",
"tipoId",
"tipo"
],
"properties": {
"id": {
"type": "number",
"description": "Identificador do evento no calendário"
},
"link": {
"type": "string",
"description": "Link para mais informações, quando disponível"
},
"tipo": {
"type": "string",
"description": "Descrição do tipo do evento"
},
"tipoId": {
"type": "number",
"description": "ID do tipo (1 = divulgação, 2 = coleta)"
},
"titulo": {
"type": "string",
"description": "Título do evento"
},
"produto": {
"type": "string",
"description": "Nome do produto/pesquisa associado"
},
"dataDivulgacao": {
"type": "string",
"description": "Data/hora de divulgação no formato 'DD/MM/AAAA HH:MM:SS'"
}
},
"additionalProperties": false
},
"description": "Lista de eventos do calendário (divulgações/coletas)"
},
"produto": {
"type": "string",
"description": "Filtro de produto aplicado, quando informado"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"totalPaginas": {
"type": "number",
"description": "Total de páginas disponíveis"
}
},
"additionalProperties": false
}ibge_calendario annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_comparar — Comparação entre localidades
Advertised read-onlyOpen-world
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 - domicilios: Number of households Features: - Compare up to 10 localities at once - Calculate statistics (max, min, average, variation) - Generate ranked output - Accept municipality codes (7 digits) or state codes (2 digits) Examples: - Compare capitals: localidades="3550308,3304557,4106902", indicador="populacao" - Compare states: localidades="35,33,41", indicador="pib" - Area ranking: localidades="3550308,3304557", formato="ranking" - List indicators: indicador="listar" Use this tool ONLY to rank/compare 2–10 localities on one indicator. For a single locality, use ibge_cidades (municipal panel), ibge_censo, or ibge_sidra. Behavior: read-only and idempotent — a live GET against the public IBGE APIs (SIDRA and Localidades). Returns Markdown plus a typed structuredContent payload.
ibge_comparar input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"localidades"
],
"properties": {
"formato": {
"enum": [
"tabela",
"json",
"ranking"
],
"type": "string",
"default": "tabela",
"description": "Formato de saída: tabela, json ou ranking (ordenado)"
},
"indicador": {
"enum": [
"populacao",
"populacao_censo",
"pib",
"area",
"densidade",
"alfabetizacao",
"domicilios",
"listar"
],
"type": "string",
"default": "populacao",
"description": "Indicador para comparação:\n- populacao: Estimativa populacional atual\n- populacao_censo: População do Censo 2022\n- pib: PIB a preços correntes (Mil Reais)\n- area: Área territorial (km²)\n- densidade: Densidade demográfica (hab/km²)\n- alfabetizacao: Taxa de alfabetização\n- domicilios: Número de domicílios\n- listar: Lista indicadores disponíveis"
},
"localidades": {
"type": "string",
"description": "Códigos IBGE das localidades separados por vírgula (ex: \"3550308,3304557,4106902\").\nUse 7 dígitos para municípios, 2 dígitos para UFs."
}
},
"additionalProperties": false
}ibge_comparar output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"localidades",
"unidades",
"provenance",
"attribution"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome do indicador"
},
"tabela": {
"type": "string",
"description": "Tabela SIDRA de origem"
},
"formato": {
"type": "string",
"description": "Formato solicitado"
},
"unidades": {
"type": "array",
"items": {
"type": "object",
"required": [
"variavel",
"nomeVariavel",
"unidade",
"multiplicador"
],
"properties": {
"unidade": {
"type": [
"string",
"null"
],
"description": "Unidade de medida como a fonte publica, com a escala no texto (ex.: 'Mil pessoas', 'Milhões de Reais'); null se a fonte não diz"
},
"variavel": {
"type": [
"string",
"null"
],
"description": "Código da variável SIDRA (null se a resposta não tem a dimensão Variável)"
},
"nomeVariavel": {
"type": [
"string",
"null"
],
"description": "Nome da variável"
},
"multiplicador": {
"type": [
"number",
"null"
],
"description": "Multiplicador de escala publicado à parte; o SIDRA não publica — sempre null, a escala está no texto da unidade"
}
},
"additionalProperties": false
},
"description": "Unidade de medida de cada variável da resposta, FORA de `registros`: não some com `campos` nem com a paginação. Leia antes de citar um valor — 'Mil pessoas' significa que 1.234 são 1,234 milhão de pessoas"
},
"indicador": {
"type": "string",
"description": "Indicador comparado"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"localidades": {
"type": "array",
"items": {
"type": "object",
"required": [
"codigo",
"nome",
"valor",
"valorTexto"
],
"properties": {
"nome": {
"type": "string"
},
"valor": {
"type": [
"number",
"null"
]
},
"codigo": {
"type": "string"
},
"valorTexto": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Localidades comparadas, com o valor do indicador"
},
"estatisticas": {
"type": "object",
"required": [
"maior",
"menor",
"media",
"variacaoPct"
],
"properties": {
"maior": {
"type": "number",
"description": "Maior valor entre as localidades com valor"
},
"media": {
"type": "number",
"description": "Média aritmética dos valores das localidades"
},
"menor": {
"type": "number",
"description": "Menor valor entre as localidades com valor"
},
"variacaoPct": {
"type": "number",
"description": "Quanto o maior supera o menor, em % ((maior/menor - 1) x 100; 0 se o menor for 0)"
}
},
"description": "Estatísticas agregadas (quando há ao menos 2 valores positivos)",
"additionalProperties": false
}
},
"additionalProperties": false
}ibge_comparar annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_malhas_tema — Malhas temáticas
Advertised read-onlyOpen-world
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 municipalities - fronteira: border-strip municipalities - metropolitana: metropolitan regions - ride: Integrated Development Regions - listar: the catalogue itself, without querying the source Filtering with `codigo`: only the recortes that have a per-feature code accept it — biomas (the biome code) and the two municipality ones, costeiro and fronteira (the 7-digit IBGE municipality code). Ask without `codigo` to see what exists; biome codes come from the source, not from a fixed table. GEOMETRY IS NOT IN THE RESPONSE, on purpose: one biome polygon alone is over 9 MB. The response carries the attributes plus a canonical WFS URL that returns the recorte with geometry in GeoJSON. Use a different tool when: - Administrative meshes WITH geometry (country/region/state/municipality outlines) → ibge_malhas Behavior: read-only and idempotent — a live GET against the public IBGE Geosserviços WFS (IBGE Geociências), which is a different service from the Malhas API and the only one that publishes these recortes. Returns Markdown plus a typed structuredContent payload.
ibge_malhas_tema input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tema"
],
"properties": {
"tema": {
"enum": [
"biomas",
"amazonia_legal",
"semiarido",
"costeiro",
"fronteira",
"metropolitana",
"ride",
"listar"
],
"type": "string",
"description": "Recorte temático do território:\n- biomas: os seis biomas continentais\n- amazonia_legal: limite da Amazônia Legal\n- semiarido: área do semiárido\n- costeiro: municípios da zona costeira\n- fronteira: municípios da faixa de fronteira\n- metropolitana: regiões metropolitanas\n- ride: Regiões Integradas de Desenvolvimento\n- listar: lista os recortes disponíveis, sem consultar a fonte"
},
"codigo": {
"type": "string",
"description": "Filtra uma feição do recorte. Só os recortes que têm código próprio aceitam: biomas (cd_bioma, ex. \"1\") e os dois de municípios, costeiro e fronteira (código IBGE de 7 dígitos). Nos demais a chamada é recusada com a lista do que aceita."
},
"limite": {
"type": "integer",
"default": 50,
"maximum": 600,
"minimum": 1,
"description": "Quantas feições trazer (padrão 50, máx. 600). O total do recorte vem sempre, mesmo quando o limite corta a lista."
}
},
"additionalProperties": false
}ibge_malhas_tema output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tema",
"provenance",
"attribution"
],
"properties": {
"tema": {
"type": "string",
"description": "Recorte solicitado (ou 'listar')"
},
"temas": {
"type": "array",
"items": {
"type": "object",
"required": [
"tema",
"nome",
"descricao"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome do recorte"
},
"tema": {
"type": "string",
"description": "Identificador do recorte"
},
"descricao": {
"type": "string",
"description": "Descrição do recorte"
}
},
"additionalProperties": false
},
"description": "Lista de recortes disponíveis (somente no modo 'listar')"
},
"camada": {
"type": "string",
"description": "Camada WFS do IBGE Geosserviços consultada"
},
"codigo": {
"type": "string",
"description": "Código usado como filtro, quando informado"
},
"feicoes": {
"type": "number",
"description": "Total de feições do recorte na fonte"
},
"registros": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Atributos de cada feição (sem geometria)"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"url_geometria": {
"type": "string",
"description": "URL canônica do WFS que devolve a malha COM geometria, em GeoJSON"
},
"feicoes_retornadas": {
"type": "number",
"description": "Quantas vieram nesta resposta"
}
},
"additionalProperties": false
}ibge_malhas_tema annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_vizinhos — Municípios vizinhos
Advertised read-onlyOpen-world
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, mesh processing would be required. Examples: - By code: municipio="3550308" - By name: municipio="Campinas", uf="SP" - With population: municipio="3550308", incluir_dados=true Note: proximity is approximated by shared mesoregion (not exact spatial adjacency). For listing/searching municipalities, use ibge_municipios. Behavior: read-only and idempotent — a live GET against the public IBGE Localidades API. Returns a Markdown list.
ibge_vizinhos input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"municipio"
],
"properties": {
"uf": {
"type": "string",
"description": "Estado por sigla (SP), nome (São Paulo) ou código IBGE (35) — obrigatório se usar nome do município"
},
"raio": {
"type": "number",
"description": "Raio em km para buscar municípios próximos (usa centróides)"
},
"municipio": {
"type": "string",
"description": "Código IBGE do município (7 dígitos) ou nome do município"
},
"incluir_dados": {
"type": "boolean",
"default": false,
"description": "Incluir dados populacionais dos vizinhos"
}
},
"additionalProperties": false
}ibge_vizinhos output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"municipio",
"vizinhos",
"total",
"provenance",
"attribution"
],
"properties": {
"total": {
"type": "number",
"description": "Quantidade de municípios próximos encontrados"
},
"vizinhos": {
"type": "array",
"items": {
"type": "object",
"required": [
"codigo",
"nome"
],
"properties": {
"uf": {
"type": "string",
"description": "Sigla da UF do município vizinho"
},
"nome": {
"type": "string",
"description": "Nome do município vizinho"
},
"codigo": {
"type": "string",
"description": "Código IBGE do município vizinho"
},
"populacao": {
"type": "number",
"description": "População do município vizinho (apenas quando incluir_dados=true)"
}
},
"additionalProperties": false
},
"description": "Lista de municípios próximos (mesma mesorregião)"
},
"municipio": {
"type": "object",
"required": [
"codigo",
"nome"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome do município consultado"
},
"codigo": {
"type": "string",
"description": "Código IBGE do município consultado"
}
},
"description": "Município de referência da consulta",
"additionalProperties": false
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
}
},
"additionalProperties": false
}ibge_vizinhos annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_datasaude — Indicadores de saúde
Advertised read-onlyOpen-world
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: - esperanca_vida: Life expectancy at birth - fecundidade: Fertility rate Sanitation: - saneamento_agua: Water supply - saneamento_esgoto: Sewage system Health Coverage: - plano_saude: Health insurance coverage - autoavaliacao_saude: Self-rated health status Territorial levels: 1=Brazil, 2=Region, 3=State, 6=Municipality Examples: - Infant mortality: indicador="mortalidade_infantil" - Life expectancy by state: indicador="esperanca_vida", nivel_territorial="3" - Deaths in SP: indicador="obitos", nivel_territorial="3", localidade="35" - List indicators: indicador="listar" Statistics mode: for largest/smallest/mean/median/distribution/ranking questions ("which state has the highest infant mortality?", "median life expectancy across states") use estatisticas=true — full distribution + top/bottom over ALL rows before truncation; agruparPor="<column label>" ranks groups by descending sum. In this mode campos/formato are ignored and registros comes empty. Use a different tool when: - A single municipality's general panel (which also includes infant mortality) → ibge_cidades - Population/demographic counts (not health-specific) → ibge_censo or ibge_sidra Behavior: read-only and idempotent — a live GET against the public IBGE SIDRA API. Returns Markdown plus a typed structuredContent payload.
ibge_datasaude input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"indicador"
],
"properties": {
"topN": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Tamanho das listas top/bottom quando estatisticas=true sem agruparPor (padrão: 10, máx: 100)"
},
"campos": {
"type": "string",
"description": "Selecionar apenas algumas colunas por rótulo, separadas por vírgula (ex: 'Valor,Ano'). Reduz o volume da resposta."
},
"formato": {
"enum": [
"tabela",
"json"
],
"type": "string",
"default": "tabela",
"description": "Formato de saída"
},
"periodo": {
"type": "string",
"default": "last",
"description": "Período: 'last', 'all', ou ano específico"
},
"indicador": {
"type": "string",
"description": "Indicador de saúde. Disponíveis:\n- mortalidade_infantil: Taxa de mortalidade infantil\n- esperanca_vida: Esperança de vida ao nascer\n- nascidos_vivos: Nascidos vivos\n- obitos: Óbitos por local de residência\n- fecundidade: Taxa de fecundidade\n- saneamento_agua: Abastecimento de água\n- saneamento_esgoto: Esgotamento sanitário\n- plano_saude: Cobertura de plano de saúde\n- listar: Lista indicadores disponíveis"
},
"agruparPor": {
"type": "string",
"description": "Com estatisticas=true, agrupa pela coluna informada (rótulo, ex: 'Unidade da Federação', 'Ano') e ranqueia os grupos por soma decrescente (grupos[0] = maior total), cada grupo com sua mini-distribuição. Nome curto ('UF', 'estado', 'cidade', 'região') e rótulo parcial ('Federação') são resolvidos, e a resposta diz em `aviso` por qual coluna agrupou; rótulo que casa com duas colunas é recusado em vez de escolhido"
},
"localidade": {
"type": "string",
"default": "all",
"description": "Código da localidade ou 'all'"
},
"estatisticas": {
"type": "boolean",
"default": false,
"description": "Computa estatísticas (mínimo/máximo/média/mediana/desvio-padrão/percentis) sobre TODOS os registros da consulta, antes da paginação, + ranking top/bottom. Use para 'qual o maior/menor', 'média', 'mediana', 'distribuição', 'ranking'. Quando true, ignora pagina, campos e formato"
},
"nivel_territorial": {
"type": "string",
"default": "1",
"description": "Nível territorial (código N): 1=Brasil, 2=Região, 3=UF, 6=Município"
}
},
"additionalProperties": false
}ibge_datasaude output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"totalRegistros",
"colunas",
"registros",
"unidades",
"provenance",
"attribution"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome do indicador"
},
"fonte": {
"type": "string",
"description": "Fonte do dado"
},
"colunas": {
"type": "array",
"items": {
"type": "string"
},
"description": "Rótulos das colunas, na ordem"
},
"unidades": {
"type": "array",
"items": {
"type": "object",
"required": [
"variavel",
"nomeVariavel",
"unidade",
"multiplicador"
],
"properties": {
"unidade": {
"type": [
"string",
"null"
],
"description": "Unidade de medida como a fonte publica, com a escala no texto (ex.: 'Mil pessoas', 'Milhões de Reais'); null se a fonte não diz"
},
"variavel": {
"type": [
"string",
"null"
],
"description": "Código da variável SIDRA (null se a resposta não tem a dimensão Variável)"
},
"nomeVariavel": {
"type": [
"string",
"null"
],
"description": "Nome da variável"
},
"multiplicador": {
"type": [
"number",
"null"
],
"description": "Multiplicador de escala publicado à parte; o SIDRA não publica — sempre null, a escala está no texto da unidade"
}
},
"additionalProperties": false
},
"description": "Unidade de medida de cada variável da resposta, FORA de `registros`: não some com `campos` nem com a paginação. Leia antes de citar um valor — 'Mil pessoas' significa que 1.234 são 1,234 milhão de pessoas"
},
"indicador": {
"type": "string",
"description": "Chave do indicador de saúde consultado"
},
"registros": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"description": "Registros: cada um mapeia rótulo da coluna -> valor"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"estatisticas": {
"type": "object",
"required": [
"colunaValor",
"registrosConsiderados",
"registrosSemValor"
],
"properties": {
"top": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Maiores valores, com as colunas de identificação do registro (sem agruparPor)"
},
"aviso": {
"type": "string",
"description": "Avisos sobre agrupamento automático, mistura de unidades ou truncamento"
},
"bottom": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Menores valores (sem agruparPor)"
},
"grupos": {
"type": "array",
"items": {
"type": "object",
"required": [
"n",
"soma",
"minimo",
"maximo",
"media",
"mediana",
"desvioPadrao",
"percentis",
"grupo"
],
"properties": {
"n": {
"type": "number",
"description": "Registros com valor numérico considerados"
},
"soma": {
"type": "number",
"description": "Soma dos valores considerados"
},
"grupo": {
"type": "string"
},
"media": {
"type": "number",
"description": "Média aritmética"
},
"maximo": {
"type": "number",
"description": "Maior valor"
},
"minimo": {
"type": "number",
"description": "Menor valor"
},
"mediana": {
"type": "number",
"description": "Mediana (percentil 50, interpolação linear)"
},
"percentis": {
"type": "array",
"items": {
"type": "object",
"required": [
"percentil",
"valor",
"rotulo"
],
"properties": {
"valor": {
"type": "number"
},
"rotulo": {
"type": "string",
"description": "Enunciado por extenso, pronto para citar ao leitor"
},
"percentil": {
"type": "number",
"description": "Percentil (50 = mediana)"
}
},
"additionalProperties": false
},
"description": "Percentis 25, 50, 75, 90, 95 e 99, cada um com o enunciado por extenso em rotulo"
},
"desvioPadrao": {
"type": "number",
"description": "Desvio-padrão populacional (divide por n: os dados são censitários, não amostra)"
}
},
"additionalProperties": false
},
"description": "Grupos ordenados por soma decrescente, cada um com sua mini-distribuição (com agruparPor)"
},
"agrupadoPor": {
"type": "string",
"description": "Rótulo da coluna de agrupamento (com agruparPor)"
},
"colunaValor": {
"type": "string",
"description": "Rótulo da coluna numérica analisada (sempre 'Valor' no SIDRA)"
},
"totalGrupos": {
"type": "number",
"description": "Total de grupos existentes antes do teto (com agruparPor)"
},
"distribuicao": {
"type": "object",
"required": [
"n",
"soma",
"minimo",
"maximo",
"media",
"mediana",
"desvioPadrao",
"percentis"
],
"properties": {
"n": {
"type": "number",
"description": "Registros com valor numérico considerados"
},
"soma": {
"type": "number",
"description": "Soma dos valores considerados"
},
"media": {
"type": "number",
"description": "Média aritmética"
},
"maximo": {
"type": "number",
"description": "Maior valor"
},
"minimo": {
"type": "number",
"description": "Menor valor"
},
"mediana": {
"type": "number",
"description": "Mediana (percentil 50, interpolação linear)"
},
"percentis": {
"type": "array",
"items": {
"type": "object",
"required": [
"percentil",
"valor",
"rotulo"
],
"properties": {
"valor": {
"type": "number"
},
"rotulo": {
"type": "string",
"description": "Enunciado por extenso, pronto para citar ao leitor"
},
"percentil": {
"type": "number",
"description": "Percentil (50 = mediana)"
}
},
"additionalProperties": false
},
"description": "Percentis 25, 50, 75, 90, 95 e 99, cada um com o enunciado por extenso em rotulo"
},
"desvioPadrao": {
"type": "number",
"description": "Desvio-padrão populacional (divide por n: os dados são censitários, não amostra)"
}
},
"description": "Distribuição do conjunto inteiro (sem agruparPor)",
"additionalProperties": false
},
"registrosSemValor": {
"type": "number",
"description": "Registros excluídos por marcador de ausência SIDRA ('-', '..', '...', 'X') ou valor não numérico"
},
"registrosConsiderados": {
"type": "number",
"description": "Registros com valor numérico (contam no n)"
}
},
"description": "Bloco estatístico presente quando estatisticas=true (registros vem vazio nesse modo)",
"additionalProperties": false
},
"totalRegistros": {
"type": "number",
"description": "Total de registros de dados"
}
},
"additionalProperties": false
}ibge_datasaude annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_paises — Dados de países
Advertised read-onlyOpen-world
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 indicators with indicadores="<ids or aliases separated by |>" - Indicator catalog as published by IBGE (34 indicators: economy, population, health, environment, networks), with unit and scale - Search countries by name - Filter by region/continent Each indicator value is the most recent one the source publishes for that country, with its year or period (some are 3- or 5-year ranges like "2021-2023"), as text (it can be "<2.5"), plus unit and scale (multiplicador) — null when the source has none. Available regions: americas, europa, africa, asia, oceania Country codes: Use ISO-ALPHA-2 (e.g., BR, US, AR, PT, JP) Examples: - List all: tipo="listar" - Brazil details: tipo="detalhes", pais="BR" - Chosen indicators: tipo="detalhes", pais="AR", indicadores="idh|77852" - Search: tipo="buscar", busca="Argentina" - Americas countries: tipo="listar", regiao="americas" - Indicator catalog: tipo="indicadores" Behavior: read-only and idempotent — a live GET against the public IBGE Países API. Returns Markdown.
ibge_paises input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"pais": {
"type": "string",
"description": "Código ISO-ALPHA-2 do país (ex: BR, US, AR) ou código M49"
},
"tipo": {
"enum": [
"listar",
"detalhes",
"indicadores",
"buscar"
],
"type": "string",
"default": "listar",
"description": "Tipo de consulta: listar (todos), detalhes (de um país), indicadores, buscar"
},
"busca": {
"type": "string",
"description": "Termo de busca para filtrar países pelo nome"
},
"regiao": {
"type": "string",
"description": "Filtrar por região/continente: americas, europa, africa, asia, oceania"
},
"indicadores": {
"type": "string",
"description": "Indicadores a trazer no modo detalhes, separados por | — IDs ou apelidos (ex: 77819|77820 ou idh|populacao). Lista completa: tipo='indicadores'. Sem este parâmetro: população, PIB, PIB per capita, IDH e esperança de vida"
}
},
"additionalProperties": false
}ibge_paises output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tipo",
"provenance",
"attribution"
],
"properties": {
"pais": {
"type": "object",
"required": [
"nome",
"m49",
"isoAlpha2",
"isoAlpha3"
],
"properties": {
"m49": {
"type": "number",
"description": "Código M49 do país"
},
"nome": {
"type": "string",
"description": "Nome do país"
},
"moedas": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"nome"
],
"properties": {
"id": {
"type": "string",
"description": "Código da unidade monetária"
},
"nome": {
"type": "string",
"description": "Nome da unidade monetária"
}
},
"additionalProperties": false
},
"description": "Unidades monetárias do país"
},
"regiao": {
"type": "string",
"description": "Nome da região/continente"
},
"linguas": {
"type": "array",
"items": {
"type": "string"
},
"description": "Línguas faladas no país"
},
"historico": {
"type": "string",
"description": "Texto histórico sobre o país"
},
"isoAlpha2": {
"type": "string",
"description": "Código ISO-ALPHA-2"
},
"isoAlpha3": {
"type": "string",
"description": "Código ISO-ALPHA-3"
},
"subRegiao": {
"type": "string",
"description": "Nome da sub-região"
},
"indicadores": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"indicador",
"valor",
"ano",
"unidade",
"multiplicador"
],
"properties": {
"id": {
"type": "number",
"description": "ID do indicador na API do IBGE"
},
"ano": {
"type": "string",
"description": "Ano ou período (ex.: '2021-2023') do valor"
},
"valor": {
"type": "string",
"description": "Valor mais recente publicado, como texto da fonte (pode ser não numérico, ex.: '<2.5')"
},
"unidade": {
"type": [
"string",
"null"
],
"description": "Unidade do valor (ex.: 'US$', '% do PIB'); null se a fonte não informa"
},
"indicador": {
"type": "string",
"description": "Nome do indicador, como a fonte o publica"
},
"multiplicador": {
"type": [
"number",
"null"
],
"description": "Escala do valor (ex.: 1000000000 = valor em bilhões da unidade); null se a fonte não informa"
}
},
"additionalProperties": false
},
"description": "Indicadores pedidos, cada um com o valor mais recente publicado"
},
"areaTotalKm2": {
"type": "number",
"description": "Área territorial total em km²"
},
"indicadoresSemValor": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"indicador"
],
"properties": {
"id": {
"type": "number",
"description": "ID do indicador na API do IBGE"
},
"indicador": {
"type": "string",
"description": "Nome do indicador, como a fonte o publica"
}
},
"additionalProperties": false
},
"description": "Indicadores pedidos para os quais a fonte não publica valor algum para o país (série inteira em branco) — ausência na fonte, não zero"
},
"regiaoIntermediaria": {
"type": "string",
"description": "Nome da região intermediária"
}
},
"description": "Detalhes de um país específico (modo detalhes)",
"additionalProperties": false
},
"tipo": {
"enum": [
"listar",
"buscar",
"detalhes",
"indicadores"
],
"type": "string",
"description": "Modo de consulta que originou este resultado"
},
"busca": {
"type": "string",
"description": "Termo de busca aplicado, se houver"
},
"total": {
"type": "number",
"description": "Total de países encontrados (modos listar/buscar)"
},
"paises": {
"type": "array",
"items": {
"type": "object",
"required": [
"codigo",
"nome",
"regiao",
"subRegiao"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome do país"
},
"codigo": {
"type": "string",
"description": "Código ISO-ALPHA-2 do país (ou '-' se ausente)"
},
"regiao": {
"type": "string",
"description": "Nome da região/continente (ou '-' se ausente)"
},
"subRegiao": {
"type": "string",
"description": "Nome da sub-região (ou '-' se ausente)"
}
},
"additionalProperties": false
},
"description": "Lista de países (modos listar/buscar). Limitada aos 50 primeiros na exibição"
},
"regiao": {
"type": "string",
"description": "Filtro de região/continente aplicado, se houver"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"indicadores": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"nome",
"alias",
"unidade",
"multiplicador"
],
"properties": {
"id": {
"type": "number",
"description": "ID do indicador na API do IBGE"
},
"nome": {
"type": "string",
"description": "Nome do indicador, como a fonte o publica"
},
"alias": {
"type": "string",
"description": "O que passar no parâmetro `indicadores`: o apelido (ex.: 'idh'), ou o próprio ID quando o indicador não tem apelido"
},
"unidade": {
"type": [
"string",
"null"
],
"description": "Unidade do indicador; null se a fonte não informa"
},
"multiplicador": {
"type": [
"number",
"null"
],
"description": "Escala dos valores; null se a fonte não informa"
}
},
"additionalProperties": false
},
"description": "Catálogo de indicadores de países publicado pelo IBGE (modo indicadores)"
}
},
"additionalProperties": false
}ibge_paises annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}ibge_cidades — Panorama municipal (Cidades@)
Advertised read-onlyOpen-world
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, pib_per_capita, idh, escolarizacao, mortalidade, salario_medio, receitas, despesas Examples: - São Paulo overview: tipo="panorama", municipio="3550308" - Population history: tipo="historico", municipio="3550308", indicador="populacao" - View surveys: tipo="pesquisas" - Available indicators: tipo="indicador" This tool is the panel for a SINGLE municipality (Cidades@). Use a different tool when: - Census themes / historical series → ibge_censo - Comparing multiple municipalities → ibge_comparar - A macro indicator time series → ibge_indicadores Behavior: read-only and idempotent — a live GET against the public IBGE APIs (Cidades@/agregados). Returns Markdown plus a typed structuredContent payload.
ibge_cidades input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"uf": {
"type": "string",
"description": "Código ou sigla da UF para filtrar (ex: 35 ou SP)"
},
"tipo": {
"enum": [
"panorama",
"indicador",
"pesquisas",
"historico"
],
"type": "string",
"default": "panorama",
"description": "Tipo de consulta: panorama (resumo geral), indicador (específico), pesquisas (listar), historico"
},
"pesquisa": {
"type": "string",
"description": "ID da pesquisa para filtrar indicadores"
},
"indicador": {
"type": "string",
"description": "ID do indicador ou nome para busca"
},
"municipio": {
"type": "string",
"description": "Código IBGE do município (7 dígitos)"
}
},
"additionalProperties": false
}ibge_cidades output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"tipo",
"indicadores",
"provenance",
"attribution"
],
"properties": {
"nome": {
"type": "string",
"description": "Nome do município/indicador"
},
"tipo": {
"type": "string",
"description": "Tipo de consulta (panorama, indicador, pesquisas, historico)"
},
"municipio": {
"type": "string",
"description": "Código IBGE do município"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
},
"indicadores": {
"type": "array",
"items": {
"type": "object",
"required": [
"nome",
"valor"
],
"properties": {
"ano": {
"type": "string"
},
"nome": {
"type": "string"
},
"valor": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Indicadores retornados (vazio para respostas de catálogo)"
}
},
"additionalProperties": false
}ibge_cidades annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search — Busca para Deep Research
Advertised read-onlyOpen-world
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 research, company knowledge and research workflows over the Responses API require exactly the tools `search` and `fetch`. Pass one of the returned ids to `fetch` to read the document. For direct questions and for data (values, series, rankings) prefer the `ibge_*` tools (`ibge_sidra`, `ibge_cidades`, `ibge_indicadores`, `ibge_comparar`…), which return the actual data with provenance — this is a catalog index, not a data query. Query: natural language or keywords, Portuguese or English; accents and case are ignored. Behavior: read-only and idempotent — the catalog comes from the public source and is cached in memory.
search input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Termos de busca em linguagem natural ou palavras-chave (acentos e caixa são ignorados)"
}
},
"additionalProperties": false
}search output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"results",
"provenance",
"attribution"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"url"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Identificador único do documento no servidor; é o que `fetch` recebe"
},
"url": {
"type": "string",
"description": "URL pública canônica do documento — a citação do ChatGPT depende dela"
},
"title": {
"type": "string",
"description": "Título legível do documento"
}
},
"additionalProperties": false
},
"description": "Documentos encontrados, em ordem de relevância"
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
}
},
"additionalProperties": false
}search annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}fetch — Documento para Deep Research
Advertised read-onlyOpen-world
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 tables, municipalities, known indicators) catalog. Only ids returned by `search` are valid; an unknown id returns an error. The `ibge_*` tools (`ibge_sidra`, `ibge_cidades`, `ibge_indicadores`, `ibge_comparar`…) remain the tools for data queries. Behavior: read-only and idempotent — a live GET against the public source when the document needs it.
fetch input schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Identificador de um documento devolvido por `search`"
}
},
"additionalProperties": false
}fetch output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"title",
"text",
"url",
"provenance",
"attribution"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Identificador único do documento no servidor; é o que `fetch` recebe"
},
"url": {
"type": "string",
"description": "URL pública canônica do documento — a citação do ChatGPT depende dela"
},
"text": {
"type": "string",
"description": "Conteúdo integral do documento, legível (Markdown)"
},
"title": {
"type": "string",
"description": "Título legível do documento"
},
"metadata": {
"type": "object",
"description": "Pares chave/valor adicionais sobre o documento (tipo, fonte, período…)",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"provenance": {
"type": "object",
"required": [
"source",
"source_url",
"data_vintage",
"retrieved_at",
"retrieval",
"citation",
"license"
],
"properties": {
"source": {
"type": "string",
"description": "Fonte oficial do dado (API do IBGE consultada)"
},
"derived": {
"type": "boolean",
"description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE"
},
"license": {
"type": [
"string",
"null"
],
"description": "Regime legal do dado"
},
"notices": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso"
},
"citation": {
"type": "string",
"description": "Citação pronta para uso"
},
"revision": {
"type": "object",
"required": [
"status",
"note"
],
"properties": {
"note": {
"type": [
"string",
"null"
],
"description": "O específico da fonte: o que revisa, quando, por quê"
},
"status": {
"enum": [
"current",
"provisional",
"final"
],
"type": "string",
"description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte"
}
},
"description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
"additionalProperties": false
},
"retrieval": {
"anyOf": [
{
"type": "object",
"required": [
"requests",
"attempts",
"anomalies",
"unstable"
],
"properties": {
"attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Tentativas somadas, incluindo as repetidas (>= requests)"
},
"requests": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Idas distintas à origem que compõem esta resposta (fatias, páginas)"
},
"unstable": {
"type": "boolean",
"description": "true se houve repetição (attempts > requests) ou alguma anomalia"
},
"anomalies": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"count"
],
"properties": {
"kind": {
"enum": [
"timeout",
"network",
"http_4xx",
"http_5xx",
"rate_limited",
"malformed_body"
],
"type": "string",
"description": "Classe da anomalia (vocabulário fechado do contrato)"
},
"count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Ocorrências desta classe na chamada"
}
},
"additionalProperties": false
},
"description": "Anomalias superadas até o sucesso, somadas por classe, em ordem fixa; [] se nenhuma"
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
},
"source_url": {
"type": "string",
"description": "URL canônica que reproduz a consulta"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Período de referência do dado segundo a fonte; null se a fonte não expõe"
},
"retrieved_at": {
"type": "string",
"description": "Instante real da extração no upstream (ISO-8601, horário de Brasília)"
},
"field_sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"fields",
"source_url",
"dataset_id",
"data_vintage",
"retrieved_at"
],
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Campos do payload atribuídos a esta sub-fonte"
},
"dataset_id": {
"type": [
"string",
"null"
],
"description": "Identificador do conjunto da sub-fonte"
},
"source_url": {
"type": "string",
"description": "URL canônica da sub-fonte que originou estes campos"
},
"data_vintage": {
"type": [
"string",
"null"
],
"description": "Vintage/competência da sub-fonte"
},
"retrieved_at": {
"type": [
"string",
"null"
],
"description": "ISO-8601 da extração desta sub-fonte na origem"
},
"served_from_cache": {
"type": [
"boolean",
"null"
],
"description": "true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
}
},
"description": "Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído",
"additionalProperties": false
},
"minItems": 1,
"description": "Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
},
"derivation_note": {
"type": "string",
"description": "O que o servidor calculou; presente junto com derived"
}
},
"description": "Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença",
"additionalProperties": false
},
"attribution": {
"type": "array",
"items": {
"type": "string"
},
"description": "URLs canônicas das fontes desta resposta (lista de atribuição)"
}
},
"additionalProperties": false
}fetch annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
2 advertised
comparar-municipios — Comparar municípios
Compara 2 a 10 localidades (municípios ou UFs) em um indicador e produz um ranking comentado.
- localidades
- Localidades separadas por vírgula — códigos IBGE ou nomes (ex.: 'São Paulo, Rio de Janeiro, Belo Horizonte') (required)
- indicador
- Indicador a comparar (ex.: populacao, pib, densidade, alfabetizacao). Padrão: populacao
perfil-demografico — Perfil demográfico
Monta um perfil demográfico de uma localidade combinando população, censo e indicadores socioeconômicos.
- localidade
- Município ou UF — código IBGE ou nome (ex.: '3550308' ou 'São Paulo') (required)
Resources
5 advertised
ufs — UFs do Brasil
As 27 Unidades da Federação com código IBGE (2 dígitos), sigla, nome e região.
ufs URI
ibge://catalogos/ufsregioes — Regiões do Brasil
As 5 grandes regiões com código, sigla, nome e UFs que as compõem.
regioes URI
ibge://catalogos/regioesniveis-territoriais — Níveis territoriais SIDRA
Códigos de nível territorial (nivel_territorial) aceitos pelas tools SIDRA, com rótulo e nome.
niveis-territoriais URI
ibge://catalogos/niveis-territoriaistabelas-sidra — Tabelas SIDRA comuns
Códigos das tabelas SIDRA mais usadas (população, PIB, IPCA, etc.) com descrição.
tabelas-sidra URI
ibge://catalogos/tabelas-sidrabiomas — Biomas do Brasil
Códigos dos 6 biomas brasileiros (usados por ibge_malhas_tema).
biomas URI
ibge://catalogos/biomas90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 840 ms
- 95th percentile latency
- 840 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 840 ms · metadata changed · 23 tool(s), 5 resource(s), 0 resource template(s), 2 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http ibge-brasil-mcp-sidneybissoli https://ibge.sidneybissoli.com/mcpCodex
Codex configuration
codex mcp add ibge-brasil-mcp-sidneybissoli --url https://ibge.sidneybissoli.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"ibge-brasil-mcp-sidneybissoli": {
"url": "https://ibge.sidneybissoli.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"ibge-brasil-mcp-sidneybissoli": {
"type": "streamableHttp",
"url": "https://ibge.sidneybissoli.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"ibge-brasil-mcp-sidneybissoli": {
"type": "http",
"url": "https://ibge.sidneybissoli.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http ibge-brasil-mcp-sidneybissoli https://ibge.sidneybissoli.com/mcpClaude Desktop
Claude Desktop configuration
https://ibge.sidneybissoli.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"ibge-brasil-mcp-sidneybissoli": {
"serverUrl": "https://ibge.sidneybissoli.com/mcp"
}
}
}Let your agent find its tools
Find servers like IBGE Brasil MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.