`get_joke_categories`

Pack: jokes · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_joke_categories for the schema, then POST the same URL with its arguments for the data.

The joke categories available to filter by, from the JokeAPI database.

Tool description as the model sees it

List all available JokeAPI joke categories (e.g., Programming, Misc, Dark, Pun, Spooky, Christmas). Use the returned category names as the category input to get_joke or search_jokes.

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/jokes/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_joke_categories","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_joke_categories', {});

Response shape

Always returns: categories

Field	Type	Description
`categories`	array	Available joke categories

Full JSON Schema

{
  "type": "object",
  "properties": {
    "categories": {
      "type": "array",
      "description": "Available joke categories",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "categories"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the jokes pack

{
  "mcpServers": {
    "jokes": {
      "url": "https://gateway.pipeworx.io/jokes/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_joke_categories