• CONTENT
  • FILTERING
  • VARIETY
  • HUMAN

How to automate joke retrieval with your AI

Connect JokeAPI to your agent to fetch content instantly. Once connected, your AI handles the searching and filtering for you.

Ask AI about this page

Short answer

How can I get my AI to find jokes for me?

Your AI uses JokeAPI to browse available categories or pull specific jokes based on your instructions. You get direct access to the joke text without leaving your chat interface.

The results

What you get from this connection

The AI handles the data fetching so you can focus on the output.

CONTENT

Instant joke delivery

The AI pulls raw joke data directly from the API. You receive the text immediately in your chat window.

FILTERING

Category-specific results

Your agent can narrow down jokes by type or topic. This ensures the content matches the tone you need.

VARIETY

Randomized selection

You can ask for a single random joke or a list of different ones. The AI manages the randomness for you.

HUMAN

Manual review required

The AI fetches the text, but you decide if a joke is actually funny or appropriate for your specific use case.

The workflow

What your AI does when you ask for a joke.

The agent moves from exploring the API to delivering the specific content you requested.

  1. Explore categories

    The AI checks what types of jokes are available to ensure it can meet your request.

    list_joke_categories

  2. Target a topic

    Once it knows the categories, the AI selects the specific group you asked for.

    get_jokes_by_category

  3. Fetch a single joke

    If you just want something quick, the AI grabs one random entry from the database.

    get_random_joke

  4. Present the joke

    The AI formats the joke text and presents it to you in the chat.

    get_random_joke

Try it

Copy these to start.

Use these prompts to trigger the JokeAPI tools immediately.

Starting points

Swap out the category names or joke types to get different results.

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"
    }
  }
}
Copy into chat04

  • List all the available joke categories.

  • Give me a random joke from the Programming category.

  • Find me a joke from the Pun category.

  • Just give me one random joke to start my day.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect JokeAPI once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted, and you can start asking for jokes right away.

Connect JokeAPI to your AI

FAQ

How the joke retrieval works

  • 01

    Can the AI create its own jokes?

    No. The AI only retrieves existing jokes from the JokeAPI database.

  • 02

    Can I filter jokes by difficulty?

    No. The tools only support filtering by the categories provided by the API.

  • 03

    Does the AI save the jokes it finds?

    No. The AI fetches the joke for your current session; it doesn't store them in a permanent database.

  • 04

    Can the AI delete jokes from the API?

    No. The tools are read-only. The AI can only fetch data, not modify the source.

  • 05

    Can I get multiple jokes at once?

    Yes, you can ask the AI to pull several jokes by requesting them one after another or by specifying a category.

  • More questions about JokeAPI? The Connector page answers them. See everything the JokeAPI Connector can do

Connect JokeAPI to Claude, Cursor, ChatGPT & more