sars-dates-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_upcoming_deadlinesA | Find South African tax deadlines falling within the next N days. Use this to answer questions like "what SARS deadlines are coming up?" or "is anything due for VAT in the next month?". Dates come from a curated dataset of SARS filing-season notices and the underlying legislation, not from a live SARS feed. Args: within_days: How many days ahead to look, counting from today. Both today and the final day are included. For example, 30 covers the next month. category: Optional filter. Must be one of: - provisional_tax: IRP6 provisional payments, provisional taxpayer and trust income tax returns - filing_season: annual individual filing season milestones (auto-assessments, opening dates, ITR12 deadlines) - vat: VAT201 return and payment deadlines - paye: EMP201 monthly PAYE/UIF/SDL declarations - emp501: employer annual and interim PAYE reconciliations Omit it to search across every category. Returns: One line per matching deadline, sorted earliest first, in the form "YYYY-MM-DD - Title (sars.gov.za, verified YYYY-MM-DD)", each followed by an indented "Note:" line covering edge cases such as weekend or public-holiday shifts. Returns a plain sentence saying so when nothing falls in the window, and an error message listing the valid categories if the category argument is not recognised. |
| list_deadlinesA | List every known South African tax deadline, optionally by category. Use this when the question is not time-bounded - for example "what are the provisional tax dates for this cycle?" or "show me all SARS deadlines you know about". Results include dates that have already passed; use get_upcoming_deadlines instead when only future dates matter. Args: category: Optional filter. Must be one of: - provisional_tax: IRP6 provisional payments, provisional taxpayer and trust income tax returns - filing_season: annual individual filing season milestones (auto-assessments, opening dates, ITR12 deadlines) - vat: VAT201 return and payment deadlines - paye: EMP201 monthly PAYE/UIF/SDL declarations - emp501: employer annual and interim PAYE reconciliations Omit it to list every category. Returns: One line per deadline, sorted earliest first, in the form "YYYY-MM-DD - Title (sars.gov.za, verified YYYY-MM-DD)", each followed by an indented "Note:" line covering edge cases such as weekend or public-holiday shifts. Recurring obligations (VAT201, EMP201) appear as a single concrete upcoming example whose note explains the recurrence rule. Returns an error message listing the valid categories if the category argument is not recognised. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 2 tools
Both tools retrieve SARS deadlines but with distinctly scoped behavior: get_upcoming_deadlines is explicitly time-bounded to the next N days, while list_deadlines returns all known deadlines including past ones. The descriptions clearly state when to use each, eliminating misselection risk.
Both names use snake_case with a verb_noun structure (get_upcoming_deadlines, list_deadlines). The retrieval verbs get and list are consistent and clearly indicate the action, with no mixed conventions.
Two tools cover the server's narrow purpose of querying a curated deadline dataset, but this is on the thin side. The dimension considers 1–2 tools borderline, as a few more targeted queries (e.g., arbitrary date range, keyword search) could exist.
The surface covers core retrieval needs: all deadlines and upcoming deadlines, each with optional category filtering and detailed notes. However, it lacks a way to query an arbitrary date range or search by title, which agents could only work around by fetching and filtering the full list.