# cafci-mcp

Conector MCP de rendimientos de FCI (familias **Fima** de Galicia y **Pionero** de Macro), con serie diaria de VCP oficial CAFCI en SQLite sobre volumen persistente de Railway.

## Fuentes

- **Ingesta**: ArgentinaDatos (`api.argentinadatos.com/v1/finanzas/fci/{categoria}/{fecha}`) — republica los datos diarios de CAFCI en JSON, sin autenticación. Categorías: mercadoDinero, rentaFija, rentaVariable, rentaMixta, otros.
- **Contraste**: API oficial CAFCI (`api.cafci.org.ar/fondo/{id}/clase/{id}/rendimiento/{desde}/{hasta}`), por fondo/clase ID mapeado.

## Herramientas

| Tool | Función |
|---|---|
| `fci_actualizar` | Carga el último dato diario de las 5 categorías (solo familias configuradas). Idempotente. |
| `fci_backfill(desde, hasta, max_dias=10)` | Carga histórica por tramos, commit por día (a prueba de gateway timeout). |
| `fci_listar_fondos(familia?)` | Fondos indexados con cobertura de fechas. |
| `fci_rendimiento(fondo, desde?, hasta?, dias?)` | Rendimiento directo + TNA/TEA equivalentes sobre serie local. |
| `fci_comparar(dias=30, familia?, categoria?)` | Ranking de fondos por rendimiento en ventana. |
| `fci_serie(fondo, desde, hasta)` | Serie diaria VCP/patrimonio. |
| `fci_estado_indice` | Diagnóstico del índice local. |
| `fci_registrar_cafci_id(fondo, fondo_id, clase_id)` | Mapea fondo → IDs oficiales CAFCI. |
| `fci_cafci_rendimiento(fondo, desde, hasta)` | Rendimiento oficial en vivo desde api.cafci.org.ar. |

## Despliegue en Railway (patrón estándar)

1. Crear repo `cafci-mcp` en la org `patricioargota-collab` y subir estos archivos.
2. En Railway: **New Project → Deploy from GitHub repo** → seleccionar `cafci-mcp`.
3. **Variables**: agregar `PORT=8000` (explícita, como siempre).
4. **Volumen**: agregar volumen persistente montado en `/data`.
5. **Settings → Networking → Generate Domain** (puerto 8000).
6. Verificar: `https://<dominio>.up.railway.app/mcp` debe responder (405/406 a un GET simple es normal; el 421 "Invalid Host header" indicaría DNS rebinding activo — ya está deshabilitado en `main()`).
7. En Claude.ai → Configuración → Conectores → **Agregar conector personalizado** → URL `https://<dominio>.up.railway.app/mcp`.

## Primera carga

1. `fci_actualizar` → trae el último día.
2. `fci_backfill("2026-01-01", "2026-07-14")` → histórico por tramos de 10 días hábiles; relanzar con la fecha que indique la respuesta hasta completar.
3. `fci_estado_indice` → verificar cobertura.

## Configuración opcional

- `FCI_FAMILIAS` (env): familias a indexar, default `fima,pionero`.
- `DB_PATH` (env): ruta de la base, default `/data/fci.db`.