How to Use the Bored MCP in Claude

Q: How do I configure the Bored MCP Server in Claude Desktop?

Open your claudedesktopconfig.json file and add the server config under the mcpServers key. Once you restart the app, Claude Desktop will show the new tools in your chat input.

Stop staring at blank chat screens and let Claude Desktop find your next real-world project or distraction.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Bored MCP to Claude Desktop

Create your Vinkius account to connect Bored to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Bored with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Find things to do inside Claude Desktop

Staring at a blinking cursor in Claude Desktop gets old fast when you need a break. This MCP Server lets you query the Bored API directly inside your chat window using `find_activity` to filter by price or how many people are with you. You don't have to leave your workspace to figure out what to do next. Your agent handles the filtering and hands you a curated list of tasks instantly.

Pull random activities instantly

Sometimes you just want a random curveball thrown your way to break the monotony. By calling `get_random_activity`, your Claude Desktop client grabs an unexpected suggestion without making you browse mindless listicles. It takes one quick prompt to get a weird programming challenge or a physical task. The server returns the idea directly into your active thread so you can decide on the spot.

Save ideas by key

When Claude Desktop suggests something perfect but you can't do it right now, you need a way to reference it later. This is where `get_activity_by_key` comes in handy, letting your agent fetch that specific task whenever you're ready to start. Your brainstorming sessions stay organized this way. Instead of scrolling through miles of chat history, you just tell your agent to grab the exact ID you saved.

Setup guide

Set up Bored MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Bored MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Bored MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under bored-mcp.

json

{
  "mcpServers": {
    "bored-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Bored API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Bored now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Bored MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the server config under the `mcpServers` key. Once you restart the app, Claude Desktop will show the new tools in your chat input.

Yes, you can plug the Vinkius remote URL directly into your claude.ai integration settings. This lets you access the boredom-busting tools on any device without installing local files.

Yes, the Bored MCP Server works flawlessly on Windows. You just need to configure the path in your local configuration block and restart your client.

You can ask your agent to filter by price, participant count, accessibility, and specific categories like education or social.

Your privacy is fully protected. We only pass your temporary search parameters (like price or participant counts) to the API, and Vinkius destroys the sandbox session immediately after. No personal logs or search histories are ever saved.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript