Alpaca Trading API integration for Model Context Protocol (MCP)
Employees' tax (PAYE), UIF (employee and employer, with the monthly ceiling), SDL and net pay for one South African employee and pay period, using the SARS tax deduction tables (or the exact statutory-rates formula) for the right tax year. Handles age rebates, the medical scheme fees tax credit, retirement-fund deductions (s11F cap), travel allowance (80%/20%), bonuses (annual-payment method), com
A call is made on an account: it counts against an allowance and the publisher sees it, which is why this one asks who you are first.
What it does
SA accounting and tax: free SARS tax tools, plus your own GetAccountED books after sign-in.
Quickstart
# 1 — sign in once: npx mcprush@latest login
# it asks for a key from mcprush.com/dashboard#access
# 2 — install
npx mcprush@latest add getlawed/getaccounted-south-african-tax-tools-mcp
# 3 — ask your agent for something these tools do
# sa_paye_calculate, sa_vat_calculate, sa_vat_classify and 24 more
Windows PowerShell says 'running scripts is disabled on this system'? Run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned once, or type npx.cmd instead of npx (codex.cmd, gemini.cmd, grok.cmd likewise). PowerShell 7 needs neither.
GetAccountED costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine — this server runs on the publisher’s own infrastructure behind our gateway, and what you install is the connection to it.
Claude Code has its own MCP command, and the key rides on it as a header — the gateway refuses a call that carries none. Claude Code reads MCPRUSH_KEY each time it connects, so the key stays out of its config: export your key from Access in your shell profile (macOS, Linux), or run setx MCPRUSH_KEY <your key> and open a new terminal (Windows). Or let npx mcprush@latest add getlawed/getaccounted-south-african-tax-tools-mcp write the entry with the key for you; --scope user makes it available in every project.
claude mcp add --transport http --scope user getaccounted-south-african-tax-tools-mcp https://mcprush.com/gw/getaccounted-south-african-tax-tools-mcp/mcp --header 'Authorization: Bearer ${MCPRUSH_KEY}'Reconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing at the gateway. The server itself runs on the publisher’s own infrastructure, so nothing from this listing executes on your machine.
27 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Employees' tax (PAYE), UIF (employee and employer, with the monthly ceiling), SDL and net pay for one South African employee and pay period, using the SARS tax deduction tables (or the exact statutory-rates formula) for the right tax year. Handles age rebates, the medical scheme fees tax credit, retirement-fund deductions (s11F cap), travel allowance (80%/20%), bonuses (annual-payment method), com
| Parameter | Type | Required | Notes |
|---|---|---|---|
| salary | number | yes | Basic salary/wage for the pay period, in rand (before deductions) |
| period | string | no | What the amounts are per (default monthly). Non-monthly amounts are converted to a monthly equivalent. |
| pay_date | string | no | Pay date / period end, YYYY-MM-DD (default today). Decides the tax year: March onwards → next year (2026-11-30 → 2027 tax year). |
| tax_year | string | no | Tax year instead of pay_date, e.g. "2027" (1 March 2026 – 28 February 2027) |
| age | number | no | Age on the last day of the tax year (65+ and 75+ get extra rebates). Or give date_of_birth / id_number. |
| date_of_birth | string | no | YYYY-MM-DD |
| id_number | string | no | SA ID number (only used to read the date of birth; not stored) |
| medical_aid_members | number | no | People on the medical aid including the employee (for the s6A tax credit) |
| medical_aid_contribution | number | no | Employee's own medical aid contribution deducted from pay (source code 4005) |
| employer_medical_aid | number | no | Medical aid paid by the employer for the employee (fringe benefit 3810) |
| pension_contribution | number | no | Employee pension fund contribution (4001) |
| provident_contribution | number | no | Employee provident fund contribution (4003) |
| retirement_annuity | number | no | Retirement annuity paid through payroll (4006) |
| employer_pension | number | no | Employer pension fund contribution (fringe benefit 3817) |
| employer_provident | number | no | Employer provident fund contribution (fringe benefit 3825) |
| travel_allowance | number | no | Travel allowance (3701): 80% taxed through PAYE, or 20% if at least 80% business use |
| travel_business_80 | boolean | no | True when the employer is satisfied the vehicle is used at least 80% for business |
| bonus | number | no | Bonus / annual payment paid in this period (3605), taxed by the SARS annual-payment method |
| commission | number | no | Commission (3606) |
| overtime | number | no | Overtime (3607) |
Split a VAT-inclusive amount into VAT and the exclusive price, or add VAT to an exclusive amount, at the South African VAT rate in force on the date (15% since 1 April 2018). One amount or a list of lines, with per-line and total figures.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| amount | number | no | One amount in rand |
| inclusive | boolean | no | true = amount(s) include VAT (default); false = amount(s) exclude VAT |
| lines | array | no | Several lines instead of amount |
| date | string | no | Supply date YYYY-MM-DD (default today) — picks the rate from the rate history |
Is a supply standard-rated, zero-rated or exempt under the South African VAT Act, and can the buyer claim the input VAT (s17(2): entertainment, club subscriptions, motor cars…)? Answers from a curated rules table with the VAT Act section for each rule, plus related official material from the GetLawED library. Says plainly when no rule matches.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| description | string | yes | What is being sold or bought, in plain words (e.g. "client lunch at a restaurant", "brown bread", "double cab bakkie") |
| side | string | no | sale = output VAT treatment; purchase = can input VAT be claimed; both (default) |
| include_library | boolean | no | Also search the GetLawED library for related official material (default true) |
SARS (and CIPC) due dates in a date range: EMP201 (7th, earlier when that is a weekend or public holiday), VAT201 by VAT category A–E (eFiling: last business day of the month after the period), provisional tax IRP6, EMP501 reconciliation windows, ITR14 and CIPC annual returns. Uses South African public holidays.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | no | YYYY-MM-DD (default today) |
| to | string | no | YYYY-MM-DD (default 3 months after from; at most 2 years) |
| vat_category | string | no | VAT category: A = 2-monthly ending odd months, B = 2-monthly ending even months, C = monthly, D = 6-monthly, E = annual; none (default) = not VAT registered |
| vat_period_end_month | number | no | Category D/E only: month (1-12) a period ends |
| payroll | boolean | no | Registered employer (EMP201/EMP501) — default true |
| provisional_taxpayer | boolean | no | Provisional taxpayer (IRP6) — default true |
| entity_type | string | no | Default individual |
| year_end_month | number | no | Financial year-end month 1-12 (default 2 = February, the individual tax year) |
| incorporation_date | string | no | Companies/CCs: YYYY-MM-DD, for the CIPC annual return |
Format and check-digit checks for South African numbers: ID number (Luhn check digit, date of birth, gender, citizenship), income tax reference, VAT number (10 digits starting with 4), PAYE/SDL/UIF employer references and CIPC company registration numbers. Offline checks only — they do not confirm the number is registered.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| value | string | yes | The number to check |
| type | string | no | What kind of number (default auto-detect) |
Individual income tax brackets, rebates, tax thresholds, medical scheme fees tax credits, retirement deduction cap, UIF rate and ceiling, SDL rate and exemption threshold, and the VAT rate — for a tax year (current and prior years), from the tables GetAccountED payroll uses.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tax_year | string | no | e.g. "2027" = 1 March 2026 – 28 February 2027 (default: current tax year) |
| compare_previous | boolean | no | Also show the previous tax year (default false) |
Lists the GetAccountED books this sign-in can work on, with their business_id. Use it first when the user is an accounting practice and asks about a particular client, then pass that business_id to the other accounting_ tools. For a single business it simply confirms which books are connected. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
Takes no parameters.
Snapshot of the business's books for a period: income, expenses and profit (from the ledger), bank balances, money owed by customers and to suppliers, VAT position, bank lines still to reconcile and slips still missing. Defaults to this month so far. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | no | Start date YYYY-MM-DD (default: first day of this month) |
| to | string | no | End date YYYY-MM-DD (default: today) |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Profit and loss for a period, per account (income and expense accounts, from the general ledger). Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | yes | Start date YYYY-MM-DD |
| to | string | yes | End date YYYY-MM-DD |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Balance sheet as at a date: assets, liabilities and equity per account, including profit to date not yet closed off. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| as_at | string | no | Date YYYY-MM-DD (default: today) |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Customer invoices. status: open (unpaid or part-paid), overdue, paid, or all. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | string | no | Which invoices (default open) |
| limit | number | no | Maximum rows, 1-200 (default 50) |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Expenses and supplier bills recorded in a period, with account, VAT, payment status and whether a slip is attached. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | no | Start date YYYY-MM-DD |
| to | string | no | End date YYYY-MM-DD |
| unpaid_only | boolean | no | Only bills still owed |
| limit | number | no | Maximum rows, 1-200 (default 50) |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Bank reconciliation status per uploaded statement, plus the bank payments that still need a slip or invoice. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Hand in a receipt, till slip, fuel slip or supplier invoice (PDF or photo, base64, max 10 MB). It is read immediately and filed under Slips & Documents for the business to check and post — nothing is posted to the ledger by this tool. Returns what was read. Use when the user gives you a slip or invoice file to hand in. Needs the user's GetAccountED sign-in (they are asked to sign in the first time
| Parameter | Type | Required | Notes |
|---|---|---|---|
| filename | string | yes | File name, e.g. "engen-slip.jpg" |
| content_base64 | string | yes | The file, base64-encoded |
| mime_type | string | no | e.g. image/jpeg or application/pdf |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
The business's chart of accounts (code, name, type). Use the codes when filing a bank line to an account. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| type | string | no | Only this account type |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Bank statement lines still waiting to be filed, each with its line_id, the suggestion GetAccountED made (account, invoice or rule) and candidate open items: unpaid customer invoices (money in) or unpaid supplier bills (money out) matching by amount or name. Amounts in rand. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | no | Only lines on or after this date (YYYY-MM-DD) |
| to | string | no | Only lines on or before this date (YYYY-MM-DD) |
| direction | string | no | Money in, money out or all (default all) |
| limit | number | no | Maximum lines, 1-100 (default 25) |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
File one unfiled bank line. Give ONE of: account_code (e.g. bank charges, income, a loan), invoice allocations / customer_id (customer receipt — remainder goes on account), bill allocations / supplier_id or supplier_name (supplier payment), or on_account:true with a customer or supplier. TWO STEPS: the first call changes nothing and returns a preview of the journal it will post plus a confirm_toke
| Parameter | Type | Required | Notes |
|---|---|---|---|
| line_id | string | yes | The bank line (from accounting_unfiled_bank_lines) |
| account_code | string | no | File straight to this account (chart of accounts code) |
| vat | boolean | no | With account_code: split 15% VAT out of the amount (VAT vendors only). Omit to use the default for that account. |
| refund | boolean | no | With account_code: money in that is a refund of an expense |
| allocations | array | no | Which invoices (money in) or bills (money out) this pays, with optional amounts (part payments allowed). Omit amount to settle as much as is due, in order. |
| customer_id | number | no | Customer id (inv client) — for a receipt; anything not allocated goes on account |
| supplier_id | string | no | Supplier contact id — for a supplier payment |
| supplier_name | string | no | Supplier known only by name on its bills |
| on_account | boolean | no | Whole amount on account with the customer / supplier |
| confirm_token | string | no | Second step only: the token from the preview |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Re-file a bank line that was already filed wrongly: reverses everything it posted (one reversal journal on the line's date, payments taken back off invoices/bills) and files it again to the new target. Same target arguments as accounting_file_bank_line. TWO STEPS: first call = preview of the reversal and new journal + confirm_token; second call with confirm_token does it. Changes the user's real b
| Parameter | Type | Required | Notes |
|---|---|---|---|
| line_id | string | yes | The filed bank line id |
| account_code | string | no | New target: file straight to this account (chart of accounts code) |
| vat | boolean | no | With account_code: split 15% VAT out of the amount (VAT vendors only). Omit to use the default for that account. |
| refund | boolean | no | With account_code: money in that is a refund of an expense |
| allocations | array | no | New target: which invoices (money in) or bills (money out) this pays, with optional amounts (part payments allowed). Omit amount to settle as much as is due, in order. |
| customer_id | number | no | New target: customer id — for a receipt; anything not allocated goes on account |
| supplier_id | string | no | New target: supplier contact id — for a supplier payment |
| supplier_name | string | no | New target: supplier known only by name on its bills |
| on_account | boolean | no | Whole amount on account with the customer / supplier |
| confirm_token | string | no | Second step only: the token from the preview |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Create a DRAFT customer invoice (never sent, not in the ledger until the business sends it from GetAccountED). VAT at 15% if the business is a VAT vendor. TWO STEPS: first call returns the totals + confirm_token; second call with confirm_token saves the draft. Changes the user's real books — only after they have seen the preview and agreed. Needs the user's GetAccountED sign-in (they are asked to
| Parameter | Type | Required | Notes |
|---|---|---|---|
| customer_id | number | no | Existing customer id |
| customer_name | string | no | Or the customer's name (must match one customer) |
| create_customer | boolean | no | Create the customer by customer_name if none matches |
| lines | array | yes | Invoice lines |
| prices_include_vat | boolean | no | true = unit prices already include VAT; false = VAT added on top. Default: the business's invoice setting. |
| due_date | string | no | YYYY-MM-DD (default: the business's payment terms) |
| notes | string | no | Note printed on the invoice (optional) |
| confirm_token | string | no | Second step only: the token from the preview |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Aged debtors (who owes the business, by age: not yet due, 1-30, 31-60, 61-90, 91-120, 120+ days past due) as at a date, reconciled to Accounts Receivable. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| as_at | string | no | YYYY-MM-DD (default today) |
| basis | string | no | Age from due date (default) or invoice date |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Aged creditors (what the business owes suppliers, by age) as at a date, reconciled to Accounts Payable. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| as_at | string | no | YYYY-MM-DD (default today) |
| basis | string | no | Age from due date (default) or invoice date |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Drafts a polite payment-reminder email (text only — nothing is sent) for each customer with overdue invoices, listing the invoices and amounts. Edit it, then the business sends it — or use accounting_send_invoice_reminder to send GetAccountED's standard branded reminder for one invoice. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| customer_name | string | no | Only this customer |
| min_days_overdue | number | no | Only invoices at least this many days overdue (default 1) |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Email GetAccountED's standard branded payment reminder (with pay-online link and the invoice PDF) for one unpaid invoice to the customer's email on file. TWO STEPS: first call shows who it goes to + confirm_token; the email is only sent on the second call with confirm_token. Changes the user's real books — only after they have seen the preview and agreed. Needs the user's GetAccountED sign-in (the
| Parameter | Type | Required | Notes |
|---|---|---|---|
| invoice_number | string | yes | The invoice to remind the customer about (from accounting_list_invoices) |
| confirm_token | string | no | Second step only: the token from the preview |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
DRAFT VAT201 for a VAT period, field by field as on SARS eFiling (output tax, input tax, payable/refundable). A preparation draft — check it before filing on eFiling; nothing is submitted to SARS. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| from | string | yes | Period start YYYY-MM-DD |
| to | string | yes | Period end YYYY-MM-DD |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
EMP201 for a month from finalised pay runs: PAYE, UIF, SDL, ETI and total due to SARS (due the 7th of the next month), with per-employee lines. ID and tax numbers are masked. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| month | string | yes | YYYY-MM |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
Trial balance as at a date: every account's debit or credit balance and whether the ledger balances. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| as_at | string | no | YYYY-MM-DD (default today) |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
General ledger for one account over a date range: opening balance, every posting with reference and description, running and closing balance. Read-only. Needs the user's GetAccountED sign-in (they are asked to sign in the first time).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| account_code | string | yes | Chart of accounts code |
| from | string | no | YYYY-MM-DD |
| to | string | no | YYYY-MM-DD |
| limit | number | no | Maximum postings, 1-500 (default 200) |
| business_id | string | no | Accounting practices only: which client's books (an id from accounting_list_my_businesses). Leave out to use the books chosen at sign-in. |
- Every tool, no call limit, and mcprush charges nothing
- A buyer key from your dashboard — the gateway refuses a call without one
- Answers through our gateway, so every call is in your log
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install GetAccountED or to call it, and its free tier carries no monthly call limit.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | minimal | capability blast radius (minimal) — client exposure if the model is manipulated | −0 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. minimal is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| sa_paye_calculate | no tags | |
| sa_vat_calculate | no tags | |
| sa_vat_classify | no tags | |
| sa_tax_calendar | no tags | |
| sa_validate_reference | no tags | |
| sa_tax_rates | no tags |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
The gateway serves every install the publisher’s current release, so a release cannot be pinned or rolled back to here yet. The history below is for reading; the current release on file is 1.1.1.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish GetAccountED can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.