calculate_tax
Calculate Irish Tax
Run an Irish tax calculator and return the full result.
Available calculators:
- base: Calculate income tax, USC, and PRSI for a given salary. Supports single/married, multiple employments, tax credits.
- refund: Estimate a PAYE tax refund by comparing tax paid vs tax owed.
- tax-free-earnings: Calculate tax-free earnings date for someone arriving in or departing Ireland mid-year.
- refund-for-move-date: Calculate tax refund for a specific move date (arriving/departing Ireland).
- net-to-gross: Reverse-calculate the gross salary needed to achieve a target net income.
- rental-income: Calculate tax on rental income including allowable expenses and mortgage interest.
- self-employed: Calculate tax for self-employed individuals including PRSI Class S and expenses.
- capital-gains: Calculate Capital Gains Tax (CGT) on asset disposals at 33%.
- share-options: Calculate tax on share option exercise (RTSO — Relevant Tax on Share Options).
- share-options-cgt: Calculate CGT on the sale of shares acquired via share options.
- work-from-home-expense: Calculate e-worker tax relief for remote working expenses.
- avc: Calculate maximum Additional Voluntary Contribution (AVC) and tax relief.
- pension-value: Estimate pension fund value at retirement based on contributions and growth.
- future-fund: Estimate future investment fund value with regular contributions.
- mortgage: Calculate monthly mortgage repayments, total interest, and amortisation.
- redundancy-tax: Calculate tax on redundancy and termination payments (SCSB, top-up, etc.).
- mortgage-affordability: Calculate maximum mortgage you can afford based on income and LTI rules.
- cat: Calculate Capital Acquisitions Tax (CAT) on gifts and inheritances.
- sarp: Calculate SARP (Special Assignee Relief Programme) tax relief for foreign assignees.
- vat3: Calculate VAT3 return figures for VAT-registered businesses.
- vat: Add VAT to, or remove VAT from, an amount at an Irish VAT rate.
Parametersinputsrequiredcalculator_namerequired
get_calculator_schema
Get Calculator Schema
Get the JSON Schema for a specific tax calculator.
Returns input fields, types, defaults, and constraints.
Use before calling `calculate_tax` if you need to know
what fields are required.
Parameterscalculator_namerequired
list_calculators
List Tax Calculators
List all available Irish tax calculators with their names and descriptions.
Returns a list of calculators that can be used with the `calculate_tax` tool.
Takes no parameters.
get_tax_constants
Get Tax Constants
Get Irish tax constants.
Returns tax bands, rates, USC rates, PRSI rates,
tax credits, and thresholds. Useful for understanding
the current tax rules without running a full calculation.
Parametersyear
get_key_dates
Get Revenue Key Dates
Get important Irish Revenue dates and deadlines (filing dates, payment dates, etc.).
Parametersyearmonthtax_type
search_revenue_documents
Search Revenue Documents
Search Irish Revenue Tax & Duty Manual (TDM) documents.
Find official Revenue guidance documents by keyword.
Returns document titles, categories, and filenames.
Use `get_revenue_document_text` to read the full text of a specific document.
Content is reused from public sector sources, normally revenue.ie under Revenue's PSI
Licence (CC BY 4.0); reproduce the result's own attribution where present, otherwise
attribution.source.statement, when citing.
Parameterslimitqueryrequiredcategory
get_revenue_document_text
Get Revenue Document Text
Get the full text of a specific Revenue Tax & Duty Manual document.
Use `search_revenue_documents` first to find the document. You can pass
the ``url`` from the search result directly — URLs, paths, and bare
filenames are all accepted. Not all documents have extracted text available.
Content is reused from public sector sources, normally revenue.ie under Revenue's PSI
Licence (CC BY 4.0); reproduce the result's own attribution where present, otherwise
attribution.source.statement, when citing.
Parametersfilenamerequired
list_revenue_document_categories
List Revenue Document Categories
List all available categories for Revenue Tax & Duty Manual documents.
Use with `search_revenue_documents` to filter results by category.
Content is reused from public sector sources, normally revenue.ie under Revenue's PSI
Licence (CC BY 4.0); reproduce the result's own attribution where present, otherwise
attribution.source.statement, when citing.
Takes no parameters.
get_revenue_ebrief_changelog
Get Revenue eBrief Changelog
Get the Revenue eBrief changelog — recent updates to Revenue guidance and Tax & Duty Manuals.
Useful for checking what Revenue guidance has changed recently.
Content is reused from public sector sources, normally revenue.ie under Revenue's PSI
Licence (CC BY 4.0); reproduce the result's own attribution where present, otherwise
attribution.source.statement, when citing.
Takes no parameters.
search_tax_treaties
Search Tax Treaties
Search Ireland's double-taxation treaty documents (treaties, protocols, MLI texts).
Find treaty documents by keyword and/or country. Returns titles, country, document
type, and identifiers. Use `get_tax_treaty_text` to read the full text of a document.
Content is reused from public sector sources, normally revenue.ie under Revenue's PSI
Licence (CC BY 4.0); reproduce the result's own attribution where present, otherwise
attribution.source.statement, when citing.
Parameterslimitqueryrequiredcountry
get_tax_treaty_text
Get Tax Treaty Text
Get the full text of a specific tax-treaty document.
Use `search_tax_treaties` first to find the document. URLs, paths, and bare
filenames are all accepted. Not all documents have extracted text available.
Content is reused from public sector sources, normally revenue.ie under Revenue's PSI
Licence (CC BY 4.0); reproduce the result's own attribution where present, otherwise
attribution.source.statement, when citing.
Parametersfilenamerequired
list_tax_treaty_countries
List Tax Treaty Countries
List all countries with an Irish double-taxation treaty.
Use with `search_tax_treaties` to filter results by country.
Content is reused from public sector sources, normally revenue.ie under Revenue's PSI
Licence (CC BY 4.0); reproduce the result's own attribution where present, otherwise
attribution.source.statement, when citing.
Takes no parameters.
get_calculator_stats
Get Calculator Stats
Get usage statistics for a specific tax calculator.
Parameterscalculator_namerequired
