Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use JokeAPI with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Access thousands of jokes. audit categories and flags via AI.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 5 capabilities

The complete JokeAPI capability set.

These are the exact actions your AI can choose when you ask it to work with JokeAPI.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 5 available through JokeAPI.

  1. 01

    Get jokes by category

    Get jokes from a specific category (e.g., Programming, Misc, Pun)

  2. 02

    List joke categories

    List all available joke categories in the database

  3. 03

    List joke blacklist flags

    List all available flags for blacklisting content (e.g., nsfw, religious)

Capability set02 / 02

04-05

2 capabilities in this set.

Part of 5 available through JokeAPI.

  1. 04

    Check API status

    Check if the JokeAPI service is operational

  2. 05

    Get random joke

    Get a random joke from any category

Observed, not estimated

803ms average. Fast in production.

JokeAPI is checked daily against the live service.

Daily averagePeak 1083ms
Aug 20Today
Fastest day
677ms
Slowest day
1083ms
14-day trend
Slowing+15%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 5 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of JokeAPI, so you can see the experience inside your AI.

It does not authenticate your account with JokeAPI. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

JokeAPI Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — JokeAPI capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "jokeapi-alternative-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_h1tEezRS9ArL2V9PfYSlEZ8sqYIKOw4xmd6oHGZd/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions JokeAPI owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Productivity

Suggestions