{"_id":"@dennisk2025/public-holidays-finder","name":"@dennisk2025/public-holidays-finder","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/public-holidays-finder","version":"1.0.0","description":"Provides a list of upcoming public holidays for a given country code and year, using real-world data from the Nager.Date API.","type":"module","main":"index.js","bin":{"public-holidays-finder":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/public-holidays-finder@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-V3Wk35LKou9GiqdDQO+LCuTttO/QEfR9JG303+JMBCdbQV216jygSRGxmACuxwOiZe1TXwycSpzzHP1CtVHC8Q==","shasum":"d1889f1962f136ae1dd16deeab702a58caaaf6cc","tarball":"https://registry.npmjs.org/@dennisk2025/public-holidays-finder/-/public-holidays-finder-1.0.0.tgz","fileCount":3,"unpackedSize":8015,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICtmWhTmTcI6rEERCIXiYGzuT3HsAfbsUWkE+WlYuSSdAiBAKahiWFaFQmY+e4ymFUB8/l9V14zKn7iwa483GRJJNQ=="}]},"_npmUser":{"name":"dennisk2025","email":"4dennisk@gmail.com"},"directories":{},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/public-holidays-finder_1.0.0_1761426667027_0.05709235979243665"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T21:11:06.882Z","1.0.0":"2025-10-25T21:11:07.230Z","modified":"2025-10-25T21:11:07.556Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Provides a list of upcoming public holidays for a given country code and year, using real-world data from the Nager.Date API.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# Public Holidays Finder MCP Server\n\nProvides a list of upcoming public holidays for a given country code and year, using real-world data from the Nager.Date API (https://date.nager.at/).\n\n## Features\n- Instantly find all public holidays for any ISO 3166-1 alpha-2 country code and year.\n- Works fully offline via Claude Desktop integration (fetches holidays live from the network).\n- No API key required. Free and open source.\n\n## Installation & Usage\n\n### One-time install (optional)\n\n```\nnpm install -g @dennisk2025/public-holidays-finder\n```\n\nOr run directly at any time with NPX:\n\n```\nnpx @dennisk2025/public-holidays-finder\n```\n\n## Adding to Claude Desktop\n\nTo make this server available in Claude Desktop, add the following configuration to your `claude_desktop_config.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"public-holidays\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/public-holidays-finder\"]\n    }\n  }\n}\n```\n\n**Location of your config file:**\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nAfter saving the file, restart Claude Desktop for changes to take effect.\n\n## Available Tool(s)\n\n### get_public_holidays\n- **Description:** Fetches upcoming public holidays for the specified country (by ISO country code) and year.\n- **Parameters:**\n  - `countryCode` (string): An ISO 3166-1 alpha-2 country code (e.g., \"US\", \"GB\", \"DE\").\n  - `year` (integer): The year to search for public holidays (e.g., 2024).\n\n#### Example Usage\n\n**Params:**\n```json\n{\n  \"countryCode\": \"US\",\n  \"year\": 2024\n}\n```\n**Result:**\n- Returns a JSON array of public holiday objects as provided by the Nager.Date API. Each object contains: date, localName, name, countryCode, fixed, global, counties, launchYear, type, etc.\n\n#### Example Request/Response\n\n**Request:**\n```\nTool: get_public_holidays\nParams: { \"countryCode\": \"DE\", \"year\": 2024 }\n```\n**Response:**\n```\n{\n  \"holidays\": [\n    {\n      \"date\": \"2024-01-01\",\n      \"localName\": \"Neujahr\",\n      \"name\": \"New Year's Day\",\n      \"countryCode\": \"DE\",\n      ...\n    },\n    ...\n  ]\n}\n```\n\n## Error Handling\n- Errors such as invalid codes, year out of range, or unavailable data will return a descriptive error message.\n\n---\n\n## Full Tool List\n\n### get_public_holidays\n- **Input:**\n  - `countryCode` (string, ISO 3166-1 alpha-2, required)\n  - `year` (integer, required)\n- **Returns:**\n  - `{ holidays: [ ... ] }` array of public holiday objects as per https://date.nager.at/swagger/index.html (fields: date, localName, name, etc.)\n\n---\n\nPowered by the Model Context Protocol (MCP). Not affiliated with Nager.Date or OpenAI/Anthropic.\n","readmeFilename":"README.md","_rev":"1-e504ba293885bdccccc97d320c8afbe4"}