JokeAPI MCP. Source jokes by category, safety flag, or language.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
JokeAPI MCP Server. Get random, categorized, or filtered jokes instantly through your AI agent. Need a quick laugh for a bot, or need to ensure content is safe (NSFW, political, etc.)? This server lets your AI client pull jokes based on categories like Programming, Pun, or Misc, and even supports multiple languages like German and Portuguese.
It's a universal humor engine for any conversation.
What your AI agents can do
Get joke
Retrieves one single, random joke.
List joke categories
Provides a list of all available joke categories.
List jokes
Retrieves a list of multiple jokes, allowing for batch content retrieval.
Your agent retrieves a single, random joke from the entire joke database.
Your agent fetches a list of all available joke categories so you know what topics are supported.
Your agent pulls a batch of multiple jokes, allowing you to source content for a list or a sequence of messages.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
019d844bget joke
Retrieves one single, random joke.
019d844blist joke categories
Provides a list of all available joke categories.
019d844blist jokes
Retrieves a list of multiple jokes, allowing for batch content retrieval.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with JokeAPI, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This server hooks your AI agent up to a massive joke database. It's your go-to source for humor, letting your agent pull random, categorized, or filtered jokes straight into the conversation. You don't gotta worry about the content; it handles the safety checks for stuff that's NSFW, political, or religious.
get_joke lets your agent pull one single, random joke from the whole pool.
list_joke_categories pulls a full list of every joke category available so you know what topics it covers.
list_jokes lets your agent pull a batch of multiple jokes, which is perfect if you need a list or a sequence of messages.
How JokeAPI MCP Works
- 1 First, subscribe to the JokeAPI server and connect it to your AI client (Claude, Cursor, etc.).
- 2 Next, prompt your agent with a specific request, like 'Give me a pun joke about space,' or 'List all joke categories.'
- 3 Finally, the server processes the request and returns the requested joke or list of jokes directly to your agent.
The bottom line is, your AI client gets a direct, structured connection to a massive joke database, bypassing the need for hardcoded joke lists.
Who Is JokeAPI MCP For?
This is for developers building content-driven apps or bot services. Think social media managers who need constant, fresh, lighthearted content; or bot developers building engaging, varied chat experiences. If your app needs humor—and you don't want to manually maintain a joke database—you need this.
Builds engaging chat flows by making the agent pull random or themed jokes on demand, ensuring the bot never runs out of content.
Sources lighthearted, engaging material for social media campaigns, using the JokeAPI to quickly generate batches of filtered, safe content.
Adds a repeatable, fun feature to a general-purpose application, allowing users to request a joke using natural conversation.
What Changes When You Connect
- Random Content: Don't worry about running out of jokes. Use
get_joketo instantly pull a single, fresh joke, perfect for quick conversation icebreakers. - Targeted Humor: Need a specific vibe? Use
list_joke_categoriesto see all topics, then filter jokes by 'Programming' or 'Pun' to keep your content focused. - Batch Content: Generating a list of jokes for a social media post?
list_jokeslets you pull multiple jokes at once, saving you time compared to calling the API repeatedly. - Safety First: Need to make sure the jokes are clean? The API filters out NSFW, political, and religious content, so you don't have to manually vet every punchline.
- Global Reach: Don't limit your audience. The server supports multiple languages, letting your agent deliver humor in German or Portuguese.
- Structured Data: The API allows summarizing multiple jokes, which helps you identify recurring themes or popular comedic structures across different content types.
Real-World Use Cases
Building a multilingual chat bot
A developer needs a chatbot that can greet users in different languages. Instead of writing separate code for each language, the agent uses the JokeAPI to fetch jokes in Portuguese or German, making the bot feel global and highly responsive.
Creating themed content for a party bot
A user wants a joke for a Halloween-themed event. They ask their agent for 'Spooky' jokes. The agent uses the JokeAPI to pull only 'Spooky' content, ensuring the joke fits the specific theme without pulling irrelevant material.
Vetting content for a corporate blog
A social media manager needs a batch of safe, general content for a blog post. They ask the agent to use list_jokes while applying safety flags, guaranteeing the content is appropriate for a professional audience.
Testing multiple content pipelines
An application developer needs to compare how different joke categories land with users. They use the agent to call list_joke_categories first, then iterate through multiple calls to list_jokes for 'Pun' and 'Programming' to gather comparison data.
The Tradeoffs
Assuming a single endpoint handles everything
Calling one generic endpoint and hoping it returns jokes of the right category and safety level. This usually results in mixed content and unreliable filtering.
→
You must use the dedicated tools. First, call list_joke_categories to confirm the exact topic name. Then, use list_jokes and specify the category and safety flags in the request parameters.
Hardcoding joke content
Writing out a dozen jokes directly into the application code. This is tedious, impossible to scale, and requires constant manual updates.
→
Let the JokeAPI do the heavy lifting. Use get_joke or list_jokes to pull content on the fly. You just write the prompt; the server handles the content.
Ignoring content safety flags
Asking the agent for a general joke without specifying that it must be safe for work. The agent might pull an offensive joke, failing the application's moderation rules.
→
Always specify your constraints. Use the content safety flags when calling list_jokes to filter out NSFW, political, or offensive material.
When It Fits, When It Doesn't
Use this server if your primary need is generating, filtering, or sourcing large volumes of structured, humorous content. It’s ideal for bot builders, content platforms, or any application that needs a fresh, varied punchline on demand. You need the structure of the joke domain—categories, languages, and safety flags—more than you need a fixed, predictable list of jokes.
Don't use this if you need something highly specific and non-joke related, like fetching user profile data or calculating financial metrics. For those tasks, you need a specialized data retrieval tool (e.g., a CRM or finance API). If you only need a single, random, basic joke with zero filtering, get_joke is fast, but list_jokes gives you far more control.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by JokeAPI. 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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 3 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually updating joke content for a bot is a nightmare.
If you're building a chatbot, you know the drill: you write a joke, you test it, you find it's terrible. You delete it. You write a new one, you test it, and then you realize the punchline doesn't land well in a different cultural context. You spend hours tweaking the content, and the moment you deploy, a user asks for something different, and you're stuck.
With the JokeAPI MCP Server, you never touch the content. You simply tell your agent what kind of humor you need—say, 'Give me a pun joke in German.' The server pulls the joke, filtered and ready to go. You write the logic; it handles the humor.
JokeAPI MCP Server: Get jokes, not just data.
Before this, if you wanted a joke for a themed event, you had to remember to manually check if the joke was safe for work, if it matched the theme, or if the language was right. You were managing three separate content checklists.
Now, your agent handles it all. You send a single request specifying the category, the safety flags, and the language. You get the joke. It's clean, it's themed, and it's ready to deliver.
Common Questions About JokeAPI MCP
How do I use the JokeAPI MCP Server to filter out offensive jokes? +
You filter content by specifying content safety flags when calling list_jokes. This prevents the agent from pulling jokes marked as NSFW, political, or religious.
Can I use JokeAPI MCP Server for jokes in languages other than English? +
Yes, the server supports multiple languages. You can request jokes in German, Portuguese, and others by specifying the target language in your prompt.
Is the JokeAPI MCP Server good for random content generation? +
Yes. Use get_joke if you just need one quick joke. If you need a list of jokes for a campaign, use list_jokes for better control over the batch content.
Do I need an API key for the JokeAPI MCP Server? +
No. The server has public access, meaning you don't need to manage or store an API key to get started.
How does the JokeAPI MCP Server handle content safety flags when I use the `get_joke` tool? +
It filters content based on specific flags. You can block jokes that are NSFW, political, or religious, ensuring only safe material reaches your agent.
What tools does the JokeAPI MCP Server provide for listing available joke categories? +
You use the list_joke_categories tool. This function provides a comprehensive list of available categories, like Programming, Pun, and Misc, so you know what to request next.
Can I use the JokeAPI MCP Server to get multiple jokes using the `list_jokes` tool? +
Yes, the list_jokes tool retrieves a batch of jokes. This lets your agent grab several jokes at once, which is useful for generating content or running content audits.
Is the JokeAPI MCP Server suitable for different types of creative content generation? +
Absolutely. Since it manages a large database of jokes, it works well for any application needing lighthearted, engaging content, from chatbots to social media feeds.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
WordPress Media Uploader
This MCP does exactly one thing: it downloads images from a URL and uploads them directly to your WordPress Media Library. Incredible for giving Claude the ability to generate and deploy blog cover images instantly.
Retable
Organize data in smart spreadsheets with relational views, team collaboration, and workflow automation that goes beyond basic tables.
Gravity Forms
Manage your WordPress Gravity Forms — list forms, retrieve entries, and handle submissions directly via AI.
You might also like
Everbridge Critical Management
Equip your AI agent to manage critical notifications, track incidents, and monitor contacts via the Everbridge API.
OpenAI
Use GPT-4o, DALL-E 3, embeddings, fine-tuning, and moderation as tools inside your AI agent workflows.
Keepcon
Automate content moderation and semantic analysis via Keepcon.