{"_id":"@dennisk2025/random-fun-fact","name":"@dennisk2025/random-fun-fact","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/random-fun-fact","version":"1.0.0","description":"Fetches a random, fun, real-world fact from the Useless Facts API. Each call returns a single quirky, surprising, or amusing fact, optionally specifying the language.","type":"module","main":"index.js","bin":{"random-fun-fact-mcp":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/random-fun-fact@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-pUZn/jOIVw4/oGX+HAers/kXKsGfJlYqmisu8nHVaVVfcllnU3fei3jmpqBlgc2G3x8GnyNbzDOygPfBLLFJ8w==","shasum":"52a493b22fda081b71d9c469bab8b95ad1f283f5","tarball":"https://registry.npmjs.org/@dennisk2025/random-fun-fact/-/random-fun-fact-1.0.0.tgz","fileCount":3,"unpackedSize":5538,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCxquGcBVNy/6kZZyBpVkaUyo7J9WntGj89unpdr8ybcQIgChB9k22ma0F1zGb3jU9QWlxzhLkNzJ5SeL1+mZTV94E="}]},"_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-fun-fact_1.0.0_1761427025434_0.8564852413997652"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T21:17:05.336Z","1.0.0":"2025-10-25T21:17:05.630Z","modified":"2025-10-25T21:17:05.920Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Fetches a random, fun, real-world fact from the Useless Facts API. Each call returns a single quirky, surprising, or amusing fact, optionally specifying the language.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# random-fun-fact-mcp\n\nFetches a random, fun, real-world fact from the Useless Facts API. Each call returns a single quirky, surprising, or amusing fact, optionally specifying the language (English or German).\n\n## Installation\n\nInstall globally using npm:\n\n```\nnpm install -g @dennisk2025/random-fun-fact-mcp\n```\n\nOr run instantly via npx (recommended for Claude Desktop):\n\n```\nnpx @dennisk2025/random-fun-fact-mcp\n```\n\n## Adding to Claude Desktop\n\nAdd the following JSON snippet 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```json\n{\n  \"mcpServers\": {\n    \"random-fun-fact\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/random-fun-fact-mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop and \"random-fun-fact\" will appear as a custom MCP tool.\n\n## Usage\n\nThis MCP provides one tool:\n\n### Tool: get_random_fun_fact\n\nReturns a random fun fact in the specified language (English or German).\n\n#### Parameters\n- `language` (optional):\n  - Type: string\n  - Allowed values: `\"en\"`, `\"de\"`\n  - Description: The language code for the fact. 'en' for English, 'de' for German. Defaults to 'en'.\n\n#### Usage Examples\n\n##### English (default)\n```\n{\n  \"name\": \"get_random_fun_fact\",\n  \"arguments\": {}\n}\n```\n\n##### German\n```\n{\n  \"name\": \"get_random_fun_fact\",\n  \"arguments\": { \"language\": \"de\" }\n}\n```\n\n#### Response Example\n```\n{\n  \"fact\": \"The unicorn is Scotland’s national animal.\",\n  \"language\": \"en\"\n}\n```\n\n## Available Tools\n\n| Tool Name             | Description                                                                    | Parameters         |\n|----------------------|--------------------------------------------------------------------------------|--------------------|\n| get_random_fun_fact  | Returns a random fun fact (optionally specify language: 'en' or 'de').         | language (string)  |\n\n## Notes\n- No API keys required. All facts from [uselessfacts.jsph.pl](https://uselessfacts.jsph.pl/)\n- Safe for use in production or personal chats!\n","readmeFilename":"README.md","_rev":"1-c3bc0b5c975a721b275bafc1e949aec0"}