`nz_recalls_search`

Pack: nz-recalls · 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/nz_recalls_search for the schema, then POST the same URL with its arguments for the data.

Search New Zealand’s government product recalls register (MBIE Product Safety; about 1,600 recalls of children’s toys, baby products, appliances, electric and gas products, vehicles, cosmetics, tools, sports gear, building products and more), 12 per page, newest first. Each hit gives the recall id, title, recall date, product categories and link. Filter by keyword (a product, brand or retailer such as lamp, Mitre 10, battery), category and sort order; page through with page. total_matching counts the whole filtered register; zero matches states what was searched. Example: query=“lamp”, category=“toys”. For the hazard, remedy, barcodes and supplier use nz_recall_get.

Parameters

Name	Type	Required	Description
`query`	string	no	Keyword: product, brand or retailer (e.g. “lamp”, “button battery”, “Mitre 10”). Optional.
`category`	string	no	One of: ${Object.keys(CATEGORIES).join(’, ’)}.
`sort`	string	no	latest (default), oldest, az or za.
`page`	number	no	Page number, 1 is the first (12 recalls per page).

Example call

Arguments

{
  "query": "lamp",
  "category": "toys"
}

curl

curl -X POST https://gateway.pipeworx.io/nz-recalls/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"nz_recalls_search","arguments":{"query":"lamp","category":"toys"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('nz_recalls_search', {
  "query": "lamp",
  "category": "toys"
});

Response shape

Field	Type	Description
`query`	object
`found`	boolean
`total_matching`	number
`returned`	number
`page`	number
`page_size`	number
`recalls`	array
`searched`	object
`data_as_of`	string
`source`	string
`caveat`	string

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string"
        },
        "category": {
          "type": "string"
        },
        "sort": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "found": {
      "type": "boolean"
    },
    "total_matching": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "page": {
      "type": "number"
    },
    "page_size": {
      "type": "number"
    },
    "recalls": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "recall_date": {
            "type": "string"
          },
          "categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "recall_url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "searched": {
      "type": "object",
      "properties": {
        "list": {
          "type": "string"
        },
        "recall_date_first": {
          "type": "string"
        },
        "recall_date_last": {
          "type": "string"
        }
      },
      "additionalProperties": true
    },
    "data_as_of": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "caveat": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

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 nz-recalls pack

{
  "mcpServers": {
    "nz-recalls": {
      "url": "https://gateway.pipeworx.io/nz-recalls/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

nz_recalls_search