bcb_indicadores_atuais

Retrieve current values for Brazil's key economic indicators including Selic rate, IPCA inflation, USD exchange rate, and IBC-Br economic activity index.

Instructions

Obtém os valores mais recentes dos principais indicadores econômicos: Selic, IPCA, Dólar PTAX e IBC-Br.

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

src/tools.ts:564-599 (handler)

The main handler function for bcb_indicadores_atuais, which fetches the latest values for key economic indicators from the BCB API.

export async function handleIndicadoresAtuais(
  _args: Record<string, never>,
  timeoutMs?: number,
  maxRetries?: number
): Promise<ToolResult> {
  try {
    const indicadores = [
      { codigo: 432, nome: "Selic (a.a.)" },
      { codigo: 433, nome: "IPCA mensal (%)" },
      { codigo: 13522, nome: "IPCA 12 meses (%)" },
      { codigo: 3698, nome: "Dólar PTAX (venda)" },
      { codigo: 24364, nome: "IBC-Br" }
    ];

    const resultados = await Promise.all(
      indicadores.map(async (ind) => {
        try {
          const url = `${BCB_API_BASE}.${ind.codigo}/dados/ultimos/1?formato=json`;
          const data = await fetchBcbApi(url, timeoutMs, maxRetries) as SerieValor[];

          if (Array.isArray(data) && data.length > 0) {
            return { indicador: ind.nome, codigo: ind.codigo, data: data[0].data, valor: parseFloat(data[0].valor) };
          }
          return { indicador: ind.nome, codigo: ind.codigo, erro: "Sem dados disponíveis" };
        } catch (err) {
          return { indicador: ind.nome, codigo: ind.codigo, erro: err instanceof Error ? err.message : "Erro desconhecido" };
        }
      })
    );

    return {
      content: [{
        type: "text" as const,
        text: JSON.stringify({ consultadoEm: new Date().toISOString(), indicadores: resultados }, null, 2)
      }]
    };

src/tools.ts:801-807 (schema)

Definition of the bcb_indicadores_atuais tool schema.

  name: "bcb_indicadores_atuais",
  description: "Obtém os valores mais recentes dos principais indicadores econômicos: Selic, IPCA, Dólar PTAX e IBC-Br.",
  inputSchema: {
    type: "object" as const,
    properties: {}
  }
},

src/tools.ts:859-860 (registration)

Tool dispatcher registration for bcb_indicadores_atuais.

case "bcb_indicadores_atuais":
  return handleIndicadoresAtuais({} as Record<string, never>, timeoutMs, maxRetries);

BCB MCP