Install Jentic One Beta

Connect the Humor API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Humor API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fhumorapi.com%2Fhumorapi" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fhumorapi.com%2Fhumorapi" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Humor API.

Search for jokes or return a random joke

Search memes or return a random meme

Search gifs by keyword

Create a new joke or analyze an existing one

Generate an insult or a praise line

GET STARTED

Start building with Humor API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Humor API for, with concrete tasks.

★ Agent-Generated Humor in Conversations

A chat or social agent drops a joke, meme, or gif into a conversation to keep it light. The Humor API returns random or keyword-matched jokes, memes, and gifs, so an agent can pull relevant humorous content on demand through Jentic rather than shipping a static list.

Search for a meme matching a keyword and return its image URL

Playful Insult and Praise Generation

A game or bot needs a lighthearted insult or a compliment on demand. The Humor API generates an insult or praise line, optionally personalized with a name, so an agent can produce a one-off quip without a content library.

Generate a playful insult addressed to a given name

Joke Analysis and Curation

A content tool wants to vet or classify jokes before posting them. The Humor API analyzes a joke and rates word funniness, so an agent can screen submitted jokes and keep the funniest ones.

Analyze a submitted joke and return its rating and detected type

Key Endpoints

16 endpoints — the humor api searches and generates humorous content, covering jokes, memes, and gifs.

METHOD

PATH

DESCRIPTION

GET

/jokes/random

Get a random joke

GET

/jokes/search

Search jokes

POST

/jokes/analyze

Analyze a joke

GET

/memes/search

Search memes

GET

/gif/search

Search gifs

GET

/insult

Generate an insult

GET

/praise

Generate praise

GET

/words/rate

Rate a word's funniness

GET

/jokes/random

Get a random joke

GET

/jokes/search

Search jokes

POST

/jokes/analyze

Analyze a joke

GET

/memes/search

Search memes

GET

/gif/search

Search gifs

GET

/insult

Generate an insult

GET

/praise

Generate praise

GET

/words/rate

Rate a word's funniness

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Humor API by hand means appending your api-key to every request as a query parameter and mapping its search, generation, and voting endpoints yourself. Through Jentic you install once, import the Humor API from the Directory, store the key once, and your agent calls it.

Permission scoping

The Humor API carries the key in the query string rather than a resource path, so rules govern which operations your agent may call, not which content. You choose those operations, so you can allow searching jokes and memes while leaving out submitting or voting on them.

Credential isolation

Your Humor API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'get a random joke' or 'search for memes', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint.

FAQs

Specific to using Humor API through Jentic.

What authentication does the Humor API use?

The Humor API authenticates with an API key passed as the 'api-key' query parameter, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected when your agent calls the API.

Is there a Humor API MCP server?

You don't need an MCP server to give your agent the Humor API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent searches jokes, memes, and gifs as it needs to. Nothing extra is loaded into the agent's context until a call is made.

Can I limit what my agent is allowed to do with the Humor API?

Yes. You choose which of the 16 operations your agent may call, so you can allow the search and random endpoints while leaving out the ones that submit or vote on content. Every call it makes is logged for review.

Can I generate a personalized insult with the Humor API?

Yes. The insult operation returns a playful insult and can take a name and a reason, so an agent can address the quip to a specific person.

How do I get a random joke through Jentic?

Search Jentic for 'get a random joke', which returns the random-joke operation with its input schema. Add the Humor API from the Jentic API Directory, store your api-key once, and your agent can pull jokes, memes, and gifs. To run it on your own infrastructure, install Jentic One from its GitHub repo.

Humor API

Name: Humor API
Brand: Humor API
Availability: InStock

Official vendor OpenAPI document · agent-readyMediaImage ProcessingAPI key (query parameter)16 EndpointsREST

For Agents

Search or generate jokes, memes, and gifs through the Humor API, plus create and analyze jokes, generate insults and praise, and rate word funniness.

Use for: Get a random joke, Search for memes about a topic, Find a gif matching a keyword, Generate a funny insult for a name

Not supported: Does not host user accounts or moderate submitted content beyond upvote and downvote counts. Use for searching and generating jokes, memes, gifs, and related humor content only.

The Humor API searches and generates humorous content, covering jokes, memes, and gifs. It can search or return random jokes and memes, search gifs, create and analyze jokes, generate insults and praise, rate how funny a word is, and produce nonsense words. Requests authenticate with an API key passed as the 'api-key' query parameter.

Jentic One on Github View OpenAPI Document