bcb_series_populares

Access 150+ popular Brazilian economic time series including interest rates, inflation, exchange rates, GDP, employment, and credit indicators from the Central Bank of Brazil.

Instructions

Lista 150+ séries temporais do BCB com seus códigos. Inclui juros, inflação, câmbio, PIB, emprego, crédito e outros indicadores econômicos.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`categoria`	No	Filtrar por categoria: Juros, Inflação, Câmbio, Atividade Econômica, Emprego, Fiscal, Setor Externo, Crédito, Agregados Monetários, Poupança, Índices de Mercado, Expectativas

Implementation Reference

src/tools.ts:497-528 (handler)

The handleSeriesPopulares function processes the request to list popular series, optionally filtering them by category.

export async function handleSeriesPopulares(
  args: { categoria?: string }
): Promise<ToolResult> {
  try {
    let series: SeriePopular[] = SERIES_POPULARES;

    if (args.categoria) {
      const categoriaNorm = normalizeString(args.categoria);
      series = series.filter(s => normalizeString(s.categoria).includes(categoriaNorm));
    }

    const porCategoria: Record<string, SeriePopular[]> = {};
    for (const serie of series) {
      if (!porCategoria[serie.categoria]) porCategoria[serie.categoria] = [];
      porCategoria[serie.categoria].push(serie);
    }

    const result = {
      totalSeries: series.length,
      categorias: Object.keys(porCategoria).length,
      series: args.categoria ? series : porCategoria,
      observacao: "Use bcb_serie_valores ou bcb_serie_ultimos com o código para consultar os dados"
    };

    return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };
  } catch (error) {
    return {
      content: [{ type: "text" as const, text: `Erro ao listar séries: ${error instanceof Error ? error.message : String(error)}` }],
      isError: true
    };
  }
}

src/tools.ts:780-788 (schema)

The definition of bcb_series_populares tool including its name, description, and input schema.

  name: "bcb_series_populares",
  description: "Lista 150+ séries temporais do BCB com seus códigos. Inclui juros, inflação, câmbio, PIB, emprego, crédito e outros indicadores econômicos.",
  inputSchema: {
    type: "object" as const,
    properties: {
      categoria: { type: "string" as const, description: "Filtrar por categoria: Juros, Inflação, Câmbio, Atividade Econômica, Emprego, Fiscal, Setor Externo, Crédito, Agregados Monetários, Poupança, Índices de Mercado, Expectativas" }
    }
  }
},

src/tools.ts:855-856 (registration)
The dispatcher switch case that maps the bcb_series_populares tool name to the handleSeriesPopulares function.
```
case "bcb_series_populares":
  return handleSeriesPopulares(args as { categoria?: string });
```

BCB MCP