# JokeAPI MCP for AI Agents AI Agent Connect

> JokeAPI lets your AI agent pull thousands of jokes and audit content categories or blacklist flags. It is built for anyone needing to fetch humor data into an app or conduct research on how jokes are structured across different languages and themes without manual searching.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/ai-agent-connect
- **Tags:** rest-api, humor, content-curation, api-testing, entertainment-data

## Description

If you are trying to build an app that needs a steady stream of humor, or if you are doing research on how jokes are structured across different cultures, you are usually stuck manually scraping websites or copy-pasting from messy databases. This Connector changes that by letting your agent handle the heavy lifting of finding and filtering content for you. Instead of hunting for a specific type of pun or checking if a joke is safe for a general audience, you just tell your agent what you need. It pulls the data, checks the categories, and makes sure the content fits your specific rules. You can quickly see what is available, from programming jokes to holiday-specific humor, and ensure you are staying within your content guidelines. It is a massive time saver for content teams who need to keep their feeds fresh and relevant. You will find this in the Vinkius catalog alongside other tools that help bridge the gap between your AI and raw data sources. It turns a tedious research task into a quick conversation with your agent.

## Tools

### check_api_status
Check if the JokeAPI service is currently up. Use this to confirm the connection is active.

### get_jokes_by_category
Get jokes from a specific category like Programming or Pun. This helps you find targeted humor quickly.

### list_joke_categories
See every joke category available in the database. This helps you understand the scope of the humor data.

### list_joke_blacklist_flags
View all available flags for blacklisting content. Use this to ensure your agent follows your safety rules.

### get_random_joke
Pull a random joke from any category in the database. Use this for variety in your content.

## Prompt Examples

**Prompt:** 
```
Give me a random programming joke.
```

**Response:** 
```
I've grabbed a programming joke for you:

**Setup:** Why did the developer go broke?
**Delivery:** Because he used up all his cache.

Would you like another one or should we try a different category like 'Pun'?
```

**Prompt:** 
```
What joke categories are available?
```

**Response:** 
```
I've checked the database. Here are the categories you can choose from:

*   Programming
*   Misc
*   Dark
*   Pun
*   Spooky
*   Christmas

Which one would you like to explore?
```

**Prompt:** 
```
What filters can I use to keep the jokes safe for kids?
```

**Response:** 
```
I've retrieved the blacklist flags for you. You can filter out content marked as:

*   nsfw
*   religious
*   political
*   racist
*   sexist
*   explicit

I can help you audit the jokes to make sure they avoid these markers.
```

## Capabilities

### Pull jokes by category
Get specific themes like puns or programming jokes instantly.

### Grab random jokes
Get a surprise joke from any available category in the database.

### Browse joke categories
See the full list of available themes to understand the scope of the humor data.

### Check content filters
View all available blacklist flags to ensure your agent follows your safety rules.

### Monitor service status
See if the joke database is currently online before starting a task.

## Use Cases

### Newsletter Content Generation
A content writer asks their agent to find 10 programming jokes for a newsletter. The agent uses get_jokes_by_category to pull them instantly.

### Safety Audit for Kids App
A developer wants to ensure no religious or NSFW content is shown. The agent uses list_joke_blacklist_flags to verify the safety markers.

### Humor Theme Discovery
A researcher wants to see what types of jokes are available. The agent uses list_joke_categories to provide a full list of themes.

### Dynamic Feed Variety
An app needs a random joke for a daily notification. The agent uses get_random_joke to fetch a new one every time.

## Benefits

- Stop manual scraping because you can pull jokes directly into your workflow using get_jokes_by_category.
- Maintain strict brand safety by checking all available filters with list_joke_blacklist_flags.
- Speed up content creation by grabbing variety with get_random_joke instead of searching.
- Understand the scope of your data by browsing all themes with list_joke_categories.
- Ensure your automation stays active by monitoring the connection with check_api_status.

## How It Works

The bottom line is your agent gets instant access to a structured database of jokes without you having to visit a single website.

1. Subscribe to the JokeAPI MCP on Vinkius.
2. Connect it to your preferred AI client like Claude or Cursor.
3. Ask your agent to fetch jokes or audit content categories.

## Frequently Asked Questions

**Can JokeAPI help me find jokes for my app?**
Yes, JokeAPI lets your agent pull jokes directly into your project. It is great for building entertainment apps that need a steady supply of humor content without manual data entry.

**How do I make sure the jokes are safe for my audience?**
You can use JokeAPI to see all available content filters. Your agent can check the blacklist flags to ensure the jokes you are pulling do not include themes like NSFW or political content.

**Can I get jokes in different categories?**
Definitely. You can ask your agent to pull jokes from specific categories like 'Programming', 'Pun', or 'Spooky' using JokeAPI.

**Is JokeAPI good for linguistic research?**
Yes, it is a great tool for researchers. You can use it to audit different joke categories and see how humor is structured across various themes and styles.

**Does JokeAPI require a paid subscription?**
No, JokeAPI is a free service. You can connect it to your AI client via Vinkius and start pulling data immediately without managing any API keys.

**Can my agent find random jokes for me?**
Yes, your agent can pull a completely random joke from any available category whenever you need a quick bit of humor.

**Is an API Key required for JokeAPI?**
No. JokeAPI is a free and open service. This server works out of the box without any static credentials required.

**Can I filter jokes by language?**
Yes. Use the `getRandomJoke` tool and provide the `lang` parameter (e.g., 'en' or 'de'). Your agent will return matching jokes instantly.

**Does it support setup/delivery format?**
Yes. JokeAPI provides both single-line and two-part (setup and delivery) jokes. Your agent will display them in the appropriate Markdown format.