`hk_food_alerts_search`

Pack: hk-food-alerts · 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/hk_food_alerts_search for the schema, then POST the same URL with its arguments for the data.

Search Hong Kong’s Centre for Food Safety food alerts and allergy alerts (products the CFS tells the public not to consume: Listeria, Salmonella, veterinary drug residues, aflatoxins, heavy metals, undeclared allergens, labelling breaches; newest first, 2006 onwards). Each hit gives the alert id, date, type (food alert or allergy alert), title and link. Filter by a keyword in the title (a food, hazard or origin such as cheese, Listeria, formula), alert_type, year, or a date window of up to three years; zero matches states which years were read. Example: query=“cheese”, year=2026. For the importer, reason, action taken and advice use hk_food_alert_get.

Parameters

Name	Type	Required	Description
`query`	string	no	Word in the alert title: a food, hazard or origin (e.g. “cheese”, “Listeria”, “formula”, “shrimp”). Optional.
`alert_type`	string	no	food, allergy or all (default all; types are recorded from 2021).
`year`	number	no	Calendar year to read, 2006 onwards (default: the current list).
`date_from`	string	no	Only alerts on or after this ISO date (YYYY-MM-DD); reads the years in the window.
`date_to`	string	no	Only alerts on or before this ISO date (YYYY-MM-DD).
`limit`	number	no	Alerts to return (1-100, default 20).

Example call

Arguments

{
  "query": "cheese",
  "year": 2026
}

curl

curl -X POST https://gateway.pipeworx.io/hk-food-alerts/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hk_food_alerts_search","arguments":{"query":"cheese","year":2026}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('hk_food_alerts_search', {
  "query": "cheese",
  "year": 2026
});

Response shape

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

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string"
        },
        "alert_type": {
          "type": "string"
        },
        "year": {
          "type": "number"
        },
        "date_from": {
          "type": "null"
        },
        "date_to": {
          "type": "null"
        }
      },
      "additionalProperties": true
    },
    "found": {
      "type": "boolean"
    },
    "total_matching": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "alerts": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "alert_date": {
            "type": "string"
          },
          "alert_type": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "alert_url": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    },
    "searched": {
      "type": "object",
      "properties": {
        "list": {
          "type": "string"
        },
        "years_read": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "alerts_scanned": {
          "type": "number"
        },
        "scanned_first": {
          "type": "string"
        },
        "scanned_last": {
          "type": "string"
        },
        "limit": {
          "type": "number"
        }
      },
      "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 hk-food-alerts pack

{
  "mcpServers": {
    "hk-food-alerts": {
      "url": "https://gateway.pipeworx.io/hk-food-alerts/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

hk_food_alerts_search