BCB MCP

Instructions

Implementation Reference

• src/tools.ts:530-555 (handler)

  The handler function for 'bcb_buscar_serie' which searches the 'SERIES_POPULARES' catalogue using a normalized search term.

  export async function handleBuscarSerie(
    args: { termo: string }
  ): Promise<ToolResult> {
    try {
      const termoNorm = normalizeString(args.termo);
      const encontradas = SERIES_POPULARES.filter(s =>
        normalizeString(s.nome).includes(termoNorm) ||
        normalizeString(s.categoria).includes(termoNorm)
      );
  
      if (encontradas.length === 0) {
        return {
          content: [{
            type: "text" as const,
            text: JSON.stringify({
              termo: args.termo,
              totalEncontradas: 0,
              mensagem: "Nenhuma série encontrada no catálogo interno. Use o portal SGS do BCB para buscar outras séries: https://www3.bcb.gov.br/sgspub/",
              sugestao: "Tente termos como: selic, ipca, dolar, cambio, pib, inflacao, credito, emprego"
            }, null, 2)
          }]
        };
      }
  
      const result = { termo: args.termo, totalEncontradas: encontradas.length, series: encontradas };
      return { content: [{ type: "text" as const, text: JSON.stringify(result, null, 2) }] };

• src/tools.ts:790-799 (schema)

  The schema definition and registration of the 'bcb_buscar_serie' tool.

    name: "bcb_buscar_serie",
    description: "Busca séries no catálogo interno por nome ou descrição. Aceita termos com ou sem acentos (ex: 'inflacao' encontra 'Inflação').",
    inputSchema: {
      type: "object" as const,
      properties: {
        termo: { type: "string" as const, description: "Termo de busca (mínimo 2 caracteres)" }
      },
      required: ["termo"]
    }
  },

• src/tools.ts:857-858 (registration)

  Registration in the tool dispatcher where the 'bcb_buscar_serie' tool is routed to 'handleBuscarSerie'.

  case "bcb_buscar_serie":
    return handleBuscarSerie(args as { termo: string });