Take-home pay, PAYE and payroll contributions in Ghana, Kenya, Nigeria and South Africa.
Scored across 5 tools
Each of the four take_home tools is scoped to a single country by its namespace prefix, so there is no risk of picking the wrong jurisdiction. pay.country_rates is explicitly positioned as a reference-lookup tool, with descriptions telling the agent to defer to the take_home tool whenever a figure must be computed.
The set follows a clean jurisdiction.operation convention (ghana.take_home, kenya.take_home, nigeria.take_home, south_africa.take_home), all lowercase snake_case with dot namespacing. pay.country_rates breaks the pattern slightly by using a generic namespace and a noun-phrase rather than a verb-like action, but it remains readable and predictable.
Five tools is exactly right for a four-country payroll calculator plus one reference-data lookup. Nothing is redundant: one tool per country and one shared rates tool, with no filler.
The surface covers calculation and rate discovery for all four advertised countries, including employer cost and reliefs within each country tool. Minor gaps exist: there is no explicit list/countries tool and no handling of non-monthly or multi-currency inputs, but these are edge cases an agent can work around.
Use this when someone gives a monthly basic salary in Ghana cedis and asks what they take home, how much PAYE or SSNIT comes off it, or what the job costs the employer. It works the tax out band by band; do not estimate it first. Do not use it for a business's tax, for a year-end return with reliefs, or for pay in another country.
Inputs: basic_salary (required), month, resident, allowances, +1 more. Returns: law, note, period, read_on, +17 more
Use this when someone gives a monthly gross salary in Kenya shillings and asks what they take home, how much PAYE, NSSF, SHIF or Housing Levy comes off it, or what the job costs the employer. It applies NSSF, SHIF and the Housing Levy before tax, as the law has required since December 2024, then the tax bands and personal relief; do not estimate it first. Do not use it for a business's tax, for rental or turnover tax, for pay in another country, or for someone not resident in Kenya.
Inputs: gross_salary (required), pays_nssf, pays_shif, other_pension, +2 more. Returns: law, note, period, country, +17 more
Use this when someone gives a monthly salary in naira and asks what they take home, how much PAYE or pension comes off it, or what rent relief saves them, under the Nigeria Tax Act 2025 bands in force from January 2026. It works the tax out on the year, band by band, then gives the month; do not estimate it first. Do not use it for company tax, for tax before 2026, for VAT, or for pay in another country.
Inputs: gross_salary (required), yearly_rent, pays_pension, pensionable_pay, +3 more. Returns: law, note, period, country, +17 more
Use this when someone asks what the income tax bands, reliefs or payroll contributions are in Ghana, Kenya, Nigeria or South Africa, without a salary to work out. Do not use it to work out a figure: use the country's take_home tool, which does the arithmetic.
Inputs: country (required). Returns: note, country, read_on, currency, +3 more
Use this when someone gives a monthly salary in rand and asks what they take home, how much PAYE or UIF comes off it, or how age or medical aid changes it, for the tax year from 1 March 2026. It works out the year's tax on twelve months of the salary, less the rebates and medical scheme credits; do not estimate it first. Do not use it for provisional tax on business income, for a year-end assessment, or for pay in another country.
Inputs: gross_salary (required), age, pays_uif, medical_scheme_members. Returns: law, note, period, country, +17 more
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Take-home pay, income tax and social security for a salary in Ghana, and VAT with its levies.
Mobile money fees, African tax rates, currency conversion and Uganda PAYE for AI agents.
Read-only payroll calculations and multi-country tax comparisons for eight countries.
Net pay to the cent, every deduction and the employer's cost for Germany and the UK, computed with…
Add one secure layer between your agents and this server.
