BCB Payment Methods MCP Server

Instructions

Implementation Reference

• src/index.ts:194-215 (schema)

  Tool schema definition for 'consultar_taxas_desconto', including name, description, and input schema requiring 'trimestre' parameter.
  { name: "consultar_taxas_desconto", description: "Consulta taxas de desconto cobradas de estabelecimentos comerciais por operações com meios de pagamento.", inputSchema: { type: "object", properties: { trimestre: { type: "string", description: "Ano e trimestre no formato YYYYQ (exemplo: '20234')", }, top: { type: "number", description: "Número máximo de registros a retornar (padrão: 100)", }, filtro: { type: "string", description: "Filtro OData para refinar a consulta", }, }, required: ["trimestre"], }, },
• src/index.ts:398-419 (handler)

  MCP handler for 'consultar_taxas_desconto' tool in CallToolRequestSchema. Extracts parameters, calls fetchBCBData on 'TaxasDescontoDA' endpoint, and returns JSON data.
  case "consultar_taxas_desconto": { const { trimestre, top = 100, filtro } = args as { trimestre: string; top?: number; filtro?: string; }; const data = await fetchBCBData(`TaxasDescontoDA(trimestre=@trimestre)?@trimestre='${trimestre}'`, { formato: "json", top, filter: filtro, }); return { content: [ { type: "text", text: JSON.stringify(data, null, 2), }, ], }; }
• src/http-server.ts:184-205 (schema)

  Tool schema definition for 'consultar_taxas_desconto', including name, description, and input schema requiring 'trimestre' parameter.
  { name: "consultar_taxas_desconto", description: "Consulta taxas de desconto cobradas de estabelecimentos comerciais por operações com meios de pagamento.", inputSchema: { type: "object", properties: { trimestre: { type: "string", description: "Ano e trimestre no formato YYYYQ (exemplo: '20234')", }, top: { type: "number", description: "Número máximo de registros a retornar (padrão: 100)", }, filtro: { type: "string", description: "Filtro OData para refinar a consulta", }, }, required: ["trimestre"], }, },
• src/http-server.ts:402-423 (handler)

  MCP handler for 'consultar_taxas_desconto' tool in CallToolRequestSchema within createMCPServer function. Fetches data from BCB API.
  case "consultar_taxas_desconto": { const { trimestre, top = 100, filtro } = args as { trimestre: string; top?: number; filtro?: string; }; const data = await fetchBCBData(`TaxasDescontoDA(trimestre=@trimestre)?@trimestre='${trimestre}'`, { formato: "json", top, filter: filtro, }); return { content: [ { type: "text", text: JSON.stringify(data, null, 2), }, ], }; }
• src/index.ts:37-51 (helper)

  Helper function to fetch data from the BCB Olinda API, used by all tool handlers including 'consultar_taxas_desconto'.
  async function fetchBCBData(endpoint: string, params: QueryParams = {}) { try { const url = buildUrl(endpoint, params); const response = await axios.get(url, { headers: { "Accept": "application/json" } }); return response.data; } catch (error) { if (axios.isAxiosError(error)) { throw new Error(`Erro ao consultar API do BCB: ${error.message}`); } throw error; }