SA Business Calendar MCP
Pricing
from $10.00 / 1,000 tool calls
SA Business Calendar MCP
South African business-day and SARS deadline tools for AI agents: public holidays, business-day maths, and tax deadlines.
Pricing
from $10.00 / 1,000 tool calls
Rating
0.0
(0)
Developer
Ali Mora
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
0
Monthly active users
4 hours ago
Last modified
Categories
Share
South African business-day and SARS deadline tools for AI agents: public holidays, business-day maths, and tax deadlines. Connect any MCP client and let your agent answer "is this a business day in South Africa?" without guessing.
What it does
This Actor is a hosted Model Context Protocol server. It exposes six tools that know South African public holidays, including Sunday-to-Monday observed days and once-off declared holidays such as election days, and the SARS EMP201 and VAT201 due dates. Your agent gets exact answers instead of approximate ones from model memory.
Who it's for
AI agents doing:
- SA payroll: EMP201 (PAYE/UIF/SDL) due dates, pay-day adjustments around holidays.
- Invoicing: payment terms and due dates counted in SA business days.
- Compliance: VAT201 deadlines and regulatory notice periods.
Example prompts
Once connected, ask your agent things like:
- "Invoice dated 14 December 2026 on 5-business-day terms. When is it due?"
- "How many SA business days are there in December 2026?"
- "When are my next EMP201 and VAT201 payments due?"
- "Is 16 December a working day?"
- "List every public holiday between now and the end of March."
Tools
| Tool | What it does | Price |
|---|---|---|
is_business_day | Checks whether a date is a weekend or SA public holiday, with the reason. | Free |
days_until_next_holiday | Finds the next SA public holiday after a date and the calendar days until it. | Free |
add_business_days | Adds or subtracts SA business days, skipping weekends and holidays. | $0.01 per call |
business_days_between | Counts SA business days between two dates. | $0.01 per call |
holidays_in_range | Lists SA public holidays between two dates. | $0.01 per call |
next_sars_deadlines | Lists the next EMP201 and VAT201 due dates, adjusted for weekends and holidays. | $0.01 per call |
Dates are YYYY-MM-DD. SARS rules are simplified (monthly VAT vendors); verify against sars.gov.za before relying on them for filing.
Pricing
Pay per event:
is_business_dayanddays_until_next_holiday: free.add_business_days,business_days_between,holidays_in_rangeandnext_sars_deadlines: $0.01 per call.- A call that fails is not charged.
initializeandtools/listare not charged; Apify adds a negligible Actor-start fee when the server wakes up.
Connect your MCP client
Streamable HTTP endpoint, authenticated with your Apify API token:
Claude Code:
Claude.ai / Claude desktop: add a custom connector with the URL above.
Replace <APIFY_TOKEN> with your token. The server sleeps when idle; the first call after a pause takes a second or two longer.
FAQ
Which holidays are covered? All SA public holidays under the Public Holidays Act, including the Sunday-to-Monday rule and once-off days declared by the President.
Does it handle provincial or bank-specific holidays? No. National public holidays only.
Something wrong or missing? Open an issue on the Issues tab.
