`search_jokes`

Pack: chucknorris · Endpoint: https://gateway.pipeworx.io/chucknorris/mcp

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

Search Chuck Norris jokes by keyword. Returns matching jokes with text and IDs.

Parameters

Name	Type	Required	Description
`query`	string	yes	Keyword or phrase to search for within joke text.

Example call

Arguments

{
  "query": "karate"
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_jokes', {
  "query": "karate"
});

More examples

{
  "query": "roundhouse kick"
}

Response shape

Always returns: total, query, jokes

Field	Type	Description
`total`	number	Total number of matching jokes
`query`	string	The search query used
`jokes`	array	Array of matching jokes

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "number",
      "description": "Total number of matching jokes"
    },
    "query": {
      "type": "string",
      "description": "The search query used"
    },
    "jokes": {
      "type": "array",
      "description": "Array of matching jokes",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique joke identifier"
          },
          "joke": {
            "type": "string",
            "description": "The joke text"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "List of categories"
          },
          "url": {
            "type": "string",
            "description": "URL to the joke on chucknorris.io"
          }
        },
        "required": [
          "id",
          "joke",
          "categories",
          "url"
        ]
      }
    }
  },
  "required": [
    "total",
    "query",
    "jokes"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

search_jokes