Model Context Protocol (MCP) • Streamable HTTP (HTTPS)

MCP Rentabilidades FICs y FCPs Colombia (SFC)

Servidor MCP conectado en tiempo real al dataset oficial qhpu-8ixx de la Superintendencia Financiera de Colombia en Datos Abiertos (https://www.datos.gov.co/resource/qhpu-8ixx.json). Incluye arquitectura híbrida de App Token Socrata (BYOK por usuario, variable de entorno en Vercel o caché inteligente en memoria).

Endpoint HTTPS del Servidor MCP

POST /api/mcp
GET  /api/mcp (Healthcheck & especificación de herramientas)

Para pasar un App Token propio de datos.gov.co, envía el header x-socrata-app-token: TU_TOKEN o usa el query param /api/mcp?app_token=TU_TOKEN.

Catálogo de 12 Herramientas Cuantitativas e Institucionales

#1obtener_estado_dataset

Obtiene el estado actual del dataset oficial qhpu-8ixx de la Superintendencia Financiera de Colombia (SFC) en datos.gov.co: fecha máxima de corte reportada, total de registros históricos, número de entidades y fondos activos, estado del App Token Socrata y diccionario de las 26 columnas.

#2listar_entidades_administradoras

Lista todas las Sociedades Fiduciarias, Sociedades Comisionistas de Bolsa (SCB) y Sociedades Administradoras de Inversión (SAI) activas en la última fecha de corte (o fecha especificada), junto con su código SFC, cantidad de fondos (FIC/FCP), número de inversionistas y patrimonio total administrado (AUM en COP).

#3buscar_fondos_fic

Busca Fondos de Inversión Colectiva (FIC) o Fondos de Capital Privado (FCP) por palabra clave del nombre del fondo, nombre/código de entidad fiduciaria, código de negocio o subtipo de patrimonio (ej. 'FIC DE TIPO GENERAL', 'FONDO BURSATIL', 'INMOBILIARIO', 'CAPITAL PRIVADO'). Devuelve sus tipos de participación activos, AUM y rentabilidades recientes.

#4radiografia_fondo

Entrega la ficha institucional completa de un fondo específico (por codigo_negocio y opcionalmente codigo_entidad o tipo_participacion) en la fecha más reciente: desglose de todas sus clases/tipos de participación, AUM total del fondo, valor de unidad, número de inversionistas, ticket promedio por inversionista, flujos del día y curva completa de rentabilidades E.A. (diaria, mensual 30d, semestral 180d, anual 365d).

#5ranking_rentabilidades_fics

Genera el Top N o Bottom N de los Fondos de Inversión Colectiva según su rentabilidad Efectiva Anual (diaria, mensual, semestral o anual) en una fecha de corte, permitiendo filtrar por subtipo de fondo, entidad administradora y patrimonio mínimo (AUM en COP) para excluir fondos pequeños o distorsiones atípicas.

#6cuota_mercado_aum_entidades

Calcula el Market Share (cuota de mercado porcentual) de la industria de FICs y FCPs en Colombia agrupado por entidad administradora y/o subtipo de patrimonio en una fecha de corte, sumando el AUM total (valor_fondo_cierre_dia_t), número total de inversionistas y flujos del día.

#7flujos_netos_captacion

Analiza la dinámica de captación comercial e institucional en una ventana de tiempo calculando Aportes Recibidos, Retiros/Redenciones, Anulaciones y el Flujo Neto de Caja (Aportes - Retiros - Anulaciones) agrupado por entidad administradora o por fondo específico.

#8radar_corridas_y_alertas_liquidez

Escanea una fecha de corte (o rango reciente) para detectar alertas de liquidez y retiros masivos donde las redenciones del día (retiros_redenciones) superan un porcentaje crítico del patrimonio de precierre (precierre_fondo_dia_t).

#9serie_historica_nav_y_tasas

Extrae la serie de tiempo histórica de un fondo y tipo de participación entre dos fechas: evolución del valor_unidad_operaciones (NAV), patrimonio al cierre, número de inversionistas, flujos netos y rentabilidades reportadas.

#10metricas_riesgo_cuantitativo

Calcula métricas cuantitativas institucionales directamente sobre la serie de valor_unidad_operaciones (NAV) de un FIC en un rango de fechas: Retorno Acumulado, Rentabilidad Efectiva Anual exacta (CAGR), Volatilidad Anualizada, Maximum Drawdown (Max DD), Ratio de Sharpe, Ratio de Sortino y Estadísticas de Flujos.

#11comparar_peer_group_fics

Compara frente a frente un grupo de fondos (Peer Group de 2 a 8 códigos de negocio) en la última fecha de corte disponible: compara AUM, cantidad de inversionistas, ticket promedio por inversionista, rentabilidad diaria, 30d, 180d y 365d E.A., y flujo neto reciente.

#12ejecutar_soql_avanzado

Ejecuta una consulta SoQL (Socrata Query Language) directa y personalizada sobre el dataset qhpu-8ixx (https://www.datos.gov.co/resource/qhpu-8ixx.json). Ideal para agregaciones ad-hoc, cruces estadísticos o filtros avanzados usando las 26 columnas oficiales de la SFC.