Jokes

live Fun

Random jokes, joke search, categories, and safe-mode filtering via JokeAPI

4 tools
0ms auth
free tier 50 calls/day

Tools

get_joke

Get a random joke by category

Parameters
Name Type Description
category opt string Category: Any, Programming, Misc, Dark, Pun, Spooky, Christmas
type opt string Type: single or twopart
safe_mode opt boolean Enable safe mode (default true)
▶ Try it
search_jokes required: query

Search jokes by keyword

Parameters
Name Type Description
query req string Keyword to search
category opt string Category filter
amount opt number Number of jokes (default 5)
▶ Try it
get_joke_categories

List all available joke categories

No parameters required.

▶ Try it
get_joke_flags

List all available joke flags/filters

No parameters required.

▶ Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/jokes/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/jokes/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_joke","arguments":{}}}'