English Français العربية

L2 Calendar

Official registry Productivity

Query Lineage 2 private server openings by chronicle through the public L2 Calendar API.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package l2calendar-mcp
Claude Code 
claude mcp add l2-calendar -- npx -y l2calendar-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "l2-calendar": {
            "command": "npx",
            "args": [
                "-y",
                "l2calendar-mcp@1.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. l2calendar-mcp
  2. Tools
  3. Data source
  4. Install
  5. Run the HTTP transport
  6. Configuration
  7. Example prompts
  8. Development
  9. About L2 Calendar
  10. License

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

ToolWhat it does
list_serversList tracked servers, ordered by VIP status + opening date. Filters: chronicle, only_upcoming, new_only, min_rate, max_rate, limit.
get_chroniclesList every chronicle (slug + display name) to use as a filter.
search_serversFree-text search across name, website, rate, chronicle, description and labels.
get_serverFull public record of one server by exact name (case-insensitive).
list_labelsDistinct labels in use (PTS, Low rate, Craft...) with colors.

Every result is JSON, ready for the model to reason about.

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 chronicle filter.

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 9000

GET /health returns { "status": "ok" } for uptime checks.

Configuration

VariableDefaultPurpose
L2CALENDAR_API_URLhttps://l2calendar.comBase 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 HTTP

About 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

Frequently asked questions

What is L2 Calendar?

Query Lineage 2 private server openings by chronicle through the public L2 Calendar API.

How do I install L2 Calendar?

It runs on your machine. In Claude Code: claude mcp add l2-calendar -- npx -y l2calendar-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does L2 Calendar need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is L2 Calendar open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains L2 Calendar?

It is published by Dreiev. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.