{"_id":"@dennisk2025/random-activity-suggester-extended","name":"@dennisk2025/random-activity-suggester-extended","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/random-activity-suggester-extended","version":"1.0.0","description":"Suggests a random activity idea based on type and number of participants using the BoredAPI.","type":"module","main":"index.js","bin":{"random-activity-suggester-extended":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/random-activity-suggester-extended@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-URp/8I+xvM3UzaSgxTw4abfa+OmtfIhPxFNqu0kTJmKDpjrVL00hekDqqpJqPqXqumjcR+atZdy7vgimJxSGvw==","shasum":"d902ac4f8589270c6b07399982da6bb5cda052b9","tarball":"https://registry.npmjs.org/@dennisk2025/random-activity-suggester-extended/-/random-activity-suggester-extended-1.0.0.tgz","fileCount":3,"unpackedSize":8068,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHGng7oPbzHNv/BVqCRamqYhAGRzzjkg2Oz+x9KSJzRVAiAMFXuV+mGFOy7aAx2q1+Qp3z6pSDERWWupd0XxQX3qzQ=="}]},"_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-activity-suggester-extended_1.0.0_1761426705029_0.3780308936349519"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T21:11:44.888Z","1.0.0":"2025-10-25T21:11:45.204Z","modified":"2025-10-25T21:11:45.471Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Suggests a random activity idea based on type and number of participants using the BoredAPI.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# Random Activity Suggester Extended\n\nSuggests a random activity idea based on type and number of participants using the public BoredAPI. Extends the base suggestions with support for filtering by activity type and participants.\n\n## Features\n- Fetch random activity suggestions\n- Optionally filter by type (e.g. \"education\", \"cooking\") and number of participants (1-8)\n- Uses the free, public [BoredAPI](https://www.boredapi.com/)\n\n## Installation & Usage\n\n### With npm or npx\nYou can use this server directly with npx (no install needed), or install locally:\n\n**Run via npx:**\n```\nnpx @dennisk2025/random-activity-suggester-extended\n```\n\n**Or install locally:**\n```\nnpm install @dennisk2025/random-activity-suggester-extended\n```\n\n## Adding to Claude Desktop\n\nAdd this server 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\nExample configuration:\n```json\n{\n  \"mcpServers\": {\n    \"activity\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/random-activity-suggester-extended\"]\n    }\n  }\n}\n```\n\n## Usage Examples\n\n### Tool: get_random_activity\nFetch a random activity, optionally filtered by type and/or number of participants.\n\n#### Example 1: No parameters (completely random)\n```\nName: get_random_activity\nArguments: {}\n```\n\n#### Example 2: By type\n```\nName: get_random_activity\nArguments: { \"type\": \"cooking\" }\n```\n\n#### Example 3: By participants\n```\nName: get_random_activity\nArguments: { \"participants\": 3 }\n```\n\n#### Example 4: By type and participants\n```\nName: get_random_activity\nArguments: { \"type\": \"relaxation\", \"participants\": 1 }\n```\n\n## Tool API Reference\n\n### get_random_activity\n- **Description:** Fetches a random activity suggestion. You can optionally specify the activity type and/or number of participants.\n- **Parameters:**\n  - `type` (string, optional): Type of activity. Options: `education`, `recreational`, `social`, `diy`, `charity`, `cooking`, `relaxation`, `music`, `busywork`.\n  - `participants` (integer, optional): Number (1-8) of participants for the suggested activity.\n- **Returns:**\n  - An object with keys:\n    - `activity` (string): Description of the activity\n    - `type` (string): Activity type\n    - `participants` (integer): Number of participants\n    - `price` (number): 0.0-1.0 cost estimate\n    - `link` (string): Optional link\n    - `key` (string): Unique API key\n    - `accessibility` (number): 0.0-1.0, how accessible the activity is\n\n## Notes\n- All API calls use BoredAPI and do **not** require any authentication or API keys.\n- Returns clear error messages if invalid arguments are supplied or BoredAPI cannot provide a suitable activity.\n","readmeFilename":"README.md","_rev":"1-a7f8756e1b321ca8b0206fca8ce02c8f"}