Observatório BR MCP
An official Model Context Protocol server that allows AI agents to query official Brazilian economic indicators from sources like IBGE, Central Bank, and Tesouro Nacional. It returns data with source citations, time periods, and panel links, while flagging empty or lagged series. The service is public, read-only, and requires no registration.
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.
https://observatoriobr.com.br/api/mcpWhat you can do with it
- Query official Brazilian economic indicators like inflation, unemployment, and GDP
- Retrieve recession risk scores and macroeconomic model scenarios
- Access weekly bulletins and daily indicator summaries with source citations
- Compare economic time series across different categories and regions
Source and maintenance
Protocol and capabilities
- Server
- observatorio-br 1.0.930
- MCP protocol
- 2025-06-18
- Tools
- 24 advertised
- Resources
- 1 advertised
- Resource templates
- 2 advertised
- Prompts
- 3 advertised
{
"tools": {},
"logging": {},
"prompts": {},
"resources": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
24 advertised
list_crises — Crises econômicas datadas
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.
{
"type": "object",
"properties": {}
}{
"title": "Crises econômicas datadas",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search — Buscar no Observatório BR
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.
{
"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."
}
}
}{
"title": "Buscar no Observatório BR",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_territory_map_profile — Perfil de município ou estado no mapa
Devolve o perfil de um município ou estado no Mapa de Inteligência Territorial: cada indicador com valor, período, natureza, fonte, posição no Brasil e na UF e medianas, os territórios de perfil parecido e, para município, os sinais do Radar de Oportunidades (especializações por atividade, concentração do emprego, dinamismo recente, possíveis lacunas de oferta e mercado num raio de 50, 100 e 200 km), com o método de cada sinal. Indicador sem dado vem com valor nulo.
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "Código do IBGE: 2 dígitos para UF (ex. \"42\") ou 7 para município (ex. \"4205407\")."
}
}
}{
"title": "Perfil de município ou estado no mapa",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_concept — Ler um verbete do glossário
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.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Slug do verbete, ex. \"juro-real\"."
}
}
}{
"title": "Ler um verbete do glossário",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_daily_posts — Listar pílulas diárias
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.
{
"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."
}
}
}{
"title": "Listar pílulas diárias",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_indicator_latest — Último valor de um indicador
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.
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "Code do indicador, ex. \"ipca\"."
}
}
}{
"title": "Último valor de um indicador",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_methodology — Ler um artigo de metodologia
Devolve o texto completo de um artigo de metodologia: fórmulas, fontes, simplificações e limitações de um indicador ou modelo.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Slug do artigo, ex. \"regra-de-taylor\"."
}
}
}{
"title": "Ler um artigo de metodologia",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_daily_post — Ler uma pílula
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.
{
"type": "object",
"properties": {
"slug": {
"type": [
"string",
"null"
],
"default": null,
"description": "Slug da pílula. Opcional."
}
}
}{
"title": "Ler uma pílula",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_panorama — Panorama por seção
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.
{
"type": "object",
"properties": {
"sectionId": {
"type": [
"string",
"null"
],
"default": null,
"description": "Id da seção, vindo da listagem sem sectionId. Opcional."
}
}
}{
"title": "Panorama por seção",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_pillars — Os sete pilares da economia
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.
{
"type": "object",
"properties": {}
}{
"title": "Os sete pilares da economia",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_concepts — Listar o glossário
Lista os verbetes do glossário de conceitos econômicos, com slug, categoria e os indicadores relacionados.
{
"type": "object",
"properties": {
"category": {
"type": [
"string",
"null"
],
"default": null,
"description": "Filtra pela categoria exata do verbete. Opcional."
}
}
}{
"title": "Listar o glossário",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_recession_thermometer — Termômetro de recessão
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.
{
"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."
}
}
}{
"title": "Termômetro de recessão",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_opportunity_radar — Radar de Oportunidades
Devolve a lista ranqueada de municípios de um critério do Radar de Oportunidades, no Brasil ou numa UF: polos (quociente locacional de uma atividade), potencial (dinamismo recente de emprego, empresas e PIB), concentracao (índice de Herfindahl-Hirschman do emprego formal) ou baixa-oferta (unidades da atividade por habitante abaixo da mediana de municípios parecidos). Cada item traz o escore e os componentes; a resposta traz o método, as fontes com período e a natureza Estimado.
{
"type": "object",
"required": [
"criterion"
],
"properties": {
"uf": {
"type": [
"string",
"null"
],
"default": null,
"description": "Sigla da UF para restringir a lista (ex. \"SC\"). Opcional; padrão é o Brasil."
},
"limit": {
"type": [
"integer",
"null"
],
"default": null,
"description": "Quantos municípios devolver, de 1 a 100. Opcional; padrão 20."
},
"sector": {
"type": [
"string",
"null"
],
"default": null,
"description": "Seção da CNAE (letra de A a U, ex. \"C\" para indústria de transformação). Obrigatória em polos e baixa-oferta."
},
"criterion": {
"type": "string",
"description": "Critério: \"polos\", \"potencial\", \"concentracao\" ou \"baixa-oferta\"."
}
}
}{
"title": "Radar de Oportunidades",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_indicator_series — Série temporal de um indicador
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.
{
"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."
}
}
}{
"title": "Série temporal de um indicador",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_bulletin — Ler um boletim semanal
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.
{
"type": "object",
"properties": {
"slug": {
"type": [
"string",
"null"
],
"default": null,
"description": "Slug da edição. Opcional."
}
}
}{
"title": "Ler um boletim semanal",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_bulletins — Listar boletins semanais
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.
{
"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."
}
}
}{
"title": "Listar boletins semanais",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_territory_profile — Perfil de um território
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.
{
"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\")."
}
}
}{
"title": "Perfil de um território",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}compare_indicators — Comparar indicadores
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".
{
"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."
}
}
}{
"title": "Comparar indicadores",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_territory — Buscar município ou estado
Busca municípios e estados pelo nome, sem diferenciar acento ou maiúscula. Devolve até 20 resultados com o código do IBGE (2 dígitos para UF, 7 para município), a UF e o endereço do painel no mapa.
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Nome ou parte do nome, com pelo menos 2 letras (ex. \"joinville\", \"sao jose\")."
}
}
}{
"title": "Buscar município ou estado",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_indicator_details — Detalhes completos de um indicador
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.
{
"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."
}
}
}{
"title": "Detalhes completos de um indicador",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_release_calendar — Calendário de divulgações
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.
{
"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."
}
}
}{
"title": "Calendário de divulgações",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_indicators — Catálogo de indicadores
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.
{
"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."
}
}
}{
"title": "Catálogo de indicadores",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_methodology — Listar artigos de metodologia
Lista os artigos técnicos que explicam como os indicadores e modelos do Observatório são calculados, com slug e resumo.
{
"type": "object",
"properties": {}
}{
"title": "Listar artigos de metodologia",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_territories — Listar territórios
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.
{
"type": "object",
"properties": {}
}{
"title": "Listar territórios",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
3 advertised
resumo_conjuntura — Resumo da conjuntura
Panorama da economia brasileira agora: risco de recessão, os sete pilares, o último boletim e as divulgações da próxima semana.
comparar_indicadores — Comparar indicadores
Comparação lado a lado de dois a seis indicadores no mesmo período.
- codes
- Codes separados por vírgula, ex. "ipca,selic". (required)
- from
- Início no formato YYYYMM. Opcional.
analisar_indicador — Analisar um indicador
Análise de um indicador econômico com série recente, o que o site já publicou sobre ele e os conceitos relacionados.
- code
- Code do indicador, ex. "ipca". (required)
- meses
- Meses de histórico a considerar. Padrão 24.
Resources
1 advertised
catalogo — Catálogo de indicadores
Catálogo completo dos indicadores do Observatório BR, em JSON: code, título, categoria, fonte, periodicidade, unidade, hasSeries, hasDetails e URL do painel.
observatorio://catalogoconceito — Verbete do glossário
Definição de um conceito econômico do glossário, em texto puro.
observatorio://conceitos/{slug}metodologia — Artigo de metodologia
Artigo de metodologia de um indicador ou modelo, em texto puro.
observatorio://metodologia/{slug}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
- 1482 ms
- 95th percentile latency
- 1482 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1482 ms · metadata changed · 24 tool(s), 1 resource(s), 2 resource template(s), 3 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http observato-rio-br-mcp https://observatoriobr.com.br/api/mcpCodex
codex mcp add observato-rio-br-mcp --url https://observatoriobr.com.br/api/mcpCursor
{
"mcpServers": {
"observato-rio-br-mcp": {
"url": "https://observatoriobr.com.br/api/mcp"
}
}
}Cline
{
"mcpServers": {
"observato-rio-br-mcp": {
"type": "streamableHttp",
"url": "https://observatoriobr.com.br/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"observato-rio-br-mcp": {
"type": "http",
"url": "https://observatoriobr.com.br/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http observato-rio-br-mcp https://observatoriobr.com.br/api/mcpClaude Desktop
{
"mcpServers": {
"observato-rio-br-mcp": {
"url": "https://observatoriobr.com.br/api/mcp"
}
}
}Windsurf
{
"mcpServers": {
"observato-rio-br-mcp": {
"serverUrl": "https://observatoriobr.com.br/api/mcp"
}
}
}Let your agent find its tools
Find servers like Observatório BR MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run Observatório BR MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.