{"_id":"@dennisk2025/random-number-fact","name":"@dennisk2025/random-number-fact","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/random-number-fact","version":"1.0.0","description":"Fetches an interesting, real-world fact or trivia about a given number (integer), including historical events, mathematics, or fun facts.","type":"module","main":"index.js","bin":{"random-number-fact":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/random-number-fact@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-Wv5tkcppKHurSk3rAuXsTQnD4HG0TMS4rtWh71f06kpD54nC0RB2SsSe1eZuq3ePk2enyQafaeZiXMpgFivedQ==","shasum":"87110233215cb0f42455507eb77b20ff09f94bd5","tarball":"https://registry.npmjs.org/@dennisk2025/random-number-fact/-/random-number-fact-1.0.0.tgz","fileCount":3,"unpackedSize":6779,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAe6PitS9vUr9xoHhrJQomNMUA5cIF3y4ewjpru5VjAgAiBtVUSy+0oyWjG350aRTjfQBcT8G2zf+MFHvW0yMh4EYw=="}]},"_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-number-fact_1.0.0_1761425973482_0.8006874989697885"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T20:59:33.417Z","1.0.0":"2025-10-25T20:59:33.687Z","modified":"2025-10-25T20:59:33.927Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Fetches an interesting, real-world fact or trivia about a given number (integer), including historical events, mathematics, or fun facts.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# random-number-fact MCP Server\n\nFetch interesting, real-world facts or trivia about a given number — including historical events, mathematics, or fun facts — directly from numbersapi.com, using the Model Context Protocol (MCP).\n\n## Features\n- Fetch trivia, math, date, or year facts about any integer.\n- Supports random facts and specific number lookups.\n- Robust error handling, production-ready.\n\n## Installation\n\nYou can use npx (recommended):\n\n```\nnpx @dennisk2025/random-number-fact\n```\n\nOr install globally via npm:\n\n```\nnpm install -g @dennisk2025/random-number-fact\n```\n\n## Adding to Claude Desktop\n\nAdd the following configuration to your Claude Desktop config file:\n\n```json\n{\n  \"mcpServers\": {\n    \"randomnumberfact\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/random-number-fact\"]\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---\n\n## Usage & Example Tools\n\n### Tool: get_number_fact\n\nFetches a random or specific fact about any integer. Supports multiple types:\n\n#### Parameters:\n- `number` (integer, optional): The number to fetch a fact for. Omit for random.\n- `type` (string, optional): One of `trivia`, `math`, `date`, `year`, or `random`. Default: `trivia`.\n\n#### Examples:\n\n**1. Get a random trivia fact:**\n```\nName: get_number_fact\nArguments: {}\n```\n\n**2. Fact about the number 42 (default trivia):**\n```\nName: get_number_fact\nArguments: { \"number\": 42 }\n```\n\n**3. Math fact about 17:**\n```\nName: get_number_fact\nArguments: { \"number\": 17, \"type\": \"math\" }\n```\n\n**4. Fact about year 1984:**\n```\nName: get_number_fact\nArguments: { \"number\": 1984, \"type\": \"year\" }\n```\n\n**5. Fact about March 14 (Pi Day, as MM/DD):**\n```\nName: get_number_fact\nArguments: { \"number\": \"3/14\", \"type\": \"date\" }\n```\n\n**6. Completely random fact (random type/number):**\n```\nName: get_number_fact\nArguments: { \"type\": \"random\" }\n```\n\n---\n\n### Available Tools\n\n#### `get_number_fact`\n- Returns an interesting fact about a number. Parameters:\n  - `number` (integer or string for \"date\" type, optional): Number to fetch fact for. Accepts MM/DD for date facts, or YYYYMMDD (auto-converted).\n  - `type` (string, optional): \"trivia\", \"math\", \"date\", \"year\", or \"random\". Default: \"trivia\".\n\n---\n\nStart generating fun number facts for anything from your Claude Desktop conversations!\n","readmeFilename":"README.md","_rev":"1-2ac5c71e1a833eb1e312a34918fc1998"}