Skip to main content
Glama
justomiguel

MCP Mindicador

by justomiguel
README.md
# MCP Mindicador (clase SQM)

Servidor MCP sobre Next.js que expone las cotizaciones económicas de Chile usando [mindicador.cl](https://mindicador.cl/api) por detrás. Está pensado para desplegarse en Vercel y conectarse desde Cursor u otro cliente MCP.

Basado en el template oficial [vercel-labs/mcp-for-next.js](https://github.com/vercel-labs/mcp-for-next.js) con [`mcp-handler` 2](https://www.npmjs.com/package/mcp-handler).

## Endpoint del MCP

```
http://localhost:3000/mcp
https://TU-DEPLOY.vercel.app/mcp
```

## Qué expone mindicador.cl

La API pública no pide API key. Los patrones que usa este servidor:

| Ruta | Qué devuelve |
| --- | --- |
| `https://mindicador.cl/api` | Snapshot con el valor vigente de todos los indicadores |
| `https://mindicador.cl/api/{codigo}` | Serie reciente (~último mes) |
| `https://mindicador.cl/api/{codigo}/{dd-mm-yyyy}` | Valor de un día. `serie` vacía en feriados o fines de semana |
| `https://mindicador.cl/api/{codigo}/{yyyy}` | Serie completa de un año |

Códigos: `dolar`, `dolar_intercambio`, `euro`, `uf`, `utm`, `ivp`, `ipc`, `imacec`, `tpm`, `libra_cobre`, `tasa_desempleo`, `bitcoin`.

No existe un endpoint del tipo `/api/17-08-2026` para todos los indicadores a la vez.

## Tools

- **`cotizacion_dolar`** — dólar observado vigente, por fecha o por año
- **`consultar_indicador`** — cualquier código de la tabla
- **`listar_indicadores`** — catálogo; con `incluir_valores: true` agrega el snapshot actual

## Desarrollo

```sh
npm install
npm run dev
```

Probar el cliente de ejemplo (con el server corriendo):

```sh
npm run test:client -- http://localhost:3000
```

## Conectar en Cursor

```json
{
  "mcpServers": {
    "mindicador": {
      "url": "http://localhost:3000/mcp"
    }
  }
}
```

En Vercel, cambia la URL por la del deploy.

## Deploy en Vercel

1. Sube el repo a GitHub (o usa `vercel`)
2. Activa Fluid Compute en el proyecto
3. El MCP queda en `/mcp`

No hay variables de entorno: mindicador.cl es pública.