About SA Business Calendar
SA Business Calendar is a hosted MCP server for AI agents that need South African business-day and SARS deadline calculations. It combines public-holiday data, date arithmetic, and EMP201/VAT201 due dates.
Key features
- 01Check whether a date is a business day
- 02Find the next public holiday
- 03Add or subtract business days
- 04Count business days between dates
- 05List holidays in a date range
- 06Get adjusted EMP201 and VAT201 deadlines
Use cases
- 01Calculate invoice due dates on business-day terms
- 02Check upcoming SARS payment deadlines
- 03List national holidays for a planning period
MCP support
Exposes date and deadline tools to MCP clients over Streamable HTTP. Connection uses an Apify API token; calls are billed through Apify.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://ali-mora--sa-calendar-apify.apify.actor/mcpclaude mcp add --transport http alimora83-sa-business-calendar https://ali-mora--sa-calendar-apify.apify.actor/mcp{"mcpServers":{"alimora83-sa-business-calendar":{"type":"http","url":"https://ali-mora--sa-calendar-apify.apify.actor/mcp"}}}Open in Cursor{"servers":{"alimora83-sa-business-calendar":{"type":"http","url":"https://ali-mora--sa-calendar-apify.apify.actor/mcp"}}}Open in VS Code{"mcpServers":{"alimora83-sa-business-calendar":{"type":"http","url":"https://ali-mora--sa-calendar-apify.apify.actor/mcp"}}}{"mcpServers":{"alimora83-sa-business-calendar":{"serverUrl":"https://ali-mora--sa-calendar-apify.apify.actor/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://ali-mora--sa-calendar-apify.apify.actor/mcpAuth requiredTools
Details
From the project READMESA Business Calendar MCP
Hosted Model Context Protocol server that gives AI agents exact South African business-day answers: public holidays (including Sunday-to-Monday observed days and once-off declared holidays), business-day maths, and SARS EMP201/VAT201 due dates.
Get it on Apify Store → apify.com/ali_mora/sa-calendar-apify
Tools
| Tool | What it does | Price |
|---|---|---|
is_business_day | Is a date a weekend or SA public holiday? Returns the reason. | Free |
days_until_next_holiday | Next SA public holiday after a date, and the days until it. | Free |
add_business_days | Add or subtract SA business days, skipping weekends and holidays. | $0.01/call |
business_days_between | Count SA business days between two dates. | $0.01/call |
holidays_in_range | List SA public holidays between two dates. | $0.01/call |
next_sars_deadlines | Next EMP201 and VAT201 due dates, adjusted for weekends and holidays. | $0.01/call |
Billed per call through Apify. Failed calls aren't charged.
Connect
Endpoint (Streamable HTTP), authenticated with your Apify API token:
https://ali-mora--sa-calendar-apify.apify.actor/mcp
Any MCP client:
{
"mcpServers": {
"sa-business-calendar": {
"url": "https://ali-mora--sa-calendar-apify.apify.actor/mcp",
"headers": { "Authorization": "Bearer <APIFY_TOKEN>" }
}
}
}
Claude Code:
claude mcp add --transport http sa-business-calendar https://ali-mora--sa-calendar-apify.apify.actor/mcp --header "Authorization: Bearer <APIFY_TOKEN>"
Example prompts
- "Invoice dated 14 December 2026 on 5-business-day terms. When is it due?"
- "When are my next EMP201 and VAT201 payments due?"
- "List every SA public holiday between now and the end of March."
Notes
- Dates are
YYYY-MM-DD. National public holidays only; no provincial or bank-specific days. - SARS rules are simplified (monthly VAT vendors). Verify against sars.gov.za before relying on them for filing.
- This repo holds the listing and registry metadata. The server source is private.
Issues and requests: open an issue here or on the Apify Store page.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.