l2calendar-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@l2calendar-mcp List the Interlude servers opening soon"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
l2calendar-mcp
MCP server for L2 Calendar — query upcoming Lineage 2 private server openings by chronicle directly from any MCP client (Claude Desktop, Cursor, VS Code, Windsurf, Cline...).
It wraps the free, public, CORS-enabled L2 Calendar API and exposes it as MCP tools.
Tools
Tool | What it does |
| List tracked servers, ordered by VIP status + opening date. Filters: |
| List every chronicle (slug + display name) to use as a filter. |
| Free-text search across name, website, rate, chronicle, description and labels. |
| Full public record of one server by exact name (case-insensitive). |
| Distinct labels in use (PTS, Low rate, Craft...) with colors. |
Every result is JSON, ready for the model to reason about.
Related MCP server: GoogleCalendarMCP
Data source
All data comes from the public API:
GET https://l2calendar.com/api/servers— up to 50 servers per call, optional?chronicle=<slug>filter.GET https://l2calendar.com/api/chronicles— the chronicle catalog.
The API is read-only, requires no key and sends Access-Control-Allow-Origin: *.
Fields returned per server: name, website_url, rate, opening_date, opening_time, opening_datetime_utc, description, is_vip, vip_level, multiproff, multicraft, is_new, chronicle and labels.
Note: the public API returns a single page of up to 50 servers (VIP first, then soonest opening). Tools that filter or search operate on that public page. Increase precision with the
chroniclefilter.
Install
Remote (HTTP) — no install
When hosted, point your client at the streamable HTTP endpoint:
{
"mcpServers": {
"l2calendar": {
"type": "http",
"url": "https://<your-host>/mcp"
}
}
}Local (stdio) via npx
{
"mcpServers": {
"l2calendar": {
"command": "npx",
"args": ["-y", "l2calendar-mcp"]
}
}
}Local (stdio) from source
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"]
}
}
}Run the HTTP transport
node dist/index.js --http # http://127.0.0.1:8787/mcp
node dist/index.js --http --port 9000GET /health returns { "status": "ok" } for uptime checks.
Configuration
Variable | Default | Purpose |
|
| Base URL of the L2 Calendar instance to query. |
Example prompts
"List the Interlude servers opening soon."
"Which Classic servers are new this week?"
"Search for High Five servers with rate x1000."
"Show me every chronicle L2 Calendar tracks."
"Get the details of the server named L2Hispano."
Development
npm install
npm run build # tsc -> dist/
npm run dev # run src/index.ts directly (Node >= 22)
npm run start:http # build output over HTTPAbout L2 Calendar
L2 Calendar is a multilingual (EN/ES/PT/RU) calendar and tracker of Lineage 2 private server openings by chronicle — l2calendar.com.
License
MIT © Dreiev
Available Tools
5 toolsget_chroniclesList Lineage 2 chroniclesA
List every Lineage 2 chronicle tracked by L2 Calendar (slug, display name and order). Use the slugs as the chronicle filter for list_servers.
Inputs: no named parameters.
get_serverGet a Lineage 2 private serverA
Return the full public record of a single server by its exact name (case-insensitive), including description and labels.
Inputs: name (required), chronicle.
list_labelsList server labelsA
List the distinct labels (e.g. PTS, Low rate, Craft) currently applied to servers on the public page, with their colors.
Inputs: no named parameters.
list_serversList Lineage 2 private serversA
List Lineage 2 private servers tracked by L2 Calendar, ordered by VIP status and opening date. Optionally filter by chronicle, upcoming openings, newly added entries or rate range.
Inputs: limit, max_rate, min_rate, new_only, +2 more.
search_serversSearch Lineage 2 private serversA
Search the current L2 Calendar server page by free text. Matches the server name, website, rate, chronicle, description and labels (case-insensitive).
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Most tools have clearly distinct purposes, with list_servers, search_servers, and get_server each serving different retrieval modes. The only possible confusion is between list_servers and search_servers, since both return servers, but their filtering vs. free-text search approaches are described distinctly.
All tool names follow a consistent snake_case verb_noun pattern: list_servers, get_chronicles, search_servers, get_server, list_labels. The verbs (list, get, search) are predictable and match the action each tool performs.
Five tools is a well-scoped set for a read-only calendar/lookup service. Each tool covers a distinct need—listing, searching, detail retrieval, and reference lookups—without unnecessary redundancy or bloat.
The tool surface fully covers the apparent read-only domain: broad listing with filters, free-text search, exact record retrieval, and enumeration of chronicles and labels. No obvious dead ends or missing operations for the stated purpose.
Maintenance
Related MCP Connectors
Google Events listings with dates, venues, and ticket links via a hosted MCP server.
MCP server providing attendance data queries via the CloudTime API.
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
A MCP server that works with Google Calendar to manage event listing, reading, and updates.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA read-only MCP server that exposes iCalendar feeds as queryable tools for LLM agents, enabling calendar event retrieval and filtering.MIT
- AlicenseDqualityDmaintenanceMCP server for interacting with Google Calendar, enabling reading events from public calendars and, with OAuth, creating, updating, and deleting events.1ISC
- AlicenseNot gradedqualityDmaintenanceEnables seamless Google Calendar integration with MCP-compatible clients, allowing creation, viewing, updating, and deletion of calendar events via OAuth 2.0 authentication.MIT
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Google Calendar via MCP, allowing users to list, get, search, and create events as well as list accessible calendars.-