Irish Tax Hub

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. Pass the calculator name and its required inputs. Use `get_calculator_schema` first if you need to know the exact input fields for a calculator. Common examples: base (income tax): {"marital_status": "single", "employment_income": {"income": 75000, "period": "annual"}, "year": 2026} marital_status options: single, widow, married_one_income, married_two_income refund: {"marital_status": "single", "employment_income": {"income": 50000, "tax_paid": 18000}, "year": 2026} capital-gains: {"sale_price": 400000, "purchase_price": 250000, "purchase_date": "2018-03-15", "sale_date": "2026-06-01", "year": 2026} mortgage: {"home_price": 400000, "deposit": 40000, "loan_term_years": 30, "interest_rate": 4.0} work-from-home-expense: {"electricity_costs": 1200, "heating_costs": 800, "internet_costs": 600, "tax_year": 2026, "total_earnings": 75000, "days_working_from_home": 200} avc: {"age": 45, "gross_earnings": 100000, "year": 2026} share-options: {"share_option_price": 10, "sale_price": 50, "number_of_units": 1000} redundancy-tax: {"employment_start_date": "2010-01-01", "employment_end_date": "2026-06-01", "gross_weekly_pay": 1500} mortgage-affordability: {"buyer_type": "first_time_buyer", "gross_annual_income_1": 75000, "savings": 50000}

calculate_tax

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.

get_calculator_schema

Get usage statistics for a specific tax calculator.

get_calculator_stats

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.

get_revenue_document_text

Get important Irish Revenue dates and deadlines (filing dates, payment dates, etc.).

get_key_dates

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.

get_revenue_ebrief_changelog

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.

get_tax_constants

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.

get_tax_treaty_text

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.

list_revenue_document_categories

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.

list_calculators