Indicadores econômicos oficiais do Brasil (IBGE, Banco Central, Tesouro) com fonte e período.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Opcional: Bearer obr_... para um limite próprio. Sem ele, vale o limite anônimo.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Alinha de 2 a 6 séries pelo período para comparação lado a lado. Só aceita indicadores com hasSeries=true. Valores ausentes num período vêm como null. As unidades e periodicidades de cada série vêm em units e frequencies; warning informa quando alguma série começa depois do from pedido. dataStatus traz, por code, "ok", "sem-dados" ou "defasado".
Lista de 2 a 6 codes, ex. ["ipca", "selic"].
Fim no formato YYYYMM. Opcional.
Início no formato YYYYMM. Opcional.
Máximo de períodos devolvidos, entre 2 e 600. Padrão 120.
Alinha de 2 a 6 séries pelo período para comparação lado a lado. Só aceita indicadores com hasSeries=true. Valores ausentes num período vêm como null. As unidades e periodicidades de cada série vêm em units e frequencies; warning informa quando alguma série começa depois do from pedido. dataStatus traz, por code, "ok", "sem-dados" ou "defasado".
| Argument | Type | Description |
|---|---|---|
| to | string | null | Fim no formato YYYYMM. Opcional. |
| from | string | null | Início no formato YYYYMM. Opcional. |
| codes* | array | Lista de 2 a 6 codes, ex. ["ipca", "selic"]. |
| maxPoints | integer | Máximo de períodos devolvidos, entre 2 e 600. Padrão 120. |
{
"type": "object",
"required": [
"codes"
],
"properties": {
"to": {
"type": [
"string",
"null"
],
"default": null,
"description": "Fim no formato YYYYMM. Opcional."
},
"from": {
"type": [
"string",
"null"
],
"default": null,
"description": "Início no formato YYYYMM. Opcional."
},
"codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Lista de 2 a 6 codes, ex. [\"ipca\", \"selic\"]."
},
"maxPoints": {
"type": "integer",
"default": 120,
"description": "Máximo de períodos devolvidos, entre 2 e 600. Padrão 120."
}
}
}Devolve o texto completo de uma edição publicada do Boletim Semanal, que é análise editorial do site. Sem slug, devolve a edição mais recente.
| Argument | Type | Description |
|---|---|---|
| slug | string | null | Slug da edição. Opcional. |
{
"type": "object",
"properties": {
"slug": {
"type": [
"string",
"null"
],
"default": null,
"description": "Slug da edição. Opcional."
}
}
}Devolve a definição de um conceito econômico do glossário, ex. "hiato do produto", "núcleo de inflação", com os indicadores relacionados.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Slug do verbete, ex. "juro-real". |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Slug do verbete, ex. \"juro-real\"."
}
}
}Devolve o texto completo de uma pílula publicada. Sem slug, devolve a mais recente. conceptSlug, quando presente, é o slug de um verbete do glossário.
| Argument | Type | Description |
|---|---|---|
| slug | string | null | Slug da pílula. Opcional. |
{
"type": "object",
"properties": {
"slug": {
"type": [
"string",
"null"
],
"default": null,
"description": "Slug da pílula. Opcional."
}
}
}Devolve o payload rico do painel de um indicador (KPIs, aberturas, resultados de modelo), o mesmo de /api/v2/indicators/{code}/full, em payload. Só para indicadores com hasDetails=true. Acima de 40 mil caracteres, payload vem nulo e payloadPreview traz o início do JSON.
| Argument | Type | Description |
|---|---|---|
| to | string | null | Fim no formato YYYYMM. Opcional. |
| code* | string | Code do indicador, ex. "ipca", "taylor", "modelo-bc". |
| from | string | null | Início no formato YYYYMM. Opcional. |
{
"type": "object",
"required": [
"code"
],
"properties": {
"to": {
"type": [
"string",
"null"
],
"default": null,
"description": "Fim no formato YYYYMM. Opcional."
},
"code": {
"type": "string",
"description": "Code do indicador, ex. \"ipca\", \"taylor\", \"modelo-bc\"."
},
"from": {
"type": [
"string",
"null"
],
"default": null,
"description": "Início no formato YYYYMM. Opcional."
}
}
}Devolve o último valor disponível de um indicador, o valor anterior e a diferença entre eles, com período, unidade e fonte. A janela de busca se ajusta à periodicidade, para tolerar a defasagem de divulgação das séries anuais. dataStatus "defasado" indica que o último valor é mais velho que o esperado para a periodicidade.
| Argument | Type | Description |
|---|---|---|
| code* | string | Code do indicador, ex. "ipca". |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "Code do indicador, ex. \"ipca\"."
}
}
}Devolve a série temporal de um indicador (pontos period/value). Sem from/to, traz os últimos 5 anos. Séries longas são reduzidas a maxPoints pontos espaçados, sempre preservando o mais recente. Só vêm pontos dentro da janela; se a fonte começa depois do from pedido, note informa a partir de quando há dados. dataStatus indica se o dado é atual: "ok", "sem-dados" ou "defasado"; fora de ok, note traz a explicação.
| Argument | Type | Description |
|---|---|---|
| to | string | null | Fim no formato YYYYMM. Opcional; padrão é hoje. |
| code* | string | Code do indicador, ex. "ipca", "selic", "desemprego". |
| from | string | null | Início no formato YYYYMM, ex. "202001". Opcional. |
| maxPoints | integer | Máximo de pontos devolvidos, entre 2 e 600. Padrão 120. |
{
"type": "object",
"required": [
"code"
],
"properties": {
"to": {
"type": [
"string",
"null"
],
"default": null,
"description": "Fim no formato YYYYMM. Opcional; padrão é hoje."
},
"code": {
"type": "string",
"description": "Code do indicador, ex. \"ipca\", \"selic\", \"desemprego\"."
},
"from": {
"type": [
"string",
"null"
],
"default": null,
"description": "Início no formato YYYYMM, ex. \"202001\". Opcional."
},
"maxPoints": {
"type": "integer",
"default": 120,
"description": "Máximo de pontos devolvidos, entre 2 e 600. Padrão 120."
}
}
}Devolve o texto completo de um artigo de metodologia: fórmulas, fontes, simplificações e limitações de um indicador ou modelo.
| Argument | Type | Description |
|---|---|---|
| slug* | string | Slug do artigo, ex. "regra-de-taylor". |
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Slug do artigo, ex. \"regra-de-taylor\"."
}
}
}Sem sectionId, lista as seções do panorama (fiscal, setor externo, investimento, produtividade, social) com o último valor de cada indicador. Com sectionId, devolve a seção com as séries, até 240 pontos por indicador, incluindo mínimo, máximo e média do período inteiro.
| Argument | Type | Description |
|---|---|---|
| sectionId | string | null | Id da seção, vindo da listagem sem sectionId. Opcional. |
{
"type": "object",
"properties": {
"sectionId": {
"type": [
"string",
"null"
],
"default": null,
"description": "Id da seção, vindo da listagem sem sectionId. Opcional."
}
}
}Devolve sete perguntas sobre a economia brasileira, como crescimento, inflação, emprego e contas públicas, cada uma com os indicadores que a respondem: último valor, variação, período e a direção considerada favorável.
No arguments.
{
"type": "object",
"properties": {}
}Devolve o termômetro de risco de recessão do Observatório: nível geral (favoravel, atencao ou adverso), a manchete e três dimensões, a saber estado atual, momentum e pressão à frente. Cada componente traz valor, período e a regra determinística aplicada. Opcionalmente inclui o histórico diário dos níveis.
| Argument | Type | Description |
|---|---|---|
| historyDays | integer | Dias de histórico diário a incluir, de 0 a 365. Padrão 0, sem histórico. |
{
"type": "object",
"properties": {
"historyDays": {
"type": "integer",
"default": 0,
"description": "Dias de histórico diário a incluir, de 0 a 365. Padrão 0, sem histórico."
}
}
}Lista as divulgações oficiais agendadas, como IPCA, PIB, PNAD e decisões do Copom, com data e hora em UTC, mais o Boletim Focus de toda segunda-feira. Sem datas, cobre de hoje até 30 dias à frente.
| Argument | Type | Description |
|---|---|---|
| to | string | null | Data final no formato YYYY-MM-DD, até 120 dias após a inicial. Opcional. |
| from | string | null | Data inicial no formato YYYY-MM-DD. Opcional; padrão é hoje. |
{
"type": "object",
"properties": {
"to": {
"type": [
"string",
"null"
],
"default": null,
"description": "Data final no formato YYYY-MM-DD, até 120 dias após a inicial. Opcional."
},
"from": {
"type": [
"string",
"null"
],
"default": null,
"description": "Data inicial no formato YYYY-MM-DD. Opcional; padrão é hoje."
}
}
}Devolve os 10 indicadores-chave de um território num ano: PIB, PIB per capita, população, inflação, juros, desemprego, dívida, investimento, exportações e arrecadação. O campo natureza diz se o número é Observado, Estimado ou Indisponivel; card Indisponivel vem sem valor, porque não há fonte oficial por território. Inclui as próximas divulgações oficiais.
| Argument | Type | Description |
|---|---|---|
| year | integer | null | Ano de referência, ex. 2023. Opcional; padrão é o mais recente com dado. |
| territoryId* | string | Id do território: "br", uma região (ex. "sul") ou a sigla da UF em minúsculas (ex. "sc"). |
{
"type": "object",
"required": [
"territoryId"
],
"properties": {
"year": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Ano de referência, ex. 2023. Opcional; padrão é o mais recente com dado."
},
"territoryId": {
"type": "string",
"description": "Id do território: \"br\", uma região (ex. \"sul\") ou a sigla da UF em minúsculas (ex. \"sc\")."
}
}
}Lista as edições publicadas do Boletim Semanal, da mais recente para a mais antiga, com slug, título, data de referência e resumo.
| Argument | Type | Description |
|---|---|---|
| page | integer | Página, a partir de 1. Padrão 1. |
| pageSize | integer | Itens por página, de 1 a 20. Padrão 10. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"description": "Página, a partir de 1. Padrão 1."
},
"pageSize": {
"type": "integer",
"default": 10,
"description": "Itens por página, de 1 a 20. Padrão 10."
}
}
}Lista os verbetes do glossário de conceitos econômicos, com slug, categoria e os indicadores relacionados.
| Argument | Type | Description |
|---|---|---|
| category | string | null | Filtra pela categoria exata do verbete. Opcional. |
{
"type": "object",
"properties": {
"category": {
"type": [
"string",
"null"
],
"default": null,
"description": "Filtra pela categoria exata do verbete. Opcional."
}
}
}Lista o catálogo curado de crises econômicas, brasileiras e globais, com anos de início e fim, abrangência e resumo. Útil para contextualizar quedas nas séries.
No arguments.
{
"type": "object",
"properties": {}
}Lista as pílulas publicadas, posts curtos e diários sobre UM indicador, da mais recente para a mais antiga, com slug, título e resumo. indicatorCode restringe a lista ao que o site já escreveu sobre um indicador.
| Argument | Type | Description |
|---|---|---|
| page | integer | Página, a partir de 1. Padrão 1. |
| pageSize | integer | Itens por página, de 1 a 20. Padrão 10. |
| indicatorCode | string | null | Code do indicador, ex. "ipca". Opcional. |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"description": "Página, a partir de 1. Padrão 1."
},
"pageSize": {
"type": "integer",
"default": 10,
"description": "Itens por página, de 1 a 20. Padrão 10."
},
"indicatorCode": {
"type": [
"string",
"null"
],
"default": null,
"description": "Code do indicador, ex. \"ipca\". Opcional."
}
}
}Lista os indicadores econômicos do Observatório BR com code, título, categoria, fonte, periodicidade e unidade. hasSeries=true indica que o indicador tem série temporal própria; hasDetails=true indica que há payload detalhado do painel.
| Argument | Type | Description |
|---|---|---|
| query | string | null | Filtra por trecho do code ou do título, sem diferenciar maiúsculas. Opcional. |
| category | string | null | Filtra pela categoria exata, ex. "Inflação", "Fiscal", "Modelos". Opcional. |
{
"type": "object",
"properties": {
"query": {
"type": [
"string",
"null"
],
"default": null,
"description": "Filtra por trecho do code ou do título, sem diferenciar maiúsculas. Opcional."
},
"category": {
"type": [
"string",
"null"
],
"default": null,
"description": "Filtra pela categoria exata, ex. \"Inflação\", \"Fiscal\", \"Modelos\". Opcional."
}
}
}Lista os artigos técnicos que explicam como os indicadores e modelos do Observatório são calculados, com slug e resumo.
No arguments.
{
"type": "object",
"properties": {}
}Lista os 33 territórios do Observatório (Brasil, 5 regiões e 27 UFs) com id, PIB em R$ bilhões, PIB per capita, população em milhões e crescimento do último ano disponível.
No arguments.
{
"type": "object",
"properties": {}
}Busca em português, sem diferenciar acentos, nos boletins, pílulas, glossário de conceitos e artigos de metodologia, e casa os painéis de indicador pelo nome. Os painéis vêm em indicators (só na página 1); o conteúdo vem paginado em content.
| Argument | Type | Description |
|---|---|---|
| q* | string | Texto da busca, de 2 a 200 caracteres, ex. "hiato do produto". |
| page | integer | Página, a partir de 1. Padrão 1. |
| pageSize | integer | Itens por página, de 1 a 20. Padrão 10. |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Texto da busca, de 2 a 200 caracteres, ex. \"hiato do produto\"."
},
"page": {
"type": "integer",
"default": 1,
"description": "Página, a partir de 1. Padrão 1."
},
"pageSize": {
"type": "integer",
"default": 10,
"description": "Itens por página, de 1 a 20. Padrão 10."
}
}
}