Bored API Connector for AI agents.
3 live capabilities
Find hobbies and group activities based on your budget and group size.
Waiting for input…
Why people use Bored API
Bored for Hobby Discovery and Leisure Planning
This Connector changes that by letting your AI client do the filtering for you. You tell it your budget, how many people are coming over, and if you want to relax or learn something new. It pulls from a structured library to give you a handful of solid options you can actually act on right now.
What Vinkius changes
Your AI becomes a personal concierge for leisure and hobbies.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Planning a free group hangout
You ask your agent for "free social things for 4 people.
- Real-world use case 02
Finding a solo hobby
You tell your agent you want to learn something new but have no energy.
- Real-world use case 03
Organizing a large party
You ask for "educational activities for 10 people.
Complete set · 3capabilities
The complete Bored API capability set.
These are the exact actions your AI can choose when you ask it to work with Bored API.
01—03
3 capabilities in this set.
Part of 3 available through Bored API.
- 01 Capability
Get activity by key
Pull up a specific activity using its unique ID. This is perfect for referencing a favorite suggestion you've saved before.
- 02 Capability
Find activity
Search for a new hobby based on your budget, group size, or category. It lets your agent filter thousands of options into a few solid choices.
- 03 Capability
Get random activity
Get a completely random suggestion for when you have no idea what to do. It's the fastest way to break a cycle of boredom immediately.
Set up in minutes
One URL. Then ask Bored API to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Bored API from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_K6W0XjuexHpFxOwHF91HOk8685sw1tK1MJbcmZ7V/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Bored API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Bored API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_K6W0XjuexHpFxOwHF91HOk8685sw1tK1MJbcmZ7V/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Bored API URL.
- Step 03
Save and start
Save the connection and enable Bored API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"bored": {
"url": "https://edge.vinkius.com/vk_preview_K6W0XjuexHpFxOwHF91HOk8685sw1tK1MJbcmZ7V/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Bored API
Open Agent mode in chat and ask: "Using Bored API, help me...". 3 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"bored": {
"url": "https://edge.vinkius.com/vk_preview_K6W0XjuexHpFxOwHF91HOk8685sw1tK1MJbcmZ7V/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Bored API
Ask Copilot: "Using Bored API, help me...". 3 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"bored": {
"url": "https://edge.vinkius.com/vk_preview_K6W0XjuexHpFxOwHF91HOk8685sw1tK1MJbcmZ7V/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Bored API
Open Cascade and ask: "Using Bored API, help me...". 3 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"bored": {
"url": "https://edge.vinkius.com/vk_preview_K6W0XjuexHpFxOwHF91HOk8685sw1tK1MJbcmZ7V/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Bored API
Ask Cline: "Using Bored API, help me...". 3 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add bored --transport http "https://edge.vinkius.com/vk_preview_K6W0XjuexHpFxOwHF91HOk8685sw1tK1MJbcmZ7V/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Bored API
Ask Claude: "Using Bored API, show me...". 3 tools are ready
Where the request belongs
Work Bored API can move forward.
For the person who wants to do something new but hates the paradox of choice when browsing the internet. It's for people who need to plan group outings without the back-and-forth of constant texting.
Event Organizer
Plans group outings for different sizes and budgets without manual research.
Stay-at-home Parent
Finds quick DIY projects or educational tasks for kids on a whim.
Solo Learner
Looks for new skills or relaxing hobbies to do alone to break a routine.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsAmilia
Recreation and activity management. manage programs, accounts, and registrations via AI.
SeatGeek
Search and list SeatGeek events, performers, and venues directly from your AI agent.
Ticketmaster
Search for live events, venues, and attractions, and manage ticket reservations directly through Ticketmaster's APIs.
Bookeo
Manage bookings, customers, products, payments, and availability for your Bookeo-powered fitness or activity business through natural conversation.
GetYourGuide
Search and book tours, activities, and travel experiences via AI agents with GetYourGuide.
SavvyCal
Manage your SavvyCal scheduling links, check real-time availability, and coordinate automated bookings via AI.
Bring your own AI
Change the model, client or framework. Keep Bored API connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Bored API.
The practical details behind the request, access and result.
Can the Bored MCP help me plan a party for a large group?
Yes, it's great for that. You can ask your agent to find activities that support a specific number of participants, and it will filter the library to find options that work for big crowds.
Does the Bored MCP suggest activities that are free?
Definitely. You can tell your AI client to only look for activities with a zero price point, making it easy to find low-cost or free things to do with friends.
Is the Bored MCP good for finding solo hobbies?
It's perfect for that. You can filter for one-person activities and specific categories like relaxation or learning to find things you can do on your own.
How does the Bored MCP handle physical accessibility?
It includes accessibility scores for activities. This helps you find tasks that match your specific physical or situational needs without having to guess.
Can I use the Bored MCP to find specific activities I've seen before?
Yes, you can. If you have a specific activity key, your agent can pull up all the details for that exact suggestion instantly.
What kind of categories does the Bored MCP cover?
It covers a wide range of interests, including social, educational, relaxation, and DIY projects, so you can find something regardless of your mood.
Can I find activities specifically for a large group of people?
Yes! You can use the find_activity capability 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 capability 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 capability and provide the unique numeric key to fetch the full details of that specific activity.
One connection away
Give your agent a direct line to Bored API.
Connect Bored API once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available