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 });