nager-mcp 1.0.0

package/README.md

@@ -0,0 +1,13 @@
+# nager-mcp
+
+Fetch Nager.Date public holidays (keyless): countries, yearly holidays, upcoming holidays.
+
+## Tools
+
+- `list_countries` — Supported country codes.
+- `get_holidays` — Holidays for a year and country.
+- `next_holidays` — Next holidays for a country.
+
+## Source
+
+[nager-mcp](https://github.com/mrfentmen/premium-mcps/tree/main/servers/nager-mcp)

package/dist/api.d.ts

@@ -0,0 +1,7 @@
+export declare class NagerError extends Error {
+    constructor(message: string);
+}
+export declare function errorMessage(e: unknown): string;
+export declare function listCountries(): Promise<string>;
+export declare function getHolidays(year: string, country: string): Promise<string>;
+export declare function nextHolidays(country: string): Promise<string>;

package/dist/api.js

@@ -0,0 +1,36 @@
+export class NagerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "NagerError";
+    }
+}
+export function errorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+const UA = { "User-Agent": "awesome-mcps/1.0" };
+async function get(path) {
+    let res;
+    try {
+        res = await fetch("https://date.nager.at/api/v3" + path, {
+            headers: { ...UA, Accept: "application/json" },
+            signal: AbortSignal.timeout(25000),
+        });
+    }
+    catch (e) {
+        throw new NagerError(`Network error: ${e.message}`);
+    }
+    if (!res.ok) {
+        const body = (await res.text()).slice(0, 300);
+        throw new NagerError(`HTTP ${res.status}: ${body}`);
+    }
+    return (await res.text()).slice(0, 12000);
+}
+export function listCountries() {
+    return get("/AvailableCountries");
+}
+export function getHolidays(year, country) {
+    return get(`/PublicHolidays/${encodeURIComponent(year)}/${encodeURIComponent(country)}`);
+}
+export function nextHolidays(country) {
+    return get(`/NextPublicHolidays/${encodeURIComponent(country)}`);
+}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,12 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP server running on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,57 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { errorMessage, listCountries, getHolidays, nextHolidays, } from "./api.js";
+const text = (t) => ({ content: [{ type: "text", text: t }] });
+const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+export function createServer() {
+    const server = new McpServer({
+        name: "nager-mcp",
+        version: "1.0.0",
+    });
+    server.registerTool("list_countries", {
+        title: "List countries",
+        description: "Supported country codes.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async ({}) => {
+        try {
+            return text(await listCountries());
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("get_holidays", {
+        title: "Year holidays",
+        description: "Holidays for a year and country.",
+        inputSchema: z.object({
+            year: z.string().describe("Year, e.g. 2026."),
+            country: z.string().describe("ISO code, e.g. US.")
+        }),
+        annotations: READ_ONLY,
+    }, async ({ year, country }) => {
+        try {
+            return text(await getHolidays(year, country));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    server.registerTool("next_holidays", {
+        title: "Upcoming holidays",
+        description: "Next holidays for a country.",
+        inputSchema: z.object({
+            country: z.string().describe("ISO code, e.g. US.")
+        }),
+        annotations: READ_ONLY,
+    }, async ({ country }) => {
+        try {
+            return text(await nextHolidays(country));
+        }
+        catch (e) {
+            return textError(errorMessage(e));
+        }
+    });
+    return server;
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "nager-mcp",
+  "version": "1.0.0",
+  "description": "Nager public holidays. Keyless.",
+  "type": "module",
+  "mcpName": "io.github.mrfentmen/nager-mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrfentmen/premium-mcps.git"
+  },
+  "bin": {
+    "nager-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "rm -rf dist && tsc -p tsconfig.json && node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "holidays",
+    "calendar",
+    "countries",
+    "keyless"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}