Integration

Humor API integration

Humor API serves over 50,000 jokes in 27 categories and over 450,000 memes. Search jokes by keyword, category, rating and length or draw a random one, search or draw memes by keyword, media type, rating and age, generate a new joke on a topic with a language model, tag a joke you supply, search reaction GIFs, generate a praise or a playful insult for a name, rate how funny a word is and invent nonsense words. Joke categories include offensive ones (nsfw, racist, sexist, dark) that the exclude-tags parameter leaves out; memes have no such filter. Votes and joke submissions are recorded on the shared Humor API database. Each call spends 1 point of the plan's daily quota, and the free plan answers HTTP 402 once the day's quota is used. Authentication is an API key from the Humor API console, sent as the api-key query parameter.

Connect Humor API How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Humor API.Built from the 16 Humor API tools below, on the connection you add once.

Common Humor API use cases

Write a custom joke for a newsletter topic
Add a topical joke to a chatbot reply

What you can do with Humor API

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Random, 3 operations

generate_nonsense_wordGenerate nonsense wordGETGenerates a random funny-sounding nonsense word and returns it with its funniness rating from 0 to 1. Costs 1 point.
get_random_jokeGet random jokeGETReturns one random joke, optionally restricted by included or excluded categories, minimum rating and maximum length. To keep offensive categories out, pass exclude-tags (for example nsfw,racist,sexist,dark). Costs 1 point.
get_random_memeGet random memeGETReturns one random meme with its file URL and MIME type, optionally matching words (also inside the image), a media type, a minimum rating and a maximum age. Memes have no offensive-content filter. Costs 1 point.

Search, 3 operations

search_gifsSearch gifsGETSearches reaction GIFs by a free-text query and returns up to 10 of them with their file URL, width and height. Costs 1 point.
search_jokesSearch jokesGETSearches over 50,000 jokes by words, categories, minimum rating and maximum length. Returns up to 10 jokes with their ids and the total match count. Set exclude-tags (for example nsfw,racist,sexist) to keep offensive jokes out. Costs 1 point.
search_memesSearch memesGETSearches over 450,000 memes by words (optionally only words inside the image), media type, minimum rating and age. Returns up to 10 memes with file URL and type, plus the total match count. Memes have no offensive-content filter. Costs 1 point.

Downvote, 2 operations

downvote_jokeDownvote jokePOSTRecords a downvote on the shared Humor API database for a joke you or your users do not like. Takes the joke id from search_jokes or get_random_joke. Costs 1 point.
downvote_memeDownvote memePOSTRecords a downvote on the shared Humor API database for a meme you or your users do not like. Takes the meme id from search_memes or get_random_meme. Costs 1 point.

Joke, 2 operations

generate_jokeGenerate jokeGETGenerates a new joke about one or more topics with a large language model and returns its text. The answer carries no id, so the joke cannot be voted on. Costs 1 point.
submit_jokeSubmit jokePOSTSubmits a new joke, as text, to the shared Humor API database, where Humor API evaluates it. Returns the joke as stored, with its id and the categories assigned to it. Costs 1 point.

Upvote, 2 operations

upvote_jokeUpvote jokePOSTRecords an upvote on the shared Humor API database for a joke you or your users like. Takes the joke id from search_jokes or get_random_joke. Costs 1 point.
upvote_memeUpvote memePOSTRecords an upvote on the shared Humor API database for a meme you or your users like. Takes the meme id from search_memes or get_random_meme. Costs 1 point.

Analyze, 1 operation

analyze_jokeAnalyze jokePOSTReads a joke you supply as text and returns it with the categories Humor API detects in it (for example ANIMAL). Nothing is stored. Costs 1 point.

Insult, 1 operation

generate_insultGenerate insultGETGenerates a short, playful insult addressed to the named person for the given reason, for example 'Holy moley, you dropped the ball Alex, you dingbat.' Costs 1 point.

Praise, 1 operation

generate_praiseGenerate praiseGETGenerates a short, funny sentence praising the named person for the given reason, for example 'Bravo Alex, you mastermind, you did it again.' Costs 1 point.

Rate, 1 operation

rate_wordRate wordGETRates how funny a word sounds, real or invented, on a scale from 0 (not funny) to 1 (super funny), using a model trained on human ratings. Costs 1 point.

Use Humor API from Claude Code, Cursor or Codex

Connect Humor API in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Humor API operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Humor API

Create your workspace
Sign up free. Nothing to install.
Connect Humor API once
Add your Humor API connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Humor API integration FAQ

What can you do with the Humor API integration?

LiveContext exposes 16 operations on Humor API, covering random, search, downvote and joke. Common uses include Write a custom joke for a newsletter topic and Add a topical joke to a chatbot reply.