Read-only payroll calculations and multi-country tax comparisons for eight countries.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Calculate detailed payroll and net salary for one country and person. Use this for tax class, region, health insurance, pension, deductions, or other country-specific inputs. For the same gross salary across two or more countries, use taxcompare. Use semantic fields where available; legacy fields remain REST compatibility inputs. Monetary fields in the legacy request are minor units and period-specific.
Payroll period identifier for the calculation. Values: 1=year, 2=month, 3=week, 4=day. All salary and payroll monetary inputs must be for this period, not automatically annualized.
Age in the selected tax year. If omitted, the calculation reports the standard age-35 assumption instead of silently hiding the default.
Preferred high-level tax assumptions for MCP calls. The adapter maps these to Steuerklasse, Kirche, and Kinderfreibetrag.
Country code for the calculation.
Calculation mode. Use 1 for one person, 2 for two persons, and 3 for the German TaxSim capped real-splitting simulation.
Global factor for factor-based tax class handling.
Tax year.
Preferred high-level country code for MCP calls. For German payroll use DE. The adapter maps this to legacy Land.
Display currency / calculation currency code.
One or two payroll person records. Each person contains salary, tax class, region, insurance, child, and optional special-income inputs.
Preferred high-level location input. For Germany, federal_state may be a state code such as BE or a full Obolus state name such as Berlin.
Preferred high-level tax year for MCP calls. The adapter maps this to legacy Stjahr.
Top-level child allowance, child count, dependent count, or child-credit factor for the calculation. DE uses allowance-style factors; AT/CH/US and other systems use country-specific child/dependent meanings where supported.
Total child count relevant for German long-term care insurance contribution logic. Leave 0 outside German care-insurance scenarios unless a country-specific child workflow explicitly requires it.
Child benefit amount in minor units for the selected calculation context. Leave 0 for standard payroll estimates unless explicitly modeling child benefit or a country-specific dependent benefit.
Preferred high-level gross salary input. Amount is in major currency units, not cents. The adapter maps it to legacy Gehalt_ct minor units and LZZ.
Preferred high-level German employee type. Use standard_statutory_employee for the common statutory pension, unemployment, health, and care insurance case.
Preferred high-level payroll preset. Use DE_STANDARD_EMPLOYEE_STATUTORY for a normal German employee with statutory pension, unemployment, health, and care insurance.
Preferred high-level German social-security assumptions. Use enums instead of raw Obolus flags. The adapter maps statutory/exempt/private choices to the legacy payroll-engine fields.
Calculate detailed payroll and net salary for one country and person. Use this for tax class, region, health insurance, pension, deductions, or other country-specific inputs. For the same gross salary across two or more countries, use taxcompare. Use semantic fields where available; legacy fields remain REST compatibility inputs. Monetary fields in the legacy request are minor units and period-specific.
| Argument | Type | Description |
|---|---|---|
| LZZ | integer | Payroll period identifier for the calculation. Values: 1=year, 2=month, 3=week, 4=day. All salary and payroll monetary inputs must be for this period, not automatically annualized. |
| age | integer | Age in the selected tax year. If omitted, the calculation reports the standard age-35 assumption instead of silently hiding the default. |
| tax | object | Preferred high-level tax assumptions for MCP calls. The adapter maps these to Steuerklasse, Kirche, and Kinderfreibetrag. |
| Land | string | Country code for the calculation. |
| Modus | integer | Calculation mode. Use 1 for one person, 2 for two persons, and 3 for the German TaxSim capped real-splitting simulation. |
| Faktor | number | Global factor for factor-based tax class handling. |
| Stjahr | integer | Tax year. |
| country | string | Preferred high-level country code for MCP calls. For German payroll use DE. The adapter maps this to legacy Land. |
| Currency | string | Display currency / calculation currency code. |
| Personen | array | One or two payroll person records. Each person contains salary, tax class, region, insurance, child, and optional special-income inputs. |
| location | object | Preferred high-level location input. For Germany, federal_state may be a state code such as BE or a full Obolus state name such as Berlin. |
| tax_year | integer | Preferred high-level tax year for MCP calls. The adapter maps this to legacy Stjahr. |
| KinderFRB | number | Top-level child allowance, child count, dependent count, or child-credit factor for the calculation. DE uses allowance-style factors; AT/CH/US and other systems use country-specific child/dependent meanings where supported. |
| KinderPVA | integer | Total child count relevant for German long-term care insurance contribution logic. Leave 0 outside German care-insurance scenarios unless a country-specific child workflow explicitly requires it. |
| Kindergeld | integer | Child benefit amount in minor units for the selected calculation context. Leave 0 for standard payroll estimates unless explicitly modeling child benefit or a country-specific dependent benefit. |
| gross_salary | object | Preferred high-level gross salary input. Amount is in major currency units, not cents. The adapter maps it to legacy Gehalt_ct minor units and LZZ. |
| employee_type | string | Preferred high-level German employee type. Use standard_statutory_employee for the common statutory pension, unemployment, health, and care insurance case. |
| payroll_preset | string | Preferred high-level payroll preset. Use DE_STANDARD_EMPLOYEE_STATUTORY for a normal German employee with statutory pension, unemployment, health, and care insurance. |
| social_security | object | Preferred high-level German social-security assumptions. Use enums instead of raw Obolus flags. The adapter maps statutory/exempt/private choices to the legacy payroll-engine fields. |
{
"type": "object",
"examples": [
{
"age": 35,
"tax": {
"tax_class": 1,
"church_tax": false,
"child_allowance_factor": 0
},
"country": "DE",
"location": {
"federal_state": "BE"
},
"tax_year": 2026,
"gross_salary": {
"amount": 60000,
"period": "annual",
"currency": "EUR"
},
"employee_type": "standard_statutory_employee",
"payroll_preset": "DE_STANDARD_EMPLOYEE_STATUTORY",
"social_security": {
"health_insurance": "statutory",
"pension_insurance": "statutory",
"unemployment_insurance": "statutory",
"long_term_care_insurance": "statutory",
"children_for_care_insurance": 0,
"health_additional_contribution_percent": 2.9
}
}
],
"properties": {
"LZZ": {
"enum": [
1,
2,
3,
4
],
"type": "integer",
"default": 1,
"description": "Payroll period identifier for the calculation. Values: 1=year, 2=month, 3=week, 4=day. All salary and payroll monetary inputs must be for this period, not automatically annualized."
},
"age": {
"type": "integer",
"default": 35,
"maximum": 100,
"minimum": 18,
"description": "Age in the selected tax year. If omitted, the calculation reports the standard age-35 assumption instead of silently hiding the default."
},
"tax": {
"type": "object",
"properties": {
"tax_class": {
"enum": [
1,
2,
3,
4,
5,
6
],
"type": "integer",
"description": "German tax class, 1 through 6."
},
"church_tax": {
"type": "boolean",
"default": false,
"description": "Whether German church tax applies. false maps to Kirche=0 and true maps to Kirche=1."
},
"child_allowance_factor": {
"type": "number",
"default": 0,
"minimum": 0,
"description": "German child allowance factor, for example 0, 0.5, 1, or 2."
}
},
"description": "Preferred high-level tax assumptions for MCP calls. The adapter maps these to Steuerklasse, Kirche, and Kinderfreibetrag.",
"additionalProperties": false
},
"Land": {
"enum": [
"DE",
"AT",
"US",
"CH",
"CA",
"AU",
"UK",
"IE"
],
"type": "string",
"description": "Country code for the calculation."
},
"Modus": {
"enum": [
1,
2,
3
],
"type": "integer",
"default": 1,
"description": "Calculation mode. Use 1 for one person, 2 for two persons, and 3 for the German TaxSim capped real-splitting simulation."
},
"Faktor": {
"type": "number",
"default": 1,
"description": "Global factor for factor-based tax class handling."
},
"Stjahr": {
"type": "integer",
"examples": [
2026
],
"description": "Tax year."
},
"country": {
"enum": [
"DE",
"AT",
"US",
"CH",
"CA",
"AU",
"UK",
"IE"
],
"type": "string",
"description": "Preferred high-level country code for MCP calls. For German payroll use DE. The adapter maps this to legacy Land."
},
"Currency": {
"enum": [
"EUR",
"USD",
"CHF",
"CAD",
"AUD",
"GBP"
],
"type": "string",
"description": "Display currency / calculation currency code."
},
"Personen": {
"type": "array",
"items": {
"type": "object",
"required": [
"Land",
"Gehalt_ct",
"Steuerklasse",
"Geburtsjahr"
],
"properties": {
"Land": {
"enum": [
"DE",
"AT",
"US",
"CH",
"CA",
"AU",
"UK",
"IE"
],
"type": "string",
"description": "Country code that selects the payroll/tax system for this person. Interpret all country-polymorphic fields in this person record, such as Steuerklasse, Bundesland, PreTax_Deduction_ct, Kinderfreibetrag, and output tax buckets, through this Land value. Supported systems: DE, AT, CH, US, UK, IE, CA, AU."
},
"Faktor": {
"type": "number",
"description": "Germany-only tax factor used for tax class IV/factor workflows."
},
"Kirche": {
"type": "integer",
"description": "Church tax membership flag. Use 1 when church tax applies and 0 when it does not."
},
"Stjahr": {
"type": "integer",
"description": "Tax year."
},
"Gehalt_ct": {
"type": "integer",
"minimum": 0,
"description": "Gross pay for this person's selected payroll period in minor units. The value must match LZZ/Lohnzahlungszeitraum: for EUR 70,000 per year with LZZ=1 send 7000000; for monthly payroll with LZZ=2 send the monthly gross, for example 583333 for EUR 5,833.33."
},
"KinderPVA": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Number of children relevant for German long-term care insurance. Children can reduce the care insurance rate; use 0 when no child discount applies."
},
"Bundesland": {
"type": "string",
"examples": [
"Baden-Wuerttemberg",
"Bayern",
"Berlin",
"Brandenburg",
"Bremen",
"Hamburg",
"Hessen",
"Mecklenburg-Vorpommern",
"Niedersachsen",
"Nordrhein-Westfalen",
"Rheinland-Pfalz",
"Saarland",
"Sachsen",
"Sachsen-Anhalt",
"Schleswig-Holstein",
"Thueringen"
],
"description": "Country-polymorphic region selector for regional taxes and payroll rules. DE uses full Obolus state names such as Berlin, Bayern, Nordrhein-Westfalen, Sachsen, not ISO abbreviations such as BE or BY. AT uses Austrian federal states such as Wien. CH uses the canton such as Zurich. US uses state names such as California. CA uses provinces such as Ontario, Quebec, or British Columbia. UK uses England, Scotland, Wales, or Northern Ireland. Leave omitted for country examples that omit it unless the user gives a specific supported region."
},
"Pendler_KM": {
"type": "integer",
"description": "Austria-only commuting distance in kilometers."
},
"Geburtsjahr": {
"type": "integer",
"description": "Birth year."
},
"Hinzubetrag": {
"type": "integer",
"description": "Additional amount on one-off payments in minor units."
},
"pendlerEuro": {
"type": "integer",
"description": "Austria-only commuter allowance amount in minor units."
},
"Pendler_Tage": {
"type": "integer",
"description": "Austria-only monthly commuter days."
},
"Steuerklasse": {
"type": "integer",
"description": "Country-polymorphic tax class, tariff, filing status, or tax-code selector. Do not reuse German tax-class meanings outside Land=DE. DE: 1=single, 2=single parent, 3/4/5=married tax classes, 6=additional job. AT: 1=standard employee, 2=sole earner with child, 3=single parent with child. CH: current backend-supported ordinary Zurich tariffs are 1=single/no children and 2=married or children; CH values above 1 are normalized to 2 until Tarif C/H are implemented end-to-end. US: 1=Single, 3=Joint, 4=Head of Household. UK: 1=1257L standard tax code. IE: 1=Single, 2=Joint one income, 3=Joint two incomes. AU: 1=Resident, 2=Non-Resident, 3=Working Holiday. CA uses the payroll claim setup for federal/provincial tax calculation."
},
"Freibetrag_AG": {
"type": "integer",
"description": "Employer/payroll allowance or additional withholding amount in minor units. Country meanings include DE employer wage-tax feature, AT allowance notice, US/CA additional withholding, and UK payroll allowance handling."
},
"Hinzubetrag_AG": {
"type": "integer",
"description": "Employer surcharge in minor units."
},
"Sonstige_Sterbe": {
"type": "integer",
"description": "Death benefit / survivor payment in minor units."
},
"Freibetrag_Sonst": {
"type": "integer",
"description": "Allowance on one-off payments in minor units."
},
"Kinderfreibetrag": {
"type": "number",
"default": 0,
"description": "Child allowance, dependent count, or child-credit factor for this person. DE uses child allowance shares such as 0, 0.5, 1, or 2. AT uses child count for Familienbonus workflows. CH uses child deduction count. US uses dependent credits count. CA/UK/AU/IE use dependent or child context where supported, often outside direct payroll tax."
},
"Pendler_Zumutbar": {
"type": "integer",
"description": "Austrian commuter reasonableness flag."
},
"Sonstige_Bezuege": {
"type": "integer",
"description": "One-off payments or bonus income in minor units. Country meanings include DE other remuneration, UK/US/CA/IE supplemental income, AU bonus pay, and AT/CH special salary or bonus handling where supported."
},
"Stfr_vermgsbteil": {
"type": "integer",
"description": "Tax-free capital-forming benefit share in minor units."
},
"Altersrente_Bezug": {
"type": "integer",
"description": "1 if pension/retirement benefits apply, otherwise 0. Mainly used for DE/AT pensioner workflows."
},
"Hat_Studienkredit": {
"type": "integer",
"description": "Student loan repayment flag. Relevant for UK student loan, AU HELP/HECS, and IE student-loan-style deductions where modeled."
},
"de_payroll_preset": {
"enum": [
"DE_STANDARD_EMPLOYEE_STATUTORY",
"DE_PRIVATE_HEALTH_INSURANCE",
"DE_PENSION_EXEMPT",
"DE_PENSION_EXEMPT_PRIVATE_HEALTH"
],
"type": "string",
"oneOf": [
{
"const": "DE_STANDARD_EMPLOYEE_STATUTORY",
"title": "Germany standard employee with statutory pension and statutory health",
"description": "Use this for the normal German employee case. The adapter maps it to Obolus backend flags gesetzliche_RV=0, gesetzlicheKvPvStatus=0, KV_Art=0, AN_Beitraege_PKV=0."
},
{
"const": "DE_PRIVATE_HEALTH_INSURANCE",
"title": "Germany employee with private health insurance",
"description": "Use this only when the user explicitly has PKV. The adapter keeps statutory pension/unemployment enabled and maps health/care to private. Provide de_private_health_employee_contribution_ct."
},
{
"const": "DE_PENSION_EXEMPT",
"title": "Germany pension/unemployment exempt with statutory health",
"description": "Use this for civil servants, self-employed, or other no-statutory-pension cases that still use statutory health/care handling."
},
{
"const": "DE_PENSION_EXEMPT_PRIVATE_HEALTH",
"title": "Germany pension/unemployment exempt with private health",
"description": "Use this only for exempt PKV cases. Provide de_private_health_employee_contribution_ct."
}
],
"default": "DE_STANDARD_EMPLOYEE_STATUTORY",
"description": "Preferred semantic German payroll preset for MCP calls. Use this instead of raw Obolus flags. For 'Germany, normal employee, tax class I' choose DE_STANDARD_EMPLOYEE_STATUTORY."
},
"Geldwerter_Vorteil": {
"type": "integer",
"description": "Taxable benefits in minor units. Used as in-kind benefit, taxable benefit, benefit in kind, natural salary, or imputed income depending on country; supported for DE, AT, CH, UK, US, CA, and IE."
},
"Versorgungsbezuege": {
"type": "integer",
"description": "Germany-only pension or civil-service pension payments in minor units."
},
"PreTax_Deduction_ct": {
"type": "integer",
"description": "Country-polymorphic pre-tax deductions in minor units for the selected payroll period. Interpret by Land: AT occupational provision/commuter-related deduction, CH pillar 3a or occupational pension purchase, US 401k/IRA/HSA, UK salary sacrifice or pension, CA RRSP/pension, AU super salary sacrifice, and IE pension contribution."
},
"Gehalt_ct_ohne_Sonst": {
"type": "integer",
"minimum": 0,
"description": "Gross pay excluding one-off or bonus payments for the selected payroll period, in minor units."
},
"Lohnzahlungszeitraum": {
"type": "integer",
"description": "Payroll period for this person. Values: 1=year, 2=month, 3=week, 4=day. The person's Gehalt_ct must be the gross amount for the same period. Some country UIs expose only a subset: AT/CH commonly annual or monthly; DE/US and defaults commonly annual, monthly, or weekly."
},
"Sonstige_Entschaedigung": {
"type": "integer",
"description": "Compensation payments in minor units."
},
"Monate_Versorgungsbezuege": {
"type": "integer",
"description": "Germany-only number of months with pension payments."
},
"Entschädigungen_vermgsbteil": {
"type": "integer",
"description": "Capital-forming compensation share in minor units."
},
"Erster_mntl_Versorgungsbezug": {
"type": "integer",
"description": "Germany-only first monthly pension payment in minor units."
},
"Erstes_Jahr_Versorgungsbezug": {
"type": "integer",
"description": "Germany-only first tax year of pension receipt."
},
"de_statutory_health_and_care": {
"type": "boolean",
"default": true,
"description": "Semantic Germany-only adapter field. true means statutory health and long-term care insurance apply. The adapter maps true to Obolus gesetzlicheKvPvStatus=0 and KV_Art=0; false means private health insurance and requires de_private_health_employee_contribution_ct."
},
"Versorgungsbezuege_Sonderzahlung": {
"type": "integer",
"description": "Germany-only special pension payment in minor units."
},
"Sonstige_Bezuege_Versorgungsbezug": {
"type": "integer",
"description": "One-off payments tied to pension benefits in minor units."
},
"de_health_extra_contribution_percent": {
"type": "number",
"maximum": 10,
"minimum": 0,
"examples": [
1.7,
2.5
],
"description": "Preferred MCP alias for the German statutory health insurance Zusatzbeitrag. Use the literal percent value, for example 2.5 for 2.5%. The server normalizes this to legacy KVZ. Do not use basis points, tenths, cents, 25, 250, or any minor-unit encoding."
},
"de_statutory_pension_and_unemployment": {
"type": "boolean",
"default": true,
"description": "Semantic Germany-only adapter field. true means statutory pension and unemployment insurance apply. The adapter maps true to Obolus gesetzliche_RV=0 and false to gesetzliche_RV=1. Use false only for civil servants, self-employed, or explicitly pension-exempt cases."
},
"de_private_health_employee_contribution_ct": {
"type": "integer",
"minimum": 0,
"description": "Semantic Germany-only adapter field for private health insurance employee contribution in minor units for the selected payroll period. Required when de_statutory_health_and_care=false or a private-health preset is selected. Leave omitted or 0 for statutory GKV/PV."
}
},
"additionalProperties": true
},
"maxItems": 2,
"minItems": 1,
"description": "One or two payroll person records. Each person contains salary, tax class, region, insurance, child, and optional special-income inputs."
},
"location": {
"type": "object",
"properties": {
"federal_state": {
"type": "string",
"description": "German federal state code or full state name, for example BE or Berlin. The adapter maps BE to Berlin."
}
},
"description": "Preferred high-level location input. For Germany, federal_state may be a state code such as BE or a full Obolus state name such as Berlin.",
"additionalProperties": false
},
"tax_year": {
"type": "integer",
"examples": [
2026
],
"description": "Preferred high-level tax year for MCP calls. The adapter maps this to legacy Stjahr."
},
"KinderFRB": {
"type": "number",
"default": 0,
"description": "Top-level child allowance, child count, dependent count, or child-credit factor for the calculation. DE uses allowance-style factors; AT/CH/US and other systems use country-specific child/dependent meanings where supported."
},
"KinderPVA": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Total child count relevant for German long-term care insurance contribution logic. Leave 0 outside German care-insurance scenarios unless a country-specific child workflow explicitly requires it."
},
"Kindergeld": {
"type": "integer",
"default": 0,
"description": "Child benefit amount in minor units for the selected calculation context. Leave 0 for standard payroll estimates unless explicitly modeling child benefit or a country-specific dependent benefit."
},
"gross_salary": {
"type": "object",
"required": [
"amount",
"currency",
"period"
],
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"description": "Gross salary in major currency units, for example 60000 for EUR 60,000 annual gross or 5000 for EUR 5,000 monthly gross."
},
"period": {
"enum": [
"annual",
"monthly",
"weekly",
"daily"
],
"type": "string",
"description": "Salary period. annual maps to LZZ=1, monthly to LZZ=2, weekly to LZZ=3, daily to LZZ=4."
},
"currency": {
"enum": [
"EUR",
"USD",
"CHF",
"CAD",
"AUD",
"GBP"
],
"type": "string",
"description": "Salary currency, for example EUR."
}
},
"description": "Preferred high-level gross salary input. Amount is in major currency units, not cents. The adapter maps it to legacy Gehalt_ct minor units and LZZ.",
"additionalProperties": false
},
"employee_type": {
"enum": [
"standard_statutory_employee",
"private_health_insurance",
"pension_exempt",
"pension_exempt_private_health"
],
"type": "string",
"default": "standard_statutory_employee",
"description": "Preferred high-level German employee type. Use standard_statutory_employee for the common statutory pension, unemployment, health, and care insurance case."
},
"payroll_preset": {
"enum": [
"DE_STANDARD_EMPLOYEE_STATUTORY",
"DE_PRIVATE_HEALTH_INSURANCE",
"DE_PENSION_EXEMPT",
"DE_PENSION_EXEMPT_PRIVATE_HEALTH"
],
"type": "string",
"default": "DE_STANDARD_EMPLOYEE_STATUTORY",
"description": "Preferred high-level payroll preset. Use DE_STANDARD_EMPLOYEE_STATUTORY for a normal German employee with statutory pension, unemployment, health, and care insurance."
},
"social_security": {
"type": "object",
"properties": {
"health_insurance": {
"enum": [
"statutory",
"private"
],
"type": "string",
"default": "statutory",
"description": "Use statutory for German GKV/PV. Use private only when the user explicitly has private health insurance."
},
"pension_insurance": {
"enum": [
"statutory",
"exempt"
],
"type": "string",
"default": "statutory",
"description": "Use statutory for normal employees. Use exempt only for civil servants, self-employed, pensioners, or explicitly pension-exempt cases."
},
"unemployment_insurance": {
"enum": [
"statutory",
"exempt"
],
"type": "string",
"default": "statutory",
"description": "Use statutory for normal employees. This is mapped together with pension_insurance for the legacy German payroll engine."
},
"long_term_care_insurance": {
"enum": [
"statutory",
"private"
],
"type": "string",
"default": "statutory",
"description": "Use statutory for normal German care insurance. Private should only be used together with private health insurance."
},
"children_for_care_insurance": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Number of children relevant for German long-term care insurance contribution logic."
},
"health_additional_contribution_percent": {
"type": "number",
"maximum": 5,
"minimum": 0,
"examples": [
2.5,
2.9
],
"description": "German statutory health Zusatzbeitrag as literal percentage points, for example 2.9 for 2.90%. Do not use basis points such as 290."
},
"private_health_employee_contribution_ct": {
"type": "integer",
"minimum": 0,
"description": "Private health insurance employee contribution in minor units for the selected period. Required only when health_insurance is private."
}
},
"description": "Preferred high-level German social-security assumptions. Use enums instead of raw Obolus flags. The adapter maps statutory/exempt/private choices to the legacy payroll-engine fields.",
"additionalProperties": false
}
},
"description": "Input for one-country detailed payroll calculations. Prefer country, tax_year, gross_salary, location, employee_type, tax, and social_security. Use semantic German payroll fields instead of raw engine flags. Prefer taxcompare for multi-country comparisons; legacy fields use minor currency units and are period-specific.",
"x-legacy-examples": [
{
"LZZ": 2,
"Land": "DE",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "EUR",
"Personen": [
{
"Land": "DE",
"Faktor": 1,
"Kirche": 0,
"Stjahr": 2026,
"Gehalt_ct": 583333,
"KinderPVA": 0,
"Bundesland": "Berlin",
"Geburtsjahr": 1988,
"Steuerklasse": 1,
"Kinderfreibetrag": 0,
"de_payroll_preset": "DE_STANDARD_EMPLOYEE_STATUTORY",
"Gehalt_ct_ohne_Sonst": 583333,
"Lohnzahlungszeitraum": 2,
"de_statutory_health_and_care": true,
"de_health_extra_contribution_percent": 2.5,
"de_statutory_pension_and_unemployment": true
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
},
{
"LZZ": 1,
"Land": "DE",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "EUR",
"Personen": [
{
"Land": "DE",
"Faktor": 1,
"Kirche": 0,
"Stjahr": 2026,
"Gehalt_ct": 7000000,
"KinderPVA": 0,
"Bundesland": "Berlin",
"Geburtsjahr": 1988,
"Steuerklasse": 1,
"Kinderfreibetrag": 0,
"de_payroll_preset": "DE_STANDARD_EMPLOYEE_STATUTORY",
"Gehalt_ct_ohne_Sonst": 7000000,
"Lohnzahlungszeitraum": 1,
"de_statutory_health_and_care": true,
"de_health_extra_contribution_percent": 2.5,
"de_statutory_pension_and_unemployment": true
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
},
{
"LZZ": 2,
"Land": "DE",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "EUR",
"Personen": [
{
"Land": "DE",
"Faktor": 1,
"Kirche": 0,
"Stjahr": 2026,
"Gehalt_ct": 583333,
"KinderPVA": 0,
"Bundesland": "Berlin",
"Geburtsjahr": 1988,
"Steuerklasse": 1,
"Kinderfreibetrag": 0,
"de_payroll_preset": "DE_PRIVATE_HEALTH_INSURANCE",
"Gehalt_ct_ohne_Sonst": 583333,
"Lohnzahlungszeitraum": 2,
"de_statutory_health_and_care": false,
"de_health_extra_contribution_percent": 0,
"de_statutory_pension_and_unemployment": true,
"de_private_health_employee_contribution_ct": 45000
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
},
{
"LZZ": 2,
"Land": "AT",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "EUR",
"Personen": [
{
"Land": "AT",
"Faktor": 1,
"Stjahr": 2026,
"Gehalt_ct": 500000,
"Bundesland": "Wien",
"Pendler_KM": 0,
"Geburtsjahr": 1988,
"pendlerEuro": 0,
"Pendler_Tage": 0,
"Steuerklasse": 1,
"Kinderfreibetrag": 0,
"Pendler_Zumutbar": 0,
"PreTax_Deduction_ct": 0,
"Gehalt_ct_ohne_Sonst": 500000,
"Lohnzahlungszeitraum": 2
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
},
{
"LZZ": 1,
"Land": "CH",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "CHF",
"Personen": [
{
"Land": "CH",
"Faktor": 1,
"Stjahr": 2026,
"Gehalt_ct": 10000000,
"Bundesland": "Zürich",
"Geburtsjahr": 1988,
"Steuerklasse": 1,
"Kinderfreibetrag": 0,
"PreTax_Deduction_ct": 0,
"Gehalt_ct_ohne_Sonst": 10000000,
"Lohnzahlungszeitraum": 1
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
},
{
"LZZ": 1,
"Land": "US",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "USD",
"Personen": [
{
"Land": "US",
"Faktor": 1,
"Stjahr": 2026,
"Gehalt_ct": 9000000,
"Bundesland": "California",
"Geburtsjahr": 1988,
"Steuerklasse": 1,
"Freibetrag_AG": 0,
"Kinderfreibetrag": 0,
"Sonstige_Bezuege": 0,
"PreTax_Deduction_ct": 0,
"Gehalt_ct_ohne_Sonst": 9000000,
"Lohnzahlungszeitraum": 1
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
},
{
"LZZ": 1,
"Land": "UK",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "GBP",
"Personen": [
{
"Land": "UK",
"Faktor": 1,
"Stjahr": 2026,
"Gehalt_ct": 6000000,
"Bundesland": "England",
"Geburtsjahr": 1988,
"Steuerklasse": 1,
"Freibetrag_AG": 0,
"Kinderfreibetrag": 0,
"Sonstige_Bezuege": 0,
"Hat_Studienkredit": 0,
"PreTax_Deduction_ct": 0,
"Gehalt_ct_ohne_Sonst": 6000000,
"Lohnzahlungszeitraum": 1
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
},
{
"LZZ": 1,
"Land": "IE",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "EUR",
"Personen": [
{
"Land": "IE",
"Faktor": 1,
"Stjahr": 2026,
"Gehalt_ct": 7000000,
"Geburtsjahr": 1988,
"Steuerklasse": 1,
"Kinderfreibetrag": 0,
"Sonstige_Bezuege": 0,
"Hat_Studienkredit": 0,
"PreTax_Deduction_ct": 0,
"Gehalt_ct_ohne_Sonst": 7000000,
"Lohnzahlungszeitraum": 1
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
},
{
"LZZ": 1,
"Land": "CA",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "CAD",
"Personen": [
{
"Land": "CA",
"Faktor": 1,
"Stjahr": 2026,
"Gehalt_ct": 8500000,
"Bundesland": "Ontario",
"Geburtsjahr": 1988,
"Steuerklasse": 1,
"Freibetrag_AG": 0,
"Kinderfreibetrag": 0,
"Sonstige_Bezuege": 0,
"PreTax_Deduction_ct": 0,
"Gehalt_ct_ohne_Sonst": 8500000,
"Lohnzahlungszeitraum": 1
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
},
{
"LZZ": 1,
"Land": "AU",
"Modus": 1,
"Faktor": 1,
"Stjahr": 2026,
"Currency": "AUD",
"Personen": [
{
"Land": "AU",
"Faktor": 1,
"Stjahr": 2026,
"Gehalt_ct": 9000000,
"Geburtsjahr": 1988,
"Steuerklasse": 1,
"Kinderfreibetrag": 0,
"Sonstige_Bezuege": 0,
"Hat_Studienkredit": 0,
"PreTax_Deduction_ct": 0,
"Gehalt_ct_ohne_Sonst": 9000000,
"Lohnzahlungszeitraum": 1
}
],
"KinderFRB": 0,
"KinderPVA": 0,
"Kindergeld": 0
}
],
"additionalProperties": true
}Compare annual gross, net pay, taxes, and employee social contributions across two or more supported countries. Use shared_gross for the same offer and local_median_gross for country-market benchmarks. Provide tax_year and at least two countries. Use berechne for detailed single-country payroll.
| Argument | Type | Description |
|---|---|---|
| age | integer | Adult age in the selected tax year. |
| period | string | Period for salary_ct. Use annual when salary_ct is the annual gross salary. Use monthly when salary_ct is one monthly gross salary; taxcompare annualizes it before comparing countries. annual_gross is always annual and ignores this field. |
| regions | object | Country-keyed tax regions, for example CH: ZH. Omitted regions use country defaults, reported in calculation_profile. |
| children | integer | Number of children or dependents used as a broad comparison assumption. Country-specific child allowance and credit rules are simplified for comparability. |
| currency* | string | Input and output currency: EUR, USD, CHF, CAD, AUD, GBP, or lower-case equivalents. Results normalize currency codes to lower-case. Unlike berechne, taxcompare prefers salary_ct for salary input and returns major currency units. |
| tax_year* | any | Tax year, for example 2026. The same tax year is applied to every selected country. |
| countries* | array | List of country tax systems to compare. Use at least two countries for a comparison. Supported values: DE, AT, CH, US, UK, IE, CA, AU. |
| salary_ct | integer | Preferred salary input for MCP calls. Salary in minor units for the selected period, for example 5000000 for EUR 50,000. With period=annual this is annual salary; with period=monthly this is monthly salary and Obolus annualizes it for the comparison. Required for shared_gross mode unless annual_gross is provided as a legacy alias. |
| gross_mode | string | Comparison basis. Use shared_gross for the same user-provided annual gross across all countries. Use local_median_gross for country-specific editorial median gross benchmarks. Defaults to shared_gross when omitted. |
| person_type | string | Broad household assumption for comparison. single maps to joint_assessment=false; married maps to joint_assessment=true unless joint_assessment is provided explicitly. For precise country-specific filing details, use berechne. |
| annual_gross | number | Backward-compatible annual gross salary alias in major currency units, not cents. Prefer salary_ct. Example: 50000 means 50,000 in the selected currency. Required for shared_gross mode only when salary_ct is not provided; optional and ignored when omitted for local_median_gross. |
| joint_assessment | boolean | Broad joint filing / joint assessment assumption for comparable country-level estimates. For precise country-specific filing details, use berechne. |
{
"type": "object",
"examples": [
{
"period": "annual",
"children": 0,
"currency": "EUR",
"tax_year": 2026,
"countries": [
"US",
"IE",
"DE",
"CA"
],
"salary_ct": 5000000,
"gross_mode": "shared_gross",
"person_type": "single",
"joint_assessment": false
},
{
"period": "annual",
"children": 0,
"currency": "EUR",
"tax_year": 2026,
"countries": [
"DE",
"AT",
"CH",
"US",
"UK",
"IE",
"CA",
"AU"
],
"salary_ct": 7000000,
"gross_mode": "shared_gross",
"person_type": "single",
"joint_assessment": false
},
{
"period": "annual",
"children": 0,
"currency": "eur",
"tax_year": 2026,
"countries": [
"DE",
"AT",
"CH",
"US",
"UK",
"IE",
"CA",
"AU"
],
"gross_mode": "local_median_gross",
"joint_assessment": false
}
],
"required": [
"countries",
"currency",
"tax_year"
],
"properties": {
"age": {
"type": "integer",
"default": 35,
"maximum": 100,
"minimum": 18,
"description": "Adult age in the selected tax year."
},
"period": {
"enum": [
"annual",
"monthly"
],
"type": "string",
"default": "annual",
"description": "Period for salary_ct. Use annual when salary_ct is the annual gross salary. Use monthly when salary_ct is one monthly gross salary; taxcompare annualizes it before comparing countries. annual_gross is always annual and ignores this field."
},
"regions": {
"type": "object",
"description": "Country-keyed tax regions, for example CH: ZH. Omitted regions use country defaults, reported in calculation_profile.",
"additionalProperties": {
"type": "string"
}
},
"children": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Number of children or dependents used as a broad comparison assumption. Country-specific child allowance and credit rules are simplified for comparability."
},
"currency": {
"enum": [
"eur",
"usd",
"chf",
"cad",
"aud",
"gbp",
"EUR",
"USD",
"CHF",
"CAD",
"AUD",
"GBP"
],
"type": "string",
"description": "Input and output currency: EUR, USD, CHF, CAD, AUD, GBP, or lower-case equivalents. Results normalize currency codes to lower-case. Unlike berechne, taxcompare prefers salary_ct for salary input and returns major currency units."
},
"tax_year": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
],
"description": "Tax year, for example 2026. The same tax year is applied to every selected country."
},
"countries": {
"type": "array",
"items": {
"enum": [
"DE",
"AT",
"US",
"CH",
"CA",
"AU",
"UK",
"IE"
],
"type": "string"
},
"minItems": 2,
"description": "List of country tax systems to compare. Use at least two countries for a comparison. Supported values: DE, AT, CH, US, UK, IE, CA, AU."
},
"salary_ct": {
"type": "integer",
"minimum": 0,
"description": "Preferred salary input for MCP calls. Salary in minor units for the selected period, for example 5000000 for EUR 50,000. With period=annual this is annual salary; with period=monthly this is monthly salary and Obolus annualizes it for the comparison. Required for shared_gross mode unless annual_gross is provided as a legacy alias."
},
"gross_mode": {
"enum": [
"shared_gross",
"local_median_gross"
],
"type": "string",
"default": "shared_gross",
"description": "Comparison basis. Use shared_gross for the same user-provided annual gross across all countries. Use local_median_gross for country-specific editorial median gross benchmarks. Defaults to shared_gross when omitted."
},
"person_type": {
"enum": [
"single",
"married"
],
"type": "string",
"default": "single",
"description": "Broad household assumption for comparison. single maps to joint_assessment=false; married maps to joint_assessment=true unless joint_assessment is provided explicitly. For precise country-specific filing details, use berechne."
},
"annual_gross": {
"type": "number",
"description": "Backward-compatible annual gross salary alias in major currency units, not cents. Prefer salary_ct. Example: 50000 means 50,000 in the selected currency. Required for shared_gross mode only when salary_ct is not provided; optional and ignored when omitted for local_median_gross."
},
"joint_assessment": {
"type": "boolean",
"default": false,
"description": "Broad joint filing / joint assessment assumption for comparable country-level estimates. For precise country-specific filing details, use berechne."
}
},
"description": "Input for a multi-country salary comparison. Use at least two countries, tax_year, and either salary_ct/annual_gross for shared_gross or local_median_gross without a salary. Results are annual major-currency estimates.",
"additionalProperties": false
}