Jokes
live FunRandom 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
Response
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
Response
get_joke_categories List all available joke categories
No parameters required.
Try it
Response
get_joke_flags List all available joke flags/filters
No parameters required.
Try it
Response
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":{}}}'Use with the SDK
Install @pipeworx/sdk to call tools from any TypeScript/Node project.
TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_joke", {}); ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("random jokes, joke search, categories, and safe-mode filtering via jokeapi");Related packs
Other Pipeworx packs in the same categories (Fun):