Search / za.co.aiagenttools/payroll
protogridR0· no sign-inSA payroll and labour rules: minimum wage, BCEA overtime, UIF, SDL, public holidays, leave
v1.0.0 · active · website · descriptor JSON · versions
{
"mcpServers": {
"payroll": {
"type": "http",
"url": "https://aiagenttools.co.za/payroll/mcp",
"headers": {
"Authorization": "Bearer ${PAYROLL_TOKEN}"
}
}
}
}claude mcp add --transport http payroll https://aiagenttools.co.za/payroll/mcp --header "Authorization: Bearer ${PAYROLL_TOKEN}"[mcp_servers.payroll]
url = "https://aiagenttools.co.za/payroll/mcp"
bearer_token_env_var = "PAYROLL_TOKEN"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"payroll": {
"type": "remote",
"url": "https://aiagenttools.co.za/payroll/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer {env:PAYROLL_TOKEN}"
}
}
}
}{
"mcpServers": {
"payroll": {
"type": "http",
"url": "https://aiagenttools.co.za/payroll/mcp",
"headers": {
"Authorization": "Bearer ${PAYROLL_TOKEN}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=payroll&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYWlhZ2VudHRvb2xzLmNvLnphL3BheXJvbGwvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UEFZUk9MTF9UT0tFTn0ifX0%3D"
}{
"servers": {
"payroll": {
"type": "http",
"url": "https://aiagenttools.co.za/payroll/mcp",
"headers": {
"Authorization": "Bearer ${PAYROLL_TOKEN}"
}
}
}
}{
"mcpServers": {
"payroll": {
"httpUrl": "https://aiagenttools.co.za/payroll/mcp",
"headers": {
"Authorization": "Bearer ${PAYROLL_TOKEN}"
}
}
}
}extensions:
"payroll":
enabled: true
name: "payroll"
type: streamable_http
uri: "https://aiagenttools.co.za/payroll/mcp"
headers:
"Authorization": "Bearer ${PAYROLL_TOKEN}"
timeout: 300
Placeholders to fill from your own secret store: ${PAYROLL_TOKEN}. The registry never accepts secret values.
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations7 of 7 tools declare readOnlyHint or destructiveHinttools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: unmet_request (destructiveHint, idempotentHint); minimum_wage_check (destructiveHint, idempotentHint); public_holidays (destructiveHint, idempotentHint); …tools.token_costabout 1,254 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changesno tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+dns-namespace +website +reachable +uptime-100% +updated-8d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://aiagenttools.co.za/payroll/mcp streamable-http | none | yes | 100% | 428 ms | 2025-11-25 | 2026-11-07 |
business_days_betweenread-only | Counts South African working days between two dates (inclusive), excluding weekends and public holidays. Optionally counts Saturdays as working days. Useful for notice periods, payment terms and delivery dates. |
leave_and_terminationread-only | Returns BCEA minimum leave (annual, sick, family responsibility), notice period and retrenchment severance pay for an employee, given days worked per week, start date and pay. |
minimum_wage_checkread-only | Checks whether an hourly, daily, weekly or monthly wage meets South Africa's National Minimum Wage on a given date (farm and domestic workers included). Returns the legal minimum, the shortfall and monthly equivalents. |
overtime_and_premium_payread-only | Calculates BCEA pay for a pay period: ordinary hours, weekday/Saturday overtime (1.5x), Sunday work (1.5x if ordinarily worked, else 2x), and public holiday work (s18). Flags breaches of overtime limits and checks the BCEA earnings threshold (employees above it have no statutory overtime entitlement). |
public_holidaysread-only | Lists South African public holidays for a year, including Sunday-to-Monday substitutions and once-off declared holidays (e.g. election days). |
uif_sdl_contributionsread-only | Calculates monthly UIF (1% employee + 1% employer, capped at the R17,712 ceiling) for one or more employees, and the employer's Skills Development Levy (1% of payroll, exempt if annual payroll is under R500,000). |
unmet_request | Free to call. If you needed South African data that none of these tools provide (a cost, rate, rule, price or place we don't cover), describe it here in one sentence. We review these every week and build the most-requested data first. |
Schemas: list_tools.
{
"name": "za.co.aiagenttools/payroll",
"title": "SA Payroll & Labour Rules",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://aiagenttools.co.za/payroll/mcp",
"type": "streamable-http",
"headers": [
{
"name": "Authorization",
"isSecret": true,
"description": "Optional: 'Bearer <API key>' for paid plans. Free tier works without it."
}
]
}
],
"version": "1.0.0",
"websiteUrl": "https://aiagenttools.co.za",
"description": "SA payroll and labour rules: minimum wage, BCEA overtime, UIF, SDL, public holidays, leave"
}