L2 Calendar

l2calendar-mcp

Servidor MCP para L2 Calendar — consulta las próximas aperturas de servidores privados de Lineage 2 por crónica directamente desde cualquier cliente MCP (Claude Desktop, Cursor, VS Code, Windsurf, Cline...).

Envuelve la API de L2 Calendar pública, gratuita y habilitada para CORS, y la expone como herramientas MCP.

Herramientas

Herramienta	Qué hace
list_servers	Lista los servidores rastreados, ordenados por estado VIP + fecha de apertura. Filtros: chronicle, only_upcoming, new_only, min_rate, max_rate, limit.
get_chronicles	Lista cada crónica (slug + nombre visible) para usar como filtro.
search_servers	Búsqueda de texto libre en nombre, sitio web, tasa, crónica, descripción y etiquetas.
get_server	Registro público completo de un servidor por nombre exacto (sin distinguir mayúsculas).
list_labels	Etiquetas distintas en uso (PTS, Low rate, Craft...) con colores.

Cada resultado es JSON, listo para que el modelo pueda razonar sobre él.

Fuente de datos

Todos los datos provienen de la API pública:

• GET https://l2calendar.com/api/servers — hasta 50 servidores por llamada, con filtro opcional ?chronicle=<slug>.
• GET https://l2calendar.com/api/chronicles — el catálogo de crónicas.

La API es de solo lectura, no requiere clave y envía Access-Control-Allow-Origin: *.

Campos devueltos por servidor: name, website_url, rate, opening_date, opening_time, opening_datetime_utc, description, is_vip, vip_level, multiproff, multicraft, is_new, chronicle y labels.

Nota: la API pública devuelve una sola página de hasta 50 servidores (VIP primero, luego la apertura más próxima). Las herramientas que filtran o buscan operan sobre esa página pública. Aumenta la precisión con el filtro chronicle.

Instalación

Remoto (HTTP) — sin instalación

Cuando está alojado, apunta tu cliente al endpoint HTTP transmisible por streaming:

{
  "mcpServers": {
    "l2calendar": {
      "type": "http",
      "url": "https://<your-host>/mcp"
    }
  }
}

Local (stdio) mediante npx

{
  "mcpServers": {
    "l2calendar": {
      "command": "npx",
      "args": ["-y", "l2calendar-mcp"]
    }
  }
}

Local (stdio) desde el código fuente

git clone https://github.com/Dreiev/l2calendar-mcp.git
cd l2calendar-mcp
npm install
npm run build

{
  "mcpServers": {
    "l2calendar": {
      "command": "node",
      "args": ["/absolute/path/to/l2calendar-mcp/dist/index.js"]
    }
  }
}

Ejecutar el transporte HTTP

node dist/index.js --http            # http://127.0.0.1:8787/mcp
node dist/index.js --http --port 9000

GET /health devuelve { "status": "ok" } para comprobaciones de disponibilidad.

Configuración

Variable	Predeterminado	Propósito
L2CALENDAR_API_URL	https://l2calendar.com	URL base de la instancia de L2 Calendar a consultar.

Ejemplos de indicaciones

• "Lista los servidores de Interlude que abren pronto."
• "¿Qué servidores Classic son nuevos esta semana?"
• "Busca servidores de High Five con tasa x1000."
• "Muéstrame cada crónica que rastrea L2 Calendar."
• "Obtén los detalles del servidor llamado L2Hispano."

Desarrollo

npm install
npm run build      # tsc -> dist/
npm run dev        # run src/index.ts directly (Node >= 22)
npm run start:http # build output over HTTP

Acerca de L2 Calendar

L2 Calendar es un calendario y rastreador multilingüe (EN/ES/PT/RU) de aperturas de servidores privados de Lineage 2 por crónica — l2calendar.com.

Licencia

MIT © Dreiev