{"_id":"@dennisk2025/random-historical-event-finder","name":"@dennisk2025/random-historical-event-finder","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/random-historical-event-finder","version":"1.0.0","description":"Fetches a random significant historical event that happened on today's date, using data from history.muffinlabs.com API.","type":"module","main":"index.js","bin":{"random-historical-event-finder":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/random-historical-event-finder@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-0zvfz5rc6HkMdfjWJN05AGTLzUbancjzmR99nafvfFa0JwBmykYLMXvfFN7p9wE9M6ZUL3yFHccIbjEgihYb7A==","shasum":"e11fccc0e59e537c034feeacfed74053e2cbf51a","tarball":"https://registry.npmjs.org/@dennisk2025/random-historical-event-finder/-/random-historical-event-finder-1.0.0.tgz","fileCount":3,"unpackedSize":6750,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIESO40aPG5E2jQMbdHjeMH2HsIa4txlCkwWDIifi4Q1VAiBWcsNKnJ7E+vw+hspHd045yUGFOUMNV9UW3RNw5lbGXQ=="}]},"_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/random-historical-event-finder_1.0.0_1761426863304_0.5069387458469821"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T21:14:23.239Z","1.0.0":"2025-10-25T21:14:23.482Z","modified":"2025-10-25T21:14:23.705Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Fetches a random significant historical event that happened on today's date, using data from history.muffinlabs.com API.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# random-historical-event-finder\n\nFetches a random significant historical event that happened on today's date, including the year, event description, and optionally the category, using data from the history.muffinlabs.com API.\n\n## Installation\n\nYou can use this Model Context Protocol (MCP) server directly with npx, or install it locally:\n\n### Quick usage (no install):\n\n    npx @dennisk2025/random-historical-event-finder\n\n### Or install globally:\n\n    npm install -g @dennisk2025/random-historical-event-finder\n\nThen you can run:\n\n    random-historical-event-finder\n\n## Claude Desktop Integration\n\nTo add this MCP server to Claude Desktop, add the following to your Claude configuration file (replace any placeholder with the actual package name):\n\n```json\n{\n  \"mcpServers\": {\n    \"random-historical-event\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/random-historical-event-finder\"]\n    }\n  }\n}\n```\n\nAdd this to your Claude Desktop config file at:\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n## Usage\n\nOnce enabled in Claude Desktop, use the MCP tool to fetch a random historical event from today. You can call the tool with no parameters.\n\n### Example Tool Call\n\n**Tool:** `get_random_today_event`\n\n**Parameters:** none\n\n**Example output:**\n\n```json\n{\n  \"year\": \"1971\",\n  \"description\": \"Launch of the Mars 3 lander, the first spacecraft to land and transmit from Mars.\",\n  \"category\": null,\n  \"links\": [\n    { \"title\": \"Mars 3\", \"link\": \"https://en.wikipedia.org/wiki/Mars_3\" }\n  ],\n  \"month\": 12,\n  \"day\": 2\n}\n```\n\n## List of Available Tools\n\n### 1. `get_random_today_event`\n- **Description:** Returns a random historical event that occurred on the current date (month and day), including the year and event details.\n- **Parameters:** none (object with no properties)\n\n#### Example call body:\n\n```json\n{\n  \"name\": \"get_random_today_event\",\n  \"arguments\": {}\n}\n```\n\n#### Example success response:\n\n```json\n{\n  \"year\": \"1848\",\n  \"description\": \"The Treaty of Guadalupe Hidalgo is signed, ending the Mexican-American War.\",\n  \"category\": null,\n  \"links\": [\n    { \"title\": \"Treaty of Guadalupe Hidalgo\", \"link\": \"https://en.wikipedia.org/wiki/Treaty_of_Guadalupe_Hidalgo\" }\n  ],\n  \"month\": 2,\n  \"day\": 2\n}\n```\n\n## Error Handling\n- If the server cannot contact the external API or if there are no events for today, a clear error message is returned.\n\n## Notes\n- No API keys or authentication are required.\n- All data is sourced from https://history.muffinlabs.com.\n","readmeFilename":"README.md","_rev":"1-b2941c3bb781927203e85f9e5162d08c"}