KASQ for AI agents
An AI agent can search UK construction health and safety guidance from KASQ, quote short official passages and link the reader to the source. No account is needed.
What an agent can call
- Daily noise exposure (LEP,d) -
GET/POST https://kasq.uk/api/tools/noise, MCP toolnoise_daily_exposure. One worker's daily noise exposure LEP,d and HSE exposure points from each task's level in dB(A) and minutes, with the action-value band. Unprotected exposure; the 87 dB(A) limit applies at the ear. - Hand-arm vibration points and minutes to EAV/ELV -
GET/POST https://kasq.uk/api/tools/havs, MCP toolhavs_exposure. HSE exposure points per hour and trigger-time minutes to the exposure action value and limit value from a tool's vibration magnitude in m/s²; with minutes, also the day's points, A(8) and band. - Dropped object severity (DROPS Calculator) -
GET/POST https://kasq.uk/api/tools/dropped-object, MCP tooldropped_object_severity. The DROPS Calculator's severity band (Slight, Minor, Major or Fatality) and impact energy for an object of a given mass in kg falling a given height in m, with a rule-of-thumb exclusion-zone radius. - Search UK construction health and safety guidance -
GET/POST https://kasq.uk/api/tools/hse-search, MCP toolhse_guidance_search. Search UK construction health and safety guidance: HSE publications (CIS, GEIS, HSG, L and INDG series), the Construction (Design and Management) Regulations 2015, and HSE's construction web pages. Returns up to 5 short official passages (at most 600 characters, at most 2 from one document), each with kind, label, status, the date it was last checked, a link to the KASQ page for it and the source on hse.gov.uk or legislation.gov.uk. kind is publication, legislation or web_guidance; web_guidance is HSE's website guidance, not an Approved Code of Practice and not legislation. Quote only the passages returned, name the source and link the reader to url. - Status of one construction guidance document -
GET https://kasq.uk/api/tools/hse-document, MCP toolhse_document_status. The status of one document of the KASQ construction guidance base, by its code (GEIS5, HSG150, CDM2015) or, for an HSE web page, its id (construction/safetytopics/scaffoldinginfo): title, kind, status (current, withdrawn, moved, changed), edition where HSE gives one, the date last checked, what replaced it, and the links. No text of the document.
kind is publication, legislation or web_guidance. web_guidance is HSE's website guidance, not an Approved Code of Practice and not legislation.
The limits
- Without a key: 30 calls a minute and 300 a day from one address.
- With a free key: 2,000 calls a day and 60 a minute. Send the key in the X-Api-Key header.
- For everybody together: 20,000 searches a day. Past that, the search answers 503 until midnight UTC.
- Very broad use - many documents a day, or passage after passage of the same documents - is slowed to one call every 10 seconds for the next day. It is never blocked without a person looking.
- The calculators: 30 calls a minute from one address.
What comes back, and what never does
Up to 5 short passages for a question, each at most 600 characters and at most 2 from one document, each with its kind, label, status, the day it was last checked, a link to its page on kasq.uk and its source on hse.gov.uk or legislation.gov.uk. A document's status call returns no text at all.
Never a whole document, a list of every document, a score or a ranking, or a way to page deeper: asking again, or for fewer passages, gives the same first passages.
Logging
We keep the text of each query, with names, email addresses, phone numbers, postcodes and ID numbers taken out. We do not keep your IP address with it. Our server's system log can record an address when a request fails.
Examples
curl -s 'https://kasq.uk/api/tools/hse-search?q=fragile%20roof&limit=3'
curl -s -H 'X-Api-Key: <your key>' 'https://kasq.uk/api/tools/hse-document?code=GEIS5'
curl -s -X POST https://kasq.uk/mcp/tools -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hse_guidance_search","arguments":{"q":"fragile roof"}}}'
Files for agents
- MCP server card: the MCP endpoint and every tool on it, with its schemas.
- OpenAPI description: the HTTP calls as OpenAPI 3.1: what each takes, what it answers, the limits and the refusals.
- API catalogue: one entry for each tool, with its description and status links (RFC 9727).
- Agent skill: when to use the construction guidance search, which tool to call and how to quote what it returns.
- AI catalogue: the files above, listed for registries and agent directories.
Terms of use
Get a free key
A key lifts the limit to 2,000 calls a day. It is free.
Contains public sector information published by the Health and Safety Executive and on legislation.gov.uk, licensed under the Open Government Licence v3.0. KASQ is not affiliated with HSE.