@dennisk2025/random-us-holiday-finder
v1.0.0
Published
Fetches a random upcoming public holiday in the United States, including its name, date, and a brief description.
Readme
random-us-holiday-finder
Fetches a random upcoming public holiday in the United States, including its name, date, and a brief description.
Installation
You can use this MCP server via npx (no installation required):
npx @dennisk2025/random-us-holiday-finder
Or install globally with npm:
npm install -g @dennisk2025/random-us-holiday-finder
Adding to Claude Desktop
To use this server with Claude Desktop, add the following JSON to your Claude configuration file. Add this to your Claude Desktop config file at:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"random-holiday": {
"command": "npx",
"args": ["@dennisk2025/random-us-holiday-finder"]
}
}
}Usage
After adding, you can use the provided tool to fetch a random upcoming US public holiday.
Available Tools
- get-random-upcoming-holiday: Returns a random upcoming US public holiday with its name, date, and a description.
Parameters
- None
Example Tool Call
Tool name: get-random-upcoming-holiday
Parameters:
{}Example Output
{
"name": "Memorial Day",
"date": "2024-05-27",
"description": "No additional description available."
}Notes
- Uses the public API from date.nager.at (no API key required).
- Handles errors gracefully and will always return a relevant message if the API is unreachable.
