# Irish Tax Hub

> Irish tax calculators, current rates and Revenue guidance: income tax, USC, PRSI, CGT, CAT and VAT.

- name: ie.irishtaxhub/irish-tax
- version: 3.2.0
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 77/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/ie.irishtaxhub%2Firish-tax
- tools: https://api.protogrid.dev/v1/servers/ie.irishtaxhub%2Firish-tax/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "irish-tax": {
      "type": "http",
      "url": "https://mcp-prod.aws.irishtaxhub.ie/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-5d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 77/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 79 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 13 of 13 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_calculator_stats (idempotentHint); calculate_tax (idempotentHint); get_calculator_schema (idempotentHint); …
- pass `tools.token_cost`: about 3,161 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 4 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 13, about 3,161 tokens to load them all
- tool set hash: f04ff8ca01da8a949d945f20631c497f
- badge: [![protogrid quality](https://protogrid.dev/badge/ie.irishtaxhub/irish-tax.svg)](https://protogrid.dev/servers/ie.irishtaxhub/irish-tax)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://mcp-prod.aws.irishtaxhub.ie/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (13)

- `calculate_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.
  - stamp-duty: Calculate stamp duty on residential or non-residential property.
  - motor-tax: Calculate annual, half-year and quarterly motor tax for a private car.
  - bike-to-work: Calculate the saving from buying a bike through the Cycle to Work scheme.
  - fair-deal: Estimate the weekly contribution under the Nursing Homes Support Scheme (Fair Deal).

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}
- `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.
- `get_calculator_stats`: Get usage statistics for a specific tax calculator.
- `get_key_dates`: Get important Irish Revenue dates and deadlines (filing dates, payment dates, etc.).
- `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.
- `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.
- `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.
- `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.
- `list_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.
- `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.
- `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.
- `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.
- `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.