Korean personal tax, payroll, labor, real estate and calendar calculators. Code, no LLM.
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.
Calculates statutory annual paid leave days (연차 휴가) and unused leave cash-out allowance by years of service.
Continuous service duration in completed years
Daily regular working hours (default 8)
Base ordinary hourly wage in KRW
Number of unused leave days to cash out
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http oiyo-calculations https://api.oiyo.net/mcp
Calculates statutory annual paid leave days (연차 휴가) and unused leave cash-out allowance by years of service.
| Argument | Type | Description |
|---|---|---|
| dailyHours | number | Daily regular working hours (default 8) |
| hourlyWage | number | Base ordinary hourly wage in KRW |
| unusedDays | number | Number of unused leave days to cash out |
| yearsOfService* | number | Continuous service duration in completed years |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"yearsOfService"
],
"properties": {
"dailyHours": {
"type": "number",
"description": "Daily regular working hours (default 8)"
},
"hourlyWage": {
"type": "number",
"description": "Base ordinary hourly wage in KRW"
},
"unusedDays": {
"type": "number",
"description": "Number of unused leave days to cash out"
},
"yearsOfService": {
"type": "number",
"description": "Continuous service duration in completed years"
}
},
"additionalProperties": false
}Calculates Compound Annual Growth Rate (CAGR, 연평균 복합 성장률), total ROI, and Rule of 72 milestone.
| Argument | Type | Description |
|---|---|---|
| years* | number | Investment or operational time horizon in years |
| finalValue* | number | Final asset value or future valuation |
| initialValue* | number | Initial investment or starting asset amount |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"initialValue",
"finalValue",
"years"
],
"properties": {
"years": {
"type": "number",
"description": "Investment or operational time horizon in years"
},
"finalValue": {
"type": "number",
"description": "Final asset value or future valuation"
},
"initialValue": {
"type": "number",
"description": "Initial investment or starting asset amount"
}
},
"additionalProperties": false
}Calculates South Korea Real Estate Capital Gains Tax with 1-home 1.2 billion KRW exemption, high-value house apportionment, and up to 80% special long-term holding deduction.
| Argument | Type | Description |
|---|---|---|
| expenses | number | Necessary capital expenses (brokerage, remodel, acquisition tax) in KRW |
| houseType | any | Taxation category |
| holdingYears | number | Holding period in years |
| transferPrice* | number | Selling / transfer price in KRW |
| residenceYears | number | Actual residence period in years |
| acquisitionPrice* | number | Buying / acquisition price in KRW |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"transferPrice",
"acquisitionPrice"
],
"properties": {
"expenses": {
"type": "number",
"description": "Necessary capital expenses (brokerage, remodel, acquisition tax) in KRW"
},
"houseType": {
"anyOf": [
{
"type": "string",
"const": "1home_exempt"
},
{
"type": "string",
"const": "1home_non_exempt"
},
{
"type": "string",
"const": "multi_general"
}
],
"description": "Taxation category"
},
"holdingYears": {
"type": "number",
"description": "Holding period in years"
},
"transferPrice": {
"type": "number",
"description": "Selling / transfer price in KRW"
},
"residenceYears": {
"type": "number",
"description": "Actual residence period in years"
},
"acquisitionPrice": {
"type": "number",
"description": "Buying / acquisition price in KRW"
}
},
"additionalProperties": false
}Calculates South Korea 2026 year-end card tax deduction, 25% threshold, credit (15%) vs check (30%) rates, and golden ratio strategy.
| Argument | Type | Description |
|---|---|---|
| children | number | Number of child/grandchild dependents (2026 base limit rises by child count, 2+ capped) |
| annualSalary* | number | Gross annual salary (비과세 제외) in KRW |
| cultureSpend | number | Book, performing arts, museum spending in KRW |
| checkCardSpend | number | Annual check/debit card and cash receipt spending in KRW |
| creditCardSpend | number | Annual credit card spending in KRW |
| publicTransitSpend | number | Public transit spending in KRW (40%) |
| traditionalMarketSpend | number | Traditional market spending in KRW (40%) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"annualSalary"
],
"properties": {
"children": {
"type": "number",
"description": "Number of child/grandchild dependents (2026 base limit rises by child count, 2+ capped)"
},
"annualSalary": {
"type": "number",
"description": "Gross annual salary (비과세 제외) in KRW"
},
"cultureSpend": {
"type": "number",
"description": "Book, performing arts, museum spending in KRW"
},
"checkCardSpend": {
"type": "number",
"description": "Annual check/debit card and cash receipt spending in KRW"
},
"creditCardSpend": {
"type": "number",
"description": "Annual credit card spending in KRW"
},
"publicTransitSpend": {
"type": "number",
"description": "Public transit spending in KRW (40%)"
},
"traditionalMarketSpend": {
"type": "number",
"description": "Traditional market spending in KRW (40%)"
}
},
"additionalProperties": false
}Simulates compound interest growth with initial principal, annual yield, recurring monthly contributions, and annual balance trajectory.
| Argument | Type | Description |
|---|---|---|
| rate* | number | Annual return / interest rate in percent (e.g. 7 for 7%) |
| years* | number | Investment duration in years (maximum 100) |
| principal* | number | Initial lump sum principal investment amount in KRW or local currency |
| monthlyContribution | number | Optional monthly recurring savings or investment amount |
| compoundingFrequency | any | Compounding cycle (default monthly) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"principal",
"rate",
"years"
],
"properties": {
"rate": {
"type": "number",
"description": "Annual return / interest rate in percent (e.g. 7 for 7%)"
},
"years": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Investment duration in years (maximum 100)"
},
"principal": {
"type": "number",
"description": "Initial lump sum principal investment amount in KRW or local currency"
},
"monthlyContribution": {
"type": "number",
"description": "Optional monthly recurring savings or investment amount"
},
"compoundingFrequency": {
"anyOf": [
{
"type": "string",
"const": "monthly"
},
{
"type": "string",
"const": "annually"
}
],
"description": "Compounding cycle (default monthly)"
}
},
"additionalProperties": false
}Calculates South Korea residential city gas invoice amount based on cubic meters used and heating/cooking tariff.
| Argument | Type | Description |
|---|---|---|
| type | any | Usage tariff type (default heating) |
| usageM3* | number | Gas meter volume in cubic meters (m³) |
| calorific | number | Optional regional average calorific value in MJ/m³ (default 42.8) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"usageM3"
],
"properties": {
"type": {
"anyOf": [
{
"type": "string",
"const": "heating"
},
{
"type": "string",
"const": "cooking"
}
],
"description": "Usage tariff type (default heating)"
},
"usageM3": {
"type": "number",
"description": "Gas meter volume in cubic meters (m³)"
},
"calorific": {
"type": "number",
"description": "Optional regional average calorific value in MJ/m³ (default 42.8)"
}
},
"additionalProperties": false
}Calculates Korean regional insurance premiums and preliminary income/property flags only. dependentEligibility.isEligible is null: family support, spouse/sibling conditions, housing rental income and statutory exceptions require NHIS review.
| Argument | Type | Description |
|---|---|---|
| age | number | Candidate age (sibling test: under 30 or 65+) |
| isMarried | boolean | Candidate is married (both spouses must meet the income test) |
| otherIncome | number | Other annual income (근로/연금 등) in KRW |
| relationship | any | Candidate's relationship to the employee (default unknown) |
| businessIncome | number | Annual business income (사업소득금액) in KRW |
| financialIncome | number | Annual financial income (이자/배당소득) in KRW |
| propertyTaxBase | number | Property tax base (재산세 과세표준) in KRW |
| siblingUnmarried | boolean | Sibling is unmarried (divorced/widowed counts as unmarried) |
Calculates South Korea 2026 statutory inheritance and gift tax, progressive tax brackets (10-50%), relationship deductions, and voluntary filing discount.
| Argument | Type | Description |
|---|---|---|
| mode | any | Calculation mode |
| debtValue | number | Liabilities or debts assumed in KRW |
| hasSpouse | boolean | Whether surviving spouse exists (inheritance mode only) |
| assetValue* | number | Gross market value of assets in KRW |
| relationship | any | Beneficiary relationship |
| spouseDeduction | number | Inheritance mode: spouse deduction in KRW, clamped to 500,000,000-3,000,000,000 (default 500,000,000) |
| isMinorRecipient | boolean | Recipient is a minor (defaults to relationship child_minor) |
| isGenerationSkipping | boolean | Generation skipping surcharge (30%; 40% when a minor receives over 2,000,000,000 KRW) |
South Korea 2026 housing acquisition tax (주택 취득세) with local education tax and rural special tax: 1-3% standard rate (6-900M KRW sliding formula) or 8%/12% multi-home surcharge. Same formulas as tools.oiyo.net. Returns statute basis; does not judge house counts or first-home relief.
| Argument | Type | Description |
|---|---|---|
| price* | number | Purchase price in KRW |
| houses | any | Household houses including this one (4 = four or more), default 1 |
| over85 | boolean | Exclusive area over 85 square meters (rural special tax applies) |
| taxYear | any | Only 2026 is supported |
| regulated | boolean | The house is in an adjustment target area (조정대상지역) |
| temporaryTwo | boolean | Temporary two-home case: the previous home will be sold within the deadline |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"price"
],
"properties": {
"price": {
"type": "number",
"minimum": 0,
"description": "Purchase price in KRW"
},
"houses": {
"anyOf": [
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"type": "number",
"const": 3
},
{
"type": "number",
"const": 4
}
],
"description": "Household houses including this one (4 = four or more), default 1"
},
"over85": {
"type": "boolean",
"description": "Exclusive area over 85 square meters (rural special tax applies)"
},
"taxYear": {
"anyOf": [
{
"type": "number",
"const": 2026
}
],
"description": "Only 2026 is supported"
},
"regulated": {
"type": "boolean",
"description": "The house is in an adjustment target area (조정대상지역)"
},
"temporaryTwo": {
"type": "boolean",
"description": "Temporary two-home case: the previous home will be sold within the deadline"
}
},
"additionalProperties": false
}South Korea freelancer (3.3% withholding, 사업소득) May comprehensive income tax estimate: simple expense rate 940909 (64.1%, 49.7% above 40M KRW) or a given expense ratio, compared with the tax already withheld to show refund or extra payment. Same formulas as tools.oiyo.net. Tax years 2025 and 2026 only; refuses unknown inputs.
| Argument | Type | Description |
|---|---|---|
| people | integer | Basic deduction persons including self (default 1) |
| revenue* | number | Annual gross freelance revenue before 3.3% withholding in KRW |
| taxYear | any | Tax year (귀속연도), default 2026 |
| expenseRate | number | Expense ratio between 0 and 1 (e.g. 0.3). Omit to use the 940909 simple expense rate |
| pensionPremium | number | National pension contributions paid in KRW |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"revenue"
],
"properties": {
"people": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Basic deduction persons including self (default 1)"
},
"revenue": {
"type": "number",
"minimum": 0,
"description": "Annual gross freelance revenue before 3.3% withholding in KRW"
},
"taxYear": {
"anyOf": [
{
"type": "number",
"const": 2025
},
{
"type": "number",
"const": 2026
}
],
"description": "Tax year (귀속연도), default 2026"
},
"expenseRate": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Expense ratio between 0 and 1 (e.g. 0.3). Omit to use the 940909 simple expense rate"
},
"pensionPremium": {
"type": "number",
"minimum": 0,
"description": "National pension contributions paid in KRW"
}
},
"additionalProperties": false
}South Korea 2026 housing property tax (주택 재산세) from the official price: fair market value ratio (43-45% for one-home households, 60% otherwise), one-home special rate up to 900M KRW, urban area tax and local education tax. Same formulas as tools.oiyo.net. Excludes comprehensive real estate holding tax and the burden cap.
| Argument | Type | Description |
|---|---|---|
| taxYear | any | Only 2026 is supported |
| oneHouse | boolean | One house per household (1세대1주택), default true |
| urbanArea | boolean | Inside an urban planning area (도시지역분 0.14%), default true |
| officialPrice* | number | Official housing price (공시가격) in KRW |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"officialPrice"
],
"properties": {
"taxYear": {
"anyOf": [
{
"type": "number",
"const": 2026
}
],
"description": "Only 2026 is supported"
},
"oneHouse": {
"type": "boolean",
"description": "One house per household (1세대1주택), default true"
},
"urbanArea": {
"type": "boolean",
"description": "Inside an urban planning area (도시지역분 0.14%), default true"
},
"officialPrice": {
"type": "number",
"minimum": 0,
"description": "Official housing price (공시가격) in KRW"
}
},
"additionalProperties": false
}South Korea 2026 귀속 year-end tax settlement (연말정산) for a resident wage earner: income deductions, card deduction, special deductions/credits vs the 130,000 KRW standard credit (picks the lower tax), refund or extra payment when withheld tax is given. Same formulas as tools.oiyo.net. Refuses unknown inputs and tax years other than 2026; returns statute basis and what is not covered. Estimate, not tax advice.
| Argument | Type | Description |
|---|---|---|
| irp | number | IRP / DC personal contributions in KRW |
| rent | number | Monthly rent paid for the year in KRW |
| salary* | number | Gross annual salary excluding non-taxable pay (총급여) in KRW |
| medical | number | Medical expenses for general dependents in KRW (7M cap) |
| persons | integer | Basic deduction persons including self (기본공제 인원, default 1) |
| seniors | integer | Dependents aged 70+ (경로우대 추가공제 인원) |
| taxYear | any | Tax year (귀속연도). Only 2026 is supported |
| donation | number |
Calculates loan refinancing savings, prepayment penalty fees with 3-year sliding taper, and break-even point in months.
| Argument | Type | Description |
|---|---|---|
| newRate* | number | New loan annual interest rate in % |
| currentRate* | number | Existing loan annual interest rate in % |
| loanBalance* | number | Remaining loan balance in KRW |
| penaltyRate | number | Prepayment penalty rate in % from the loan contract (example default 1.2; actual rates vary by product) |
| elapsedMonths | number | Months elapsed since loan origination (0-36) |
| incidentalCosts | number | Incidental refinancing fees in KRW |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"loanBalance",
"currentRate",
"newRate"
],
"properties": {
"newRate": {
"type": "number",
"description": "New loan annual interest rate in %"
},
"currentRate": {
"type": "number",
"description": "Existing loan annual interest rate in %"
},
"loanBalance": {
"type": "number",
"description": "Remaining loan balance in KRW"
},
"penaltyRate": {
"type": "number",
"description": "Prepayment penalty rate in % from the loan contract (example default 1.2; actual rates vary by product)"
},
"elapsedMonths": {
"type": "number",
"description": "Months elapsed since loan origination (0-36)"
},
"incidentalCosts": {
"type": "number",
"description": "Incidental refinancing fees in KRW"
}
},
"additionalProperties": false
}Calculates South Korea mandatory military service duration, completion rate, remaining days, and rank promotion dates.
| Argument | Type | Description |
|---|---|---|
| branch | any | Military branch (default army 18m) |
| currentDate | string | Reference evaluation date (default today) |
| enlistmentDate* | string | Enlistment date in YYYY-MM-DD |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"enlistmentDate"
],
"properties": {
"branch": {
"anyOf": [
{
"type": "string",
"const": "army"
},
{
"type": "string",
"const": "marines"
},
{
"type": "string",
"const": "navy"
},
{
"type": "string",
"const": "airforce"
},
{
"type": "string",
"const": "public"
}
],
"description": "Military branch (default army 18m)"
},
"currentDate": {
"type": "string",
"maxLength": 200,
"description": "Reference evaluation date (default today)"
},
"enlistmentDate": {
"type": "string",
"maxLength": 200,
"description": "Enlistment date in YYYY-MM-DD"
}
},
"additionalProperties": false
}Calculates net monthly take-home salary after the 4 major social insurances (2026 statutory rates) and an ESTIMATED income tax (annualized estimate, not the NTS withholding table) in South Korea.
| Argument | Type | Description |
|---|---|---|
| salary* | number | Gross monthly or annual salary in KRW |
| isAnnual | boolean | True if salary parameter is annual base pay |
| dependents | integer | Number of dependents including self (default 1) |
| nonTaxable | number | Monthly non-taxable amount (meal subsidy etc., default 200,000 KRW) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"salary"
],
"properties": {
"salary": {
"type": "number",
"description": "Gross monthly or annual salary in KRW"
},
"isAnnual": {
"type": "boolean",
"description": "True if salary parameter is annual base pay"
},
"dependents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Number of dependents including self (default 1)"
},
"nonTaxable": {
"type": "number",
"description": "Monthly non-taxable amount (meal subsidy etc., default 200,000 KRW)"
}
},
"additionalProperties": false
}Calculates statutory overtime, night, and holiday allowances under Korean Labor Standards Act.
| Argument | Type | Description |
|---|---|---|
| hourlyWage* | number | Base ordinary hourly wage in KRW |
| nightHours | number | Night hours worked between 22:00 and 06:00 (additional 0.5x) |
| overtimeHours | number | Overtime hours exceeding 8h/day or 40h/week (1.5x) |
| holidayHoursOver8 | number | Holiday hours exceeding 8 hours (2.0x) |
| holidayHours8orLess | number | Holiday hours up to 8 hours (1.5x) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"hourlyWage"
],
"properties": {
"hourlyWage": {
"type": "number",
"description": "Base ordinary hourly wage in KRW"
},
"nightHours": {
"type": "number",
"description": "Night hours worked between 22:00 and 06:00 (additional 0.5x)"
},
"overtimeHours": {
"type": "number",
"description": "Overtime hours exceeding 8h/day or 40h/week (1.5x)"
},
"holidayHoursOver8": {
"type": "number",
"description": "Holiday hours exceeding 8 hours (2.0x)"
},
"holidayHours8orLess": {
"type": "number",
"description": "Holiday hours up to 8 hours (1.5x)"
}
},
"additionalProperties": false
}Computes traditional Korean Sexagenary Cycle (60 Gapja) Four Pillars and Five Elements (오행) balance from birth datetime and solar/lunar calendar.
| Argument | Type | Description |
|---|---|---|
| day* | integer | Birth day (1-31) |
| hour | integer | Birth hour (0-23, optional) |
| year* | integer | Birth year |
| month* | integer | Birth month (1-12) |
| minute | integer | Birth minute (0-59, optional) |
| isLunar | boolean | True if lunar calendar |
| isLeapMonth | boolean | True if lunar leap month |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"year",
"month",
"day"
],
"properties": {
"day": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Birth day (1-31)"
},
"hour": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Birth hour (0-23, optional)"
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Birth year"
},
"month": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Birth month (1-12)"
},
"minute": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Birth minute (0-59, optional)"
},
"isLunar": {
"type": "boolean",
"description": "True if lunar calendar"
},
"isLeapMonth": {
"type": "boolean",
"description": "True if lunar leap month"
}
},
"additionalProperties": false
}South Korean statutory severance arithmetic. Unknown or mixed four-week hours return null eligibility and amount; all-period self-confirmation is required for an estimate.
| Argument | Type | Description |
|---|---|---|
| endDate* | string | Resignation/leaving date in YYYY-MM-DD |
| startDate* | string | Enlistment/joining date in YYYY-MM-DD |
| annualBonus | number | Annual bonus paid during previous year in KRW |
| threeMonthSalary* | number | Total gross base salary received during last 3 months in KRW |
| annualLeaveAllowance | number | Annual unused leave cash-out allowance in KRW |
| weeklyHoursCondition | any | Whole service period four-week contractual hours, not hours in the last week |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"startDate",
"endDate",
"threeMonthSalary"
],
"properties": {
"endDate": {
"type": "string",
"maxLength": 200,
"description": "Resignation/leaving date in YYYY-MM-DD"
},
"startDate": {
"type": "string",
"maxLength": 200,
"description": "Enlistment/joining date in YYYY-MM-DD"
},
"annualBonus": {
"type": "number",
"description": "Annual bonus paid during previous year in KRW"
},
"threeMonthSalary": {
"type": "number",
"description": "Total gross base salary received during last 3 months in KRW"
},
"annualLeaveAllowance": {
"type": "number",
"description": "Annual unused leave cash-out allowance in KRW"
},
"weeklyHoursCondition": {
"anyOf": [
{
"type": "string",
"const": "all_at_least_15"
},
{
"type": "string",
"const": "all_below_15"
},
{
"type": "string",
"const": "mixed"
},
{
"type": "string",
"const": "unknown"
}
],
"description": "Whole service period four-week contractual hours, not hours in the last week"
}
},
"additionalProperties": false
}Simulates statutory South Korean unemployment benefits (실업급여) duration, daily benefit rate, and total expected payout.
| Argument | Type | Description |
|---|---|---|
| age* | any | Whether age is under 50 ('under') or 50 and older / disabled ('over') |
| wage* | number | Pre-tax average monthly wage before dismissal in KRW |
| hours | number | Daily contractual working hours (default 8) |
| period* | any | Employment insurance contribution period bracket |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"wage",
"age",
"period"
],
"properties": {
"age": {
"anyOf": [
{
"type": "string",
"const": "under"
},
{
"type": "string",
"const": "over"
}
],
"description": "Whether age is under 50 ('under') or 50 and older / disabled ('over')"
},
"wage": {
"type": "number",
"description": "Pre-tax average monthly wage before dismissal in KRW"
},
"hours": {
"type": "number",
"description": "Daily contractual working hours (default 8)"
},
"period": {
"anyOf": [
{
"type": "string",
"const": "p1"
},
{
"type": "string",
"const": "p3"
},
{
"type": "string",
"const": "p5"
},
{
"type": "string",
"const": "p10"
},
{
"type": "string",
"const": "p10plus"
}
],
"description": "Employment insurance contribution period bracket"
}
},
"additionalProperties": false
}Calculates statutory South Korean weekly holiday allowance (주휴수당) for part-time and hourly workers.
| Argument | Type | Description |
|---|---|---|
| tax | any | Tax deduction option |
| hours* | number | Contractual working hours per week (must be >= 15 for allowance) |
| hourlyWage* | number | Hourly wage in KRW (2026 minimum wage: 10,320 KRW) |
| employedWholeWeek | boolean | Explicitly confirm employment through the entire applicable week |
| completedScheduledDays | boolean | Explicitly confirm attendance on all scheduled working days |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"hourlyWage",
"hours"
],
"properties": {
"tax": {
"anyOf": [
{
"type": "string",
"const": "none"
},
{
"type": "string",
"const": "income33"
},
{
"type": "string",
"const": "fourMajor"
}
],
"description": "Tax deduction option"
},
"hours": {
"type": "number",
"description": "Contractual working hours per week (must be >= 15 for allowance)"
},
"hourlyWage": {
"type": "number",
"description": "Hourly wage in KRW (2026 minimum wage: 10,320 KRW)"
},
"employedWholeWeek": {
"type": "boolean",
"description": "Explicitly confirm employment through the entire applicable week"
},
"completedScheduledDays": {
"type": "boolean",
"description": "Explicitly confirm attendance on all scheduled working days"
}
},
"additionalProperties": false
}Determines if a given date is a South Korea working business day or a public holiday/weekend.
| Argument | Type | Description |
|---|---|---|
| date* | string | Date in YYYY-MM-DD format |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"date"
],
"properties": {
"date": {
"type": "string",
"maxLength": 200,
"description": "Date in YYYY-MM-DD format"
}
},
"additionalProperties": false
}Compares South Korea Value-Added Tax (VAT) between General Taxpayer (10% with full deduction/refund) and Simplified Taxpayer (15-40% value-added rate, 48M exemption, no refund).
| Argument | Type | Description |
|---|---|---|
| revenue* | number | Annual gross revenue (공급대가, VAT-inclusive) in KRW |
| purchase | number | Annual gross purchases with tax invoices in KRW |
| industryType | any | Industry classification |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"revenue"
],
"properties": {
"revenue": {
"type": "number",
"description": "Annual gross revenue (공급대가, VAT-inclusive) in KRW"
},
"purchase": {
"type": "number",
"description": "Annual gross purchases with tax invoices in KRW"
},
"industryType": {
"anyOf": [
{
"type": "string",
"const": "food_retail"
},
{
"type": "string",
"const": "manufacturing"
},
{
"type": "string",
"const": "construction_logistics"
},
{
"type": "string",
"const": "service"
},
{
"type": "string",
"const": "real_estate_professional"
}
],
"description": "Industry classification"
}
},
"additionalProperties": false
}Universal deterministic unit conversion for area (pyeong ↔ m², sqft, ha), length, mass, and temperature.
| Argument | Type | Description |
|---|---|---|
| to* | string | Target unit (e.g. 'm2', 'pyeong', 'ft', 'inch', 'lb', 'f', 'c') |
| from* | string | Source unit (e.g. 'pyeong', 'm2', 'sqft', 'kg', 'lb', 'c', 'f') |
| value* | number | Numeric quantity to convert |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"value",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"maxLength": 200,
"description": "Target unit (e.g. 'm2', 'pyeong', 'ft', 'inch', 'lb', 'f', 'c')"
},
"from": {
"type": "string",
"maxLength": 200,
"description": "Source unit (e.g. 'pyeong', 'm2', 'sqft', 'kg', 'lb', 'c', 'f')"
},
"value": {
"type": "number",
"description": "Numeric quantity to convert"
}
},
"additionalProperties": false
}Diagnoses HUG Jeonse Deposit Return Guarantee eligibility (126% rule, 60% senior debt limit, 90% debt ratio limit) and calculates statutory guarantee fee.
| Argument | Type | Description |
|---|---|---|
| seniorDebt | number | Senior lien / mortgage amount (선순위 채권액) in KRW |
| termMonths | number | Lease term in months (default 24) |
| discountType | any | Statutory fee discount type |
| propertyType | any | Type of property |
| jeonseDeposit* | number | Jeonse deposit amount (전세보증금) in KRW |
| officialPrice* | number | Publicly declared housing price (공시가격) in KRW |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"officialPrice",
"jeonseDeposit"
],
"properties": {
"seniorDebt": {
"type": "number",
"description": "Senior lien / mortgage amount (선순위 채권액) in KRW"
},
"termMonths": {
"type": "number",
"description": "Lease term in months (default 24)"
},
"discountType": {
"anyOf": [
{
"type": "string",
"const": "none"
},
{
"type": "string",
"const": "youth"
},
{
"type": "string",
"const": "newlywed"
},
{
"type": "string",
"const": "multi-child"
}
],
"description": "Statutory fee discount type"
},
"propertyType": {
"anyOf": [
{
"type": "string",
"const": "apartment"
},
{
"type": "string",
"const": "villa"
}
],
"description": "Type of property"
},
"jeonseDeposit": {
"type": "number",
"description": "Jeonse deposit amount (전세보증금) in KRW"
},
"officialPrice": {
"type": "number",
"description": "Publicly declared housing price (공시가격) in KRW"
}
},
"additionalProperties": false
}Get official South Korea public holidays, substitute holidays, and solar terms for a given year.
| Argument | Type | Description |
|---|---|---|
| year* | integer | Calendar year (e.g. 2026) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"year"
],
"properties": {
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Calendar year (e.g. 2026)"
}
},
"additionalProperties": false
}Verified Korean minimum wage by year, effective dates and 8/209-hour examples. Not a 2027 net-salary calculator; uncollected insurance is unavailable.
| Argument | Type | Description |
|---|---|---|
| year | any | Korean applicable year; omission uses Asia/Seoul current year |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"year": {
"anyOf": [
{
"type": "number",
"const": 2026
},
{
"type": "number",
"const": 2027
}
],
"description": "Korean applicable year; omission uses Asia/Seoul current year"
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 9, 2026.
| isDisabledOrMerit |
| boolean |
| Registered disabled person, national merit or veteran-compensation wounded (business income up to 5M allowed regardless of registration) |
| hasHousingRentalIncome | boolean | Business income includes housing rental income (treated as registered even without registration) |
| hasBusinessRegistration | boolean | Whether registered as a business owner |
| spouseMeetsIncomeCriteria | boolean | For a married candidate: spouse also meets the income test |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"age": {
"type": "number",
"description": "Candidate age (sibling test: under 30 or 65+)"
},
"isMarried": {
"type": "boolean",
"description": "Candidate is married (both spouses must meet the income test)"
},
"otherIncome": {
"type": "number",
"description": "Other annual income (근로/연금 등) in KRW"
},
"relationship": {
"anyOf": [
{
"type": "string",
"const": "spouse"
},
{
"type": "string",
"const": "lineal_ascendant"
},
{
"type": "string",
"const": "lineal_descendant"
},
{
"type": "string",
"const": "sibling"
},
{
"type": "string",
"const": "unknown"
}
],
"description": "Candidate's relationship to the employee (default unknown)"
},
"businessIncome": {
"type": "number",
"description": "Annual business income (사업소득금액) in KRW"
},
"financialIncome": {
"type": "number",
"description": "Annual financial income (이자/배당소득) in KRW"
},
"propertyTaxBase": {
"type": "number",
"description": "Property tax base (재산세 과세표준) in KRW"
},
"siblingUnmarried": {
"type": "boolean",
"description": "Sibling is unmarried (divorced/widowed counts as unmarried)"
},
"isDisabledOrMerit": {
"type": "boolean",
"description": "Registered disabled person, national merit or veteran-compensation wounded (business income up to 5M allowed regardless of registration)"
},
"hasHousingRentalIncome": {
"type": "boolean",
"description": "Business income includes housing rental income (treated as registered even without registration)"
},
"hasBusinessRegistration": {
"type": "boolean",
"description": "Whether registered as a business owner"
},
"spouseMeetsIncomeCriteria": {
"type": "boolean",
"description": "For a married candidate: spouse also meets the income test"
}
},
"additionalProperties": false
}| hasVoluntaryReporting |
| boolean |
| 3% voluntary filing tax credit |
| marriageBirthDeduction | number | Gift from lineal ascendant only: marriage/birth deduction to apply in KRW (lifetime max 100,000,000) |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"assetValue"
],
"properties": {
"mode": {
"anyOf": [
{
"type": "string",
"const": "gift"
},
{
"type": "string",
"const": "inheritance"
}
],
"description": "Calculation mode"
},
"debtValue": {
"type": "number",
"description": "Liabilities or debts assumed in KRW"
},
"hasSpouse": {
"type": "boolean",
"description": "Whether surviving spouse exists (inheritance mode only)"
},
"assetValue": {
"type": "number",
"description": "Gross market value of assets in KRW"
},
"relationship": {
"anyOf": [
{
"type": "string",
"const": "spouse"
},
{
"type": "string",
"const": "child_adult"
},
{
"type": "string",
"const": "child_minor"
},
{
"type": "string",
"const": "parent"
},
{
"type": "string",
"const": "other_relative"
},
{
"type": "string",
"const": "other"
}
],
"description": "Beneficiary relationship"
},
"spouseDeduction": {
"type": "number",
"description": "Inheritance mode: spouse deduction in KRW, clamped to 500,000,000-3,000,000,000 (default 500,000,000)"
},
"isMinorRecipient": {
"type": "boolean",
"description": "Recipient is a minor (defaults to relationship child_minor)"
},
"isGenerationSkipping": {
"type": "boolean",
"description": "Generation skipping surcharge (30%; 40% when a minor receives over 2,000,000,000 KRW)"
},
"hasVoluntaryReporting": {
"type": "boolean",
"description": "3% voluntary filing tax credit"
},
"marriageBirthDeduction": {
"type": "number",
"description": "Gift from lineal ascendant only: marriage/birth deduction to apply in KRW (lifetime max 100,000,000)"
}
},
"additionalProperties": false
}| Designated (non-religious) donations in KRW |
| marriage | boolean | Marriage registered 2024-2026 and the one-time marriage credit not yet used |
| withheld | number | Income tax withheld during the year (excluding local tax) in KRW; enables refund calculation |
| youthSme | boolean | Eligible for the SME youth employment income tax reduction |
| education | number | Eligible dependent education expenses after per-person caps in KRW |
| womanHead | boolean | 부녀자 추가공제 (income 30M KRW or less) |
| birthOrder | integer | Birth/adoption this year: 1 for first child, 2 second, 3 third or later; 0 none |
| isaTransfer | number | Matured ISA amount moved to a pension account this year in KRW |
| otherIncome | number | Other comprehensive income amount (사업·연금·기타소득금액) in KRW; turns this into a May filing approximation |
| cardChildren | integer | Children counted for the raised card deduction limit |
| cultureSpend | number | Books, performances, museums, movies, sports facilities in KRW |
| rentEligible | boolean | User confirmed the statutory rent credit requirements (homeless household head etc.) |
| singleParent | boolean | 한부모 추가공제 |
| educationSelf | number | Own education expenses in KRW |
| creditChildren | integer | Children eligible for the child tax credit (자녀세액공제) |
| debitCardSpend | number | Debit card and cash receipt spending in KRW |
| pensionSavings | number | Pension savings account contributions (연금저축) in KRW |
| creditCardSpend | number | Credit card spending in KRW |
| disabledPersons | integer | Disabled dependents including self (장애인 추가공제 인원) |
| leaseLoanRepaid | number | Jeonse loan principal and interest repaid (주택임차차입금) in KRW |
| medicalSpecific | number | Medical expenses for self, 65+, disabled, or children 6 or under in KRW (no cap) |
| nationalPension | number | National pension contributions paid by the employee in KRW |
| healthEmployment | number | Health, long-term care and employment insurance paid by the employee in KRW |
| hometownDonation | number | Hometown love donations (고향사랑기부금) in KRW |
| insurancePremium | number | Protection-type insurance premiums (보장성 보험료) in KRW |
| politicalDonation | number | Political donations in KRW |
| religiousDonation | number | Religious donations in KRW |
| publicTransitSpend | number | Public transit spending in KRW |
| traditionalMarketSpend | number | Traditional market spending in KRW |
| housingSubscriptionPaid | number | Housing subscription savings paid (주택청약종합저축) in KRW |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"salary"
],
"properties": {
"irp": {
"type": "number",
"minimum": 0,
"description": "IRP / DC personal contributions in KRW"
},
"rent": {
"type": "number",
"minimum": 0,
"description": "Monthly rent paid for the year in KRW"
},
"salary": {
"type": "number",
"minimum": 0,
"description": "Gross annual salary excluding non-taxable pay (총급여) in KRW"
},
"medical": {
"type": "number",
"minimum": 0,
"description": "Medical expenses for general dependents in KRW (7M cap)"
},
"persons": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Basic deduction persons including self (기본공제 인원, default 1)"
},
"seniors": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Dependents aged 70+ (경로우대 추가공제 인원)"
},
"taxYear": {
"anyOf": [
{
"type": "number",
"const": 2026
}
],
"description": "Tax year (귀속연도). Only 2026 is supported"
},
"donation": {
"type": "number",
"minimum": 0,
"description": "Designated (non-religious) donations in KRW"
},
"marriage": {
"type": "boolean",
"description": "Marriage registered 2024-2026 and the one-time marriage credit not yet used"
},
"withheld": {
"type": "number",
"minimum": 0,
"description": "Income tax withheld during the year (excluding local tax) in KRW; enables refund calculation"
},
"youthSme": {
"type": "boolean",
"description": "Eligible for the SME youth employment income tax reduction"
},
"education": {
"type": "number",
"minimum": 0,
"description": "Eligible dependent education expenses after per-person caps in KRW"
},
"womanHead": {
"type": "boolean",
"description": "부녀자 추가공제 (income 30M KRW or less)"
},
"birthOrder": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Birth/adoption this year: 1 for first child, 2 second, 3 third or later; 0 none"
},
"isaTransfer": {
"type": "number",
"minimum": 0,
"description": "Matured ISA amount moved to a pension account this year in KRW"
},
"otherIncome": {
"type": "number",
"minimum": 0,
"description": "Other comprehensive income amount (사업·연금·기타소득금액) in KRW; turns this into a May filing approximation"
},
"cardChildren": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Children counted for the raised card deduction limit"
},
"cultureSpend": {
"type": "number",
"minimum": 0,
"description": "Books, performances, museums, movies, sports facilities in KRW"
},
"rentEligible": {
"type": "boolean",
"description": "User confirmed the statutory rent credit requirements (homeless household head etc.)"
},
"singleParent": {
"type": "boolean",
"description": "한부모 추가공제"
},
"educationSelf": {
"type": "number",
"minimum": 0,
"description": "Own education expenses in KRW"
},
"creditChildren": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Children eligible for the child tax credit (자녀세액공제)"
},
"debitCardSpend": {
"type": "number",
"minimum": 0,
"description": "Debit card and cash receipt spending in KRW"
},
"pensionSavings": {
"type": "number",
"minimum": 0,
"description": "Pension savings account contributions (연금저축) in KRW"
},
"creditCardSpend": {
"type": "number",
"minimum": 0,
"description": "Credit card spending in KRW"
},
"disabledPersons": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Disabled dependents including self (장애인 추가공제 인원)"
},
"leaseLoanRepaid": {
"type": "number",
"minimum": 0,
"description": "Jeonse loan principal and interest repaid (주택임차차입금) in KRW"
},
"medicalSpecific": {
"type": "number",
"minimum": 0,
"description": "Medical expenses for self, 65+, disabled, or children 6 or under in KRW (no cap)"
},
"nationalPension": {
"type": "number",
"minimum": 0,
"description": "National pension contributions paid by the employee in KRW"
},
"healthEmployment": {
"type": "number",
"minimum": 0,
"description": "Health, long-term care and employment insurance paid by the employee in KRW"
},
"hometownDonation": {
"type": "number",
"minimum": 0,
"description": "Hometown love donations (고향사랑기부금) in KRW"
},
"insurancePremium": {
"type": "number",
"minimum": 0,
"description": "Protection-type insurance premiums (보장성 보험료) in KRW"
},
"politicalDonation": {
"type": "number",
"minimum": 0,
"description": "Political donations in KRW"
},
"religiousDonation": {
"type": "number",
"minimum": 0,
"description": "Religious donations in KRW"
},
"publicTransitSpend": {
"type": "number",
"minimum": 0,
"description": "Public transit spending in KRW"
},
"traditionalMarketSpend": {
"type": "number",
"minimum": 0,
"description": "Traditional market spending in KRW"
},
"housingSubscriptionPaid": {
"type": "number",
"minimum": 0,
"description": "Housing subscription savings paid (주택청약종합저축) in KRW"
}
},
"additionalProperties": false
}