Developers
Conecta tu agente al MCP de Flip
Los datos de Flip Advisor — fondos mutuos del Perú, AFPs, perfilamiento y base de conocimiento — se exponen como un servidor MCP sobre HTTP streamable. Cualquier cliente MCP (Claude, ChatGPT u otro) descubre las 12 tools solo.
Configuración para Claude
En Claude Desktop o Claude Code, agrega el servidor a tu configuración de mcpServers:
{
"mcpServers": {
"flip-advisor": {
"type": "http",
"url": "https://advisor.flipinversiones.com/mcp",
"headers": {
"Authorization": "Bearer <TU_TOKEN>"
}
}
}
}La autenticación es por bearer token: los tokens los entrega el equipo de Flip Advisor (no hay self-service). Si la instalación corre sin auth (solo en desarrollo), omite el bloque headers.
Las 12 tools
La superficie completa del contrato. Los errores llegan como dato ({"error": …}), nunca como excepción, y cada payload trae su fecha de corte. Además del contrato de tools, el servidor expone el recurso flip://catalogo: los valores válidos (categorías, criterios, períodos, pasos del perfil, tipos de fondo de AFP) para no descubrirlos a fuerza de errores.
| Tool | Firma | Qué devuelve |
|---|---|---|
| consultar_fondos | (categoria?, nombre?, saf?, orden, sentido, periodo?, limite) | Ranking o ficha de fondos mutuos: 10 criterios en estrellas, score, comisiones, AUM, partícipes y portafolio. |
| consultar_safs | (nombre?, orden, sentido, periodo?, limite) | Ranking o ficha de administradoras (SAF), criterio respaldo incluido. |
| fondos_por_perfil | (horizonte, retiros, tolerancia, conocimiento) | Aplica las reglas de perfilamiento y devuelve la categoría con su top por score, en una sola llamada. |
| preguntar_perfil | (paso) | Una pregunta canónica del perfil con sus opciones, lista para mostrar como botones. |
| explicar_criterio | (criterio) | Deep link a la explicación oficial del criterio en la herramienta. |
| ver_grafico | (entidad, nombre, metrica, periodo?) | Serie lista para graficar (rentabilidad, partícipes o patrimonio) más un resumen. |
| resumen_industria | () | AUM total, partícipes, fondos y SAFs activos, con el mes de corte. |
| buscar_conocimiento | (consulta, tema, n) | Fragmentos conceptuales de la KB de Flip (beta: puede venir vacía, y lo dice). |
| consultar_afps | (tipo_fondo?, orden, limite) | Ranking de las 4 AFPs por tipo de fondo SPP: rentabilidad anualizada 1/5/10 años, comisiones y estrellas. |
| comparar_afps | (afp1, afp2, tipo_fondo) | Dos AFPs lado a lado para un tipo de fondo (obligatorio). |
| comparar_fondos | (fondo1, fondo2, periodo?) | Dos fondos lado a lado en una sola llamada. Si un nombre coincide con varios, devuelve los candidatos para preguntar cuál. |
| preguntar_afp | (paso) | La pregunta canónica del tipo de fondo SPP con sus opciones, lista para mostrar como botones. |
¿Tu integración no habla MCP?
Las mismas operaciones existen como façade REST documentada con Swagger, con idénticos payloads (notas y deep links incluidos) y el mismo bearer token sobre /api/*.
Fase beta. Data de cadencia mensual (corte SMV/SBS) — cita siempre la fecha_corte. La sección AFP responde "data de AFPs aún no cargada" hasta que se cargue el snapshot SBS. Sin SLA, y con rate limit cuando el operador lo activa (al pasarte: 429 con reintentar_en_segundos y header Retry-After). Uso conversacional, no scraping. La herramienta informa; no da asesoría financiera ni previsional personalizada.