# Bored MCP > Bored finds activities and leisure options instantly. Tell your AI agent what you're looking for—whether it’s a quick solo project, a big group outing, or something specific by price point—and get curated suggestions right away. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** activity-finder, boredom-buster, lifestyle, event-planning, leisure ## Description Got nothing to do? The Bored MCP helps you stop staring at an empty calendar and start planning. It talks to the massive database of activities so you can find fun things based on what you're in the mood for, not just a keyword. You don’t have to sift through endless websites; your AI agent handles it all. Need a spontaneous idea? Ask for something totally random. Planning an event and need specific filters—say, only free options or activities for four people? The MCP handles those constraints instantly. Because this connector is hosted on Vinkius, you connect once from any of your preferred clients, and the Bored API becomes available to all your agents. ## Tools ### get_activity_by_key Retrieves the full details of an activity using its unique identifying key number. ### find_activity Search for activities by providing specific criteria like type, cost, or group size. ### get_random_activity Generates and returns a completely random, ready-to-do suggestion. ## Prompt Examples **Prompt:** ``` I'm bored, give me a random activity to do. ``` **Response:** ``` How about this: 'Learn how to juggle'. It's a recreational activity that requires 1 participant and has an accessibility score of 0.3. ``` **Prompt:** ``` Find a social activity for 4 people that is free. ``` **Response:** ``` I found a great suggestion: 'Play a game of ultimate frisbee'. It's categorized as social, supports 4 participants, and costs 0.0. ``` **Prompt:** ``` What are the details for activity key 5881028? ``` **Response:** ``` Activity 5881028 is 'Learn a new cooking recipe'. It's a cooking type activity for 1 person with a price point of 0.2 and high accessibility. ``` ## Capabilities ### Generate random ideas It suggests a fun activity without needing any input—great for when you're stuck. ### Search by specific criteria You can filter activities by type, number of participants, or cost range. ### Look up known activities It pulls up the details for an activity you saw before using its unique key. ## Use Cases ### The Saturday afternoon slump You're with friends and everyone is bored. You ask your agent for activity ideas, but don't know what to narrow it down to. The agent uses `get_random_activity` first, giving you a starting point like 'learn pottery.' Then, you refine the search using `find_activity` to only show options that are under $20. ### The client follow-up Your manager mentions an activity they liked last month but can't remember the name. You provide the unique key, and your agent uses `get_activity_by_key` to instantly pull up all the details for you. ### The budget meeting You need a list of ideas for a community event that has no cost barrier. You use `find_activity`, specifically setting 'price' to zero, and get back dozens of genuinely free options for review. ## Benefits - Instant inspiration: If you're stuck, just asking for a random activity is enough. It gives you an immediate suggestion without needing any filters or inputs. - Precision planning: Don't waste time on irrelevant options. Use `find_activity` to filter by exactly what you need—like making sure the event is free and suitable for 4 people. - Quick reference: If someone sends you a link or mentions an activity key, use `get_activity_by_key` to pull up all the details immediately without searching again. - Accessibility checks: It helps you plan activities that match physical constraints by checking accessibility scores. - Time savings: Instead of switching between three different planning websites, your agent does the research and gives you a structured list right in your chat window. ## How It Works The bottom line is you tell your agent what's wrong with your afternoon; it brings back a list of things to do. 1. Subscribe to this MCP and connect your preferred AI agent. 2. Ask your agent a prompt, like 'I need something social for six people that costs less than ten dollars.' 3. The MCP runs the request through its tools and sends back detailed activity suggestions. ## Frequently Asked Questions **Can I find activities specifically for a large group of people?** Yes! You can use the `find_activity` tool and specify the `participants` parameter to get suggestions tailored to your group size. **How do I search for activities that are completely free?** Simply use the `find_activity` tool and set the `price` parameter to 0.0. You can also use `maxprice` to set a budget limit. **Can I retrieve an activity if I only have its ID number?** Absolutely. Use the `get_activity_by_key` tool and provide the unique numeric key to fetch the full details of that specific activity. **What happens if I use `get_activity_by_key` with an incorrect or expired activity key?** The tool immediately returns a clear error message indicating that the provided key is invalid. This prevents wasted calls; you just need to verify your source material for the correct unique ID. **Can I use `find_activity` to filter by multiple criteria, like low price and high accessibility?** Yes, you pass all required parameters into a single `find_activity` call. The tool handles complex logical filtering against its database automatically, giving you highly specific results. **Are there rate limits when running `get_random_activity` frequently?** Vinkius applies standard rate limiting per subscription tier to prevent abuse. Your AI client receives a standard HTTP error if you exceed the allotted number of calls within a given timeframe. **How quickly does `get_random_activity` generate an activity suggestion?** It is designed for instant use, returning an activity suggestion in milliseconds after the call. You should get an immediate response every single time you run it. **Do I need any specific setup before using `find_activity`?** No. Once you subscribe and connect your AI client through Vinkius, the tool is immediately ready to use. There's no complex configuration required beyond initial access authorization.