# JokeAPI MCP for AI Agents AI Agent Connect > JokeAPI is an Connector that gives your AI agent a sense of humor. It pulls jokes from a huge database, letting you filter by category like Programming or Puns, and set safety flags to keep things appropriate. It's the easiest way to add lighthearted content to your AI interactions without hardcoding a list of jokes. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ehP8o1Phz9hwJYdsuOgZWj7sQawj2ZQgyomcsxHH/ai-agent-connect - **Tags:** rest-api, humor, content-generation, data-filtering, entertainment-services ## Description You want your AI to be more than just a dry information machine. Sometimes it needs to break the ice or keep a conversation from feeling like a lecture. This Connector gives your agent a direct line to a massive library of humor. It handles the heavy lifting of finding the right joke for the right moment. You can tell your agent to grab something funny for a dev team, or ask for a seasonal joke for a social media post. It even handles the "don't show this" stuff, so you don't have to worry about your bot saying something offensive or political. Because Vinkius manages the connection, you just plug it in and start chatting. It turns your agent into a comedian that knows when to be punny and when to stay professional. You get variety and safety in one simple connection. Instead of manually searching for jokes or worrying about what might be inappropriate for your specific audience, you let the agent do the work. It pulls from a wide range of categories like programming, puns, and holiday themes. It's a simple way to inject personality into your AI interactions without having to manage a database of jokes yourself. This means you can focus on your core project while your agent handles the variety of humor content. ## Tools ### list_joke_categories This tool lets your agent see all the joke categories available. It's useful for helping your AI understand what types of humor it can pull for your users. ### get_joke Use this to pull a single random joke for an AI interaction. It's a great way to provide a quick laugh or a lighthearted icebreaker. ### list_jokes This tool fetches multiple jokes at once from the database. It works well for populating a list of humor content or finding several options quickly. ## Prompt Examples **Prompt:** ``` Tell me a programming joke. ``` **Response:** ``` Sure! Why do programmers always mix up Halloween and Christmas? Because Oct 31 equals Dec 25! Want to hear another one? ``` **Prompt:** ``` Give me 3 safe jokes from the 'Misc' category. ``` **Response:** ``` Retrieving 3 safe miscellaneous jokes... Here is the first one: 'I'm reading a book on anti-gravity. It's impossible to put down!' Ready for the others? ``` **Prompt:** ``` Do you have any 'Spooky' jokes for Halloween? ``` **Response:** ``` Fetching a spooky joke... 'Why don't ghosts like rain? Because it damps their spirits!' I can find more themed jokes if you're planning a party. ``` ## Capabilities ### Fetch a single joke Pull one random joke from the database for a quick interaction. ### Pull multiple jokes Get a batch of jokes at once to populate lists or find several options. ### Browse humor categories See all available joke types like Puns, Spooky, or Programming. ### Filter by language Access jokes in English, German, and Portuguese. ### Block offensive content Use safety flags to filter out NSFW, religious, or political jokes. ### Identify humor themes Summarize joke trends to find the best comedic structures for your needs. ## Use Cases ### Adding a comedy layer to a Slack bot A developer wants their bot to be more friendly. The agent uses `get_joke` to find a programming pun when a user finishes a task. ### Finding holiday content for social media A manager needs a laugh for a Halloween post. The agent pulls Spooky jokes to give them a few options to choose from. ### Populating a game's comedy club A game dev needs a list of jokes for a level. The agent uses `list_jokes` to grab a batch of content in one go. ### Checking available humor types A user wants to see what's available. The agent calls `list_joke_categories` to show the different themes like Puns and Misc. ## Benefits - Save time on content creation by letting your agent pull jokes automatically using `get_joke`. - Keep your brand safe by using safety flags to block offensive or religious content. - Support diverse audiences by requesting jokes in languages like German or Portuguese. - Build better engagement for bots by pulling themed content like Spooky or Christmas jokes. - Reduce manual data entry by using `list_jokes` to populate your content feeds. - Explore new humor styles by checking available categories with `list_joke_categories`. ## How It Works The bottom line is you get instant, filtered humor for any AI interaction. 1. Subscribe to the JokeAPI MCP on Vinkius. 2. Connect the Connector to your preferred AI client. 3. Ask your agent for a joke or a list of jokes. ## Frequently Asked Questions **Can JokeAPI MCP provide jokes for my business bot?** Yes, it's perfect for making a bot feel more human. You can use it to provide lighthearted icebreakers or seasonal humor. **How do I make sure the jokes are safe for work?** You can use the safety flags to block offensive, religious, or political content. This ensures your AI stays professional. **Does JokeAPI MCP support multiple languages?** Yes, it includes support for English, German, and Portuguese, making it useful for diverse audiences. **Can I get a bunch of jokes at once?** Yes, you can pull a list of multiple jokes at once. This is great for populating a content feed or a list of options. **Is there a cost to using JokeAPI MCP?** No, this is a public access tool. You can start getting jokes immediately after connecting it to your client. **What categories of humor are available?** It covers a wide range of categories including Programming, Puns, Spooky, Christmas, and Misc humor. **Can I get 5 jokes specifically about programming?** Yes! Use the `list_jokes` tool and set the `category` to 'Programming' and `amount` to 5. It will return a set of developer-themed jokes. **How do I filter out offensive jokes?** You can use the `blacklistFlags` parameter in the tools. Specify 'nsfw,religious,political,racist,sexist,explicit' to ensure only safe jokes are returned. **What languages are supported for jokes?** JokeAPI supports multiple languages including English (en), German (de), Spanish (es), French (fr), and Portuguese (pt). Use the `lang` parameter to specify your choice.