za_law_get
Pack: south-africa-law · 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/za_law_get for the schema, then POST the same URL with its arguments for the data.
Fetch one South African Act by id from za_law_search (e.g. “acts/expropriation-act-13-2024-english-sepedi-24-jan-2025”). Returns title, Act number and year, the Government’s summary of what the Act does, the commencement statement where the page gives one, the gazetted PDF link(s) and, when the PDF has a readable text layer, the text (capped at max_chars; use offset to read on). The site states no in-force flag, so status is null. Recent gazette PDFs often lose letters in text extraction; when that is detected the text is withheld with an empty_reason rather than returned corrupted, and the PDF link is the authoritative text.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | Id from za_law_search, e.g. “acts/expropriation-act-13-2024-english-sepedi-24-jan-2025” |
max_chars | number | no | Cap on returned text (default 20000, max 100000) |
offset | number | no | Character offset into the text, to read on after a capped result |
Example call
Arguments
{
"id": "abolition-racially-based-land-measures-act",
"max_chars": 3000
}
curl
curl -X POST https://gateway.pipeworx.io/south-africa-law/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"za_law_get","arguments":{"id":"abolition-racially-based-land-measures-act","max_chars":3000}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('za_law_get', {
"id": "abolition-racially-based-land-measures-act",
"max_chars": 3000
});
Response shape
| Field | Type | Description |
|---|---|---|
found | boolean | |
id | string | |
title | string | |
citation | string | |
status | null | |
note | string | |
commencement | string | |
summary | string | |
pdf_urls | array | |
url | string | |
source | string | |
data_as_of | string | |
text | string | |
offset | number | |
total_chars | number | |
truncated | boolean | |
pages | number | |
text_note | string | |
hint | string |
Full JSON Schema
{
"type": "object",
"properties": {
"found": {
"type": "boolean"
},
"id": {
"type": "string"
},
"title": {
"type": "string"
},
"citation": {
"type": "string"
},
"status": {
"type": "null"
},
"note": {
"type": "string"
},
"commencement": {
"type": "string"
},
"summary": {
"type": "string"
},
"pdf_urls": {
"type": "array",
"items": {
"type": "string"
}
},
"url": {
"type": "string"
},
"source": {
"type": "string"
},
"data_as_of": {
"type": "string"
},
"text": {
"type": "string"
},
"offset": {
"type": "number"
},
"total_chars": {
"type": "number"
},
"truncated": {
"type": "boolean"
},
"pages": {
"type": "number"
},
"text_note": {
"type": "string"
},
"hint": {
"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 south-africa-law pack
{
"mcpServers": {
"south-africa-law": {
"url": "https://gateway.pipeworx.io/south-africa-law/mcp"
}
}
}
See Getting Started for client-specific install steps.