mcp-colombia

Instructions

Implementation Reference

• src/tools/finanzas.ts:120-190 (handler)

  The main implementation function compararCuentas that compares savings accounts and digital wallets in Colombia. It accepts a 'tipo' parameter (ahorros/digital/todos) and returns filtered account data with details like rendimiento, cuota_manejo, GMF, and links.

  export async function compararCuentas(args: { tipo?: "ahorros" | "digital" | "todos" }) {
    const { tipo = "todos" } = args;
  
    const cuentas = [
      {
        entidad:   "Nubank (Nu Colombia)",
        tipo:      "digital",
        rendimiento: "13.2% EA en Caja de Ahorro",
        cuota_manejo: "$0",
        retiros:   "4 gratis/mes en Servibanca",
        gmf:       "Exento si se certificó",
        link:      "https://nubank.com.co",
        nota:      "🏆 Mejor rendimiento del mercado",
      },
      {
        entidad:   "Lulo Bank",
        tipo:      "digital",
        rendimiento: "12.5% EA",
        cuota_manejo: "$0",
        retiros:   "Gratis en red propia",
        gmf:       "Exento si se certificó",
        link:      "https://www.lulobank.com",
        nota:      "Abre 100% digital en minutos",
      },
      {
        entidad:   "Nequi (Bancolombia)",
        tipo:      "digital",
        rendimiento: "~9.5% EA en bolsillos",
        cuota_manejo: "$0",
        retiros:   "Gratis en cajeros Bancolombia",
        gmf:       "Exento si se certificó",
        link:      "https://www.nequi.com.co",
        nota:      "La más usada en Colombia, muy fácil",
      },
      {
        entidad:   "Daviplata",
        tipo:      "digital",
        rendimiento: "N/A",
        cuota_manejo: "$0",
        retiros:   "Bajo costo",
        gmf:       "Aplica",
        link:      "https://www.daviplata.com",
      },
      {
        entidad:   "Bancolombia (cuenta de ahorros)",
        tipo:      "ahorros",
        rendimiento: "~3% EA",
        cuota_manejo: "$18,400/mes aprox",
        retiros:   "Incluidos en cuota",
        gmf:       "Aplica",
        link:      "https://www.bancolombia.com/personas/productos-servicios/ahorro-inversion/cuenta-de-ahorros",
      },
      {
        entidad:   "Davivienda",
        tipo:      "ahorros",
        rendimiento: "~3.5% EA",
        cuota_manejo: "$17,000/mes aprox",
        retiros:   "Incluidos",
        gmf:       "Aplica",
        link:      "https://www.davivienda.com/cuenta-de-ahorros",
      },
    ];
  
    const filtradas = tipo === "todos" ? cuentas : cuentas.filter(c => c.tipo === tipo);
  
    return {
      cuentas:   filtradas,
      resumen:   "Para rendimiento: Nubank > Lulo > Nequi. Para integración bancaria tradicional: Bancolombia o Davivienda.",
      fuente:    "Tasas referencia Feb 2026 — verificar con cada entidad.",
    };
  }

• src/index.ts:142-152 (registration)

  Tool registration for 'finanzas_comparar_cuentas' with schema definition. Defines the input parameter 'tipo' as an enum (ahorros/digital/todos) with default 'todos', and maps to the compararCuentas handler function.

  server.tool(
    "finanzas_comparar_cuentas",
    "Compara cuentas de ahorros y billeteras digitales en Colombia. Muestra rendimiento, cuota de manejo y GMF.",
    {
      tipo: z.enum(["ahorros","digital","todos"]).optional().default("todos").describe("Tipo de cuenta a comparar"),
    },
    async (args) => {
      const result = await compararCuentas(args);
      return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
    }
  );

• src/index.ts:148-150 (handler)

  The handler wrapper in the tool registration that calls the compararCuentas function with the provided arguments and returns formatted JSON content.

  async (args) => {
    const result = await compararCuentas(args);
    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };

• src/tools/finanzas.ts:123-181 (schema)

  Hardcoded data array containing account information for various Colombian banks and digital wallets (Nubank, Lulo Bank, Nequi, Daviplata, Bancolombia, Davivienda) with their properties like rendimiento, cuota_manejo, retiros, GMF, and links.

  const cuentas = [
    {
      entidad:   "Nubank (Nu Colombia)",
      tipo:      "digital",
      rendimiento: "13.2% EA en Caja de Ahorro",
      cuota_manejo: "$0",
      retiros:   "4 gratis/mes en Servibanca",
      gmf:       "Exento si se certificó",
      link:      "https://nubank.com.co",
      nota:      "🏆 Mejor rendimiento del mercado",
    },
    {
      entidad:   "Lulo Bank",
      tipo:      "digital",
      rendimiento: "12.5% EA",
      cuota_manejo: "$0",
      retiros:   "Gratis en red propia",
      gmf:       "Exento si se certificó",
      link:      "https://www.lulobank.com",
      nota:      "Abre 100% digital en minutos",
    },
    {
      entidad:   "Nequi (Bancolombia)",
      tipo:      "digital",
      rendimiento: "~9.5% EA en bolsillos",
      cuota_manejo: "$0",
      retiros:   "Gratis en cajeros Bancolombia",
      gmf:       "Exento si se certificó",
      link:      "https://www.nequi.com.co",
      nota:      "La más usada en Colombia, muy fácil",
    },
    {
      entidad:   "Daviplata",
      tipo:      "digital",
      rendimiento: "N/A",
      cuota_manejo: "$0",
      retiros:   "Bajo costo",
      gmf:       "Aplica",
      link:      "https://www.daviplata.com",
    },
    {
      entidad:   "Bancolombia (cuenta de ahorros)",
      tipo:      "ahorros",
      rendimiento: "~3% EA",
      cuota_manejo: "$18,400/mes aprox",
      retiros:   "Incluidos en cuota",
      gmf:       "Aplica",
      link:      "https://www.bancolombia.com/personas/productos-servicios/ahorro-inversion/cuenta-de-ahorros",
    },
    {
      entidad:   "Davivienda",
      tipo:      "ahorros",
      rendimiento: "~3.5% EA",
      cuota_manejo: "$17,000/mes aprox",
      retiros:   "Incluidos",
      gmf:       "Aplica",
      link:      "https://www.davivienda.com/cuenta-de-ahorros",
    },
  ];