JokeAPI Connector for AI agents.
5 live capabilities
Pull and audit humor content for entertainment apps and research.
Waiting for input…
Why people use JokeAPI
JokeAPI Humor Research and Content Auditing
This Connector lets your agent do that work in seconds. It pulls the data, checks the categories, and filters out what you do not want, giving you a clean list of ready-to-use content instantly.
What Vinkius changes
Your agent gets instant access to a structured database of jokes without you having to visit a single website.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Newsletter Content Generation
A content writer asks their agent to find 10 programming jokes for a newsletter.
- Real-world use case 02
Safety Audit for Kids App
A developer wants to ensure no religious or NSFW content is shown.
- Real-world use case 03
Humor Theme Discovery
A researcher wants to see what types of jokes are available.
Complete set · 5capabilities
The complete JokeAPI capability set.
These are the exact actions your AI can choose when you ask it to work with JokeAPI.
01—03
3 capabilities in this set.
Part of 5 available through JokeAPI.
- 01 Capability
Check api status
Check if the JokeAPI service is currently up. Use this to confirm the connection is active.
- 02 Capability
Get jokes by category
Get jokes from a specific category like Programming or Pun. This helps you find targeted humor quickly.
- 03 Capability
List joke categories
See every joke category available in the database. This helps you understand the scope of the humor data.
04—05
2 capabilities in this set.
Part of 5 available through JokeAPI.
- 04 Capability
List joke blacklist flags
View all available flags for blacklisting content. Use this to ensure your agent follows your safety rules.
- 05 Capability
Get random joke
Pull a random joke from any category in the database. Use this for variety in your content.
Set up in minutes
One URL. Then ask JokeAPI to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use JokeAPI 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_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/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 JokeAPI, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable JokeAPI for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/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 JokeAPI URL.
- Step 03
Save and start
Save the connection and enable JokeAPI in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"jokeapi-alternative": {
"url": "https://edge.vinkius.com/vk_preview_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/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 JokeAPI
Open Agent mode in chat and ask: "Using JokeAPI, help me...". 5 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"jokeapi-alternative": {
"url": "https://edge.vinkius.com/vk_preview_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/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 JokeAPI
Ask Copilot: "Using JokeAPI, help me...". 5 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"jokeapi-alternative": {
"url": "https://edge.vinkius.com/vk_preview_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/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 JokeAPI
Open Cascade and ask: "Using JokeAPI, help me...". 5 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"jokeapi-alternative": {
"url": "https://edge.vinkius.com/vk_preview_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/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 JokeAPI
Ask Cline: "Using JokeAPI, help me...". 5 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add jokeapi-alternative --transport http "https://edge.vinkius.com/vk_preview_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/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 JokeAPI
Ask Claude: "Using JokeAPI, show me...". 5 tools are ready
Where the request belongs
Work JokeAPI can move forward.
Content creators who need fresh material, developers building entertainment apps, and linguists studying regional humor.
Content Manager
Finds and audits jokes for social media feeds to ensure they stay on-brand.
App Developer
Verifies joke availability and filters for an entertainment app backend.
Linguistic Researcher
Analyzes joke structures and categories across different languages.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsJokeAPI
Universal humor engine. get random jokes, filter by category and safety flags via AI.
Jokes API (API Ninjas)
Access random jokes. audit content and limits via AI.
GeekJoke
Get random geeky and programming-related jokes to lighten up your development workflow.
Chuck Norris
Access the legendary power of Chuck Norris facts. get random jokes, browse categories, and search the entire database directly from your AI agent.
Evil Insult
Generate creative and random insults from the Evil Insult Generator API directly within your AI agent.
YesNo
Get instant yes, no, or maybe decisions accompanied by fun GIFs to help your AI agent make choices or break ties.
Bring your own AI
Change the model, client or framework. Keep JokeAPI 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 JokeAPI.
The practical details behind the request, access and result.
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 capability 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 capability 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.
One connection away
Give your agent a direct line to JokeAPI.
Connect JokeAPI once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available