Random Activity Suggester Extended

Suggests 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.

Features

• Fetch random activity suggestions
• Optionally filter by type (e.g. "education", "cooking") and number of participants (1-8)
• Uses the free, public BoredAPI

Installation & Usage

With npm or npx

You can use this server directly with npx (no install needed), or install locally:

Run via npx:

npx @dennisk2025/random-activity-suggester-extended

Or install locally:

npm install @dennisk2025/random-activity-suggester-extended

Adding to Claude Desktop

Add this server to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Example configuration:

{
  "mcpServers": {
    "activity": {
      "command": "npx",
      "args": ["@dennisk2025/random-activity-suggester-extended"]
    }
  }
}

Usage Examples

Tool: get_random_activity

Fetch a random activity, optionally filtered by type and/or number of participants.

Example 1: No parameters (completely random)

Name: get_random_activity
Arguments: {}

Example 2: By type

Name: get_random_activity
Arguments: { "type": "cooking" }

Example 3: By participants

Name: get_random_activity
Arguments: { "participants": 3 }

Example 4: By type and participants

Name: get_random_activity
Arguments: { "type": "relaxation", "participants": 1 }

Tool API Reference

get_random_activity

• Description: Fetches a random activity suggestion. You can optionally specify the activity type and/or number of participants.
• Parameters:
  • type (string, optional): Type of activity. Options: education, recreational, social, diy, charity, cooking, relaxation, music, busywork.
  • participants (integer, optional): Number (1-8) of participants for the suggested activity.
• Returns:
  • An object with keys:
    • activity (string): Description of the activity
    • type (string): Activity type
    • participants (integer): Number of participants
    • price (number): 0.0-1.0 cost estimate
    • link (string): Optional link
    • key (string): Unique API key
    • accessibility (number): 0.0-1.0, how accessible the activity is

Notes

• All API calls use BoredAPI and do not require any authentication or API keys.
• Returns clear error messages if invalid arguments are supplied or BoredAPI cannot provide a suitable activity.