# OIYO Korea Calculators (remote · api.oiyo.net)

Korean tax, payroll, labor, real estate, calendar and business strategy calculators. Code, no LLM.

- Trust score: 72/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `api.oiyo.net`: 72/100 (this document), [markdown](https://verifymcp.io/servers/yuli3-oiyo-calculations/api.md), [page](https://verifymcp.io/servers/yuli3-oiyo-calculations/api)
- remote · `api-oiyo.861106.workers.dev`: 66/100, [markdown](https://verifymcp.io/servers/yuli3-oiyo-calculations/api-oiyo.md), [page](https://verifymcp.io/servers/yuli3-oiyo-calculations/api-oiyo)

## Channel facts

- Endpoint: `https://api.oiyo.net/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.43.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 74/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Nothing on it is marked destructive, but we can't show that an anonymous caller can only read: full credit needs the server to list at least one tool and every tool to be verifiably read-only. We use a best-effort check of tool names and descriptions to tell read-only tools from tools that change things, so some genuinely read-only tools may not get full credit. Names that start with a read verb (get, list, read, search and similar) and accurate readOnlyHint annotations help. Meet that to earn full credit, or require authorisation.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 56/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 45058 tokens (~251/item across 179 items; 179 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 40/100
  - Stability observed for 12 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 8 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "calculate_overtime_pay" implies "pay" and declares readOnlyHint instead, contradicting what its own name says it does.
  - An AI judge read all 179 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the OIYO Korea Calculators MCP server?

OIYO Korea Calculators is a hosted endpoint at https://api.oiyo.net/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http yuli3-oiyo-calculations 'https://api.oiyo.net/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "yuli3-oiyo-calculations": {
      "url": "https://api.oiyo.net/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "yuli3-oiyo-calculations": {
      "type": "http",
      "url": "https://api.oiyo.net/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.yuli3-oiyo-calculations]
url = "https://api.oiyo.net/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "yuli3-oiyo-calculations": {
      "type": "remote",
      "url": "https://api.oiyo.net/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add yuli3-oiyo-calculations --url 'https://api.oiyo.net/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  yuli3-oiyo-calculations:
    url: "https://api.oiyo.net/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "yuli3-oiyo-calculations": {
      "Transport": "http",
      "Url": "https://api.oiyo.net/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add yuli3-oiyo-calculations -t streamable-http -u 'https://api.oiyo.net/mcp'
```

### Other

```json
{
  "mcpServers": {
    "yuli3-oiyo-calculations": {
      "type": "http",
      "url": "https://api.oiyo.net/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 72, 0)

- [functional regression] Schema quality: 22688 → 45058
- [functional regression] Schema quality: 22688 → 31396
- [functional regression] Schema quality: 22688 → 28808
- [functional] Server version: 1.35.0 → 1.43.0
- [functional] Server version: 1.33.0 → 1.35.0
- [functional] Server version: 1.31.0 → 1.33.0
- [functional] New tool “calculate_jp_blue_return_deduction”
- [functional] New tool “calculate_jp_appeal_deadlines”
- [functional] New tool “calculate_fr_tax_penalty”
- [functional] New tool “calculate_fr_micro_entrepreneur”
- [functional] New tool “calculate_fr_labor_exit”
- [functional] New tool “calculate_fr_depreciation”
- [functional] New tool “calculate_fr_claim_deadline”
- [functional] New tool “calculate_es_vat”
- [functional] New tool “calculate_es_tax_sanction”
- [functional] New tool “calculate_es_late_filing_surcharge”
- [functional] New tool “calculate_es_labor_exit”
- [functional] New tool “calculate_es_depreciation”
- [functional] New tool “calculate_es_autonomo_quota”
- [functional] New tool “calculate_es_appeal_deadlines”
- [functional] New tool “calculate_cn_tax_appeal_deadlines”
- [functional] New tool “calculate_cn_small_profit_cit”
- [functional] New tool “calculate_cn_business_income_tax”
- [functional] New tool “calculate_cn_comprehensive_income_tax”
- [functional] New tool “calculate_cn_depreciation”
- [functional] New tool “calculate_cn_labor_exit”
- [functional] New tool “calculate_cn_late_payment_surcharge”
- [functional] New tool “calculate_jp_depreciation”
- [functional] New tool “calculate_jp_labor_exit”
- [functional] New tool “calculate_jp_penalty_tax”
- [functional] New tool “calculate_tw_depreciation”
- [functional] New tool “calculate_tw_income_tax”
- [functional] New tool “calculate_tw_labor_exit”
- [functional] New tool “calculate_tw_late_fee”
- [functional] New tool “calculate_tw_tax_appeal_deadlines”
- [functional] New tool “calculate_uk_capital_allowances”
- [functional] New tool “calculate_uk_labor_exit”
- [functional] New tool “calculate_uk_late_payment_interest”
- [functional] New tool “calculate_uk_sa_penalty”
- [functional] New tool “calculate_uk_self_employed_tax”
- [functional] New tool “calculate_uk_tax_appeal_deadlines”
- [functional] New tool “calculate_us_depreciation”
- [functional] New tool “calculate_us_estimated_tax”
- [functional] New tool “calculate_us_irs_penalty”
- [functional] New tool “calculate_us_self_employment_tax”
- [functional] New tool “calculate_us_tax_appeal_deadlines”
- [functional] New tool “check_cn_small_scale_vat”
- [functional] New tool “check_fr_vat_franchise”
- [functional] New tool “check_jp_consumption_tax”
- [functional] New tool “check_tw_business_tax”
- [functional] New tool “check_uk_vat_registration”
- [functional] New tool “check_us_labor_rights”
- [functional] New tool “get_cn_tax_calendar”
- [functional] New tool “get_es_tax_calendar”
- [functional] New tool “get_fr_tax_calendar”
- [functional] New tool “get_jp_tax_calendar”
- [functional] New tool “get_tw_tax_calendar”
- [functional] New tool “get_uk_tax_calendar”
- [functional] New tool “get_us_tax_calendar”
- [functional] New tool “check_kr_withholding_statement”
- [functional] New tool “check_kr_serious_accident”
- [functional] New tool “check_kr_safety_staffing”
- [functional] New tool “check_kr_exempt_business_report”
- [functional] New tool “calculate_kr_student_loan_repayment”
- [functional] New tool “calculate_kr_safety_education_hours”
- [functional] New tool “calculate_kr_accident_report_deadline”
- [functional] New tool “compare_kr_private_pension_tax”
- [functional] New tool “compare_kr_bookkeeping_vs_estimate”
- [functional] New tool “calculate_kr_deferred_tax”
- [functional] New tool “build_accounting_schedule”
- [functional] New tool “calculate_kr_corporate_tax”
- [functional] New tool “calculate_kr_customs_practice”
- [functional] New tool “calculate_kr_f27_points”
- [functional] New tool “calculate_kr_inheritance_reserve”
- [functional] New tool “calculate_kr_injury_disability_benefit”
- [functional] New tool “calculate_kr_license_points”
- [functional] New tool “calculate_kr_tax_penalty”
- [functional] New tool “calculate_kr_vat_credits”
- [functional] New tool “check_kr_apartment_management”
- [functional] New tool “check_kr_court_deposit”
- [functional] New tool “check_kr_franchise_contract”
- [functional] New tool “check_kr_workforce”
- [functional] New tool “estimate_kr_appraisal_compensation”
- [functional] New tool “estimate_kr_self_registration_cost”
- [functional] New tool “find_kr_appeal_deadlines”
- [functional] New tool “plan_kr_audit_materiality_sample”
- [functional] New tool “plan_kr_ip_deadlines”
- [functional] New tool “simulate_kr_auction_distribution”

### 2026-11-20 (score 72, +1)

- [security] Tool “start_kr_law_intake” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 19336 → 22688
- [functional regression] Schema quality: 19336 → 21576
- [functional] Server version: 1.26.0 → 1.31.0
- [functional] Server version: 1.21.0 → 1.26.0
- [functional] New tool “check_kr_privacy_breach_policy”
- [functional] New tool “plan_kr_small_business_month”
- [functional] New tool “check_kr_freelance_contract”
- [functional] New tool “check_insurance_explanation_record”
- [functional] New tool “simulate_ifrs17_csm”
- [functional] New tool “plan_kr_after_death_tasks”
- [functional] New tool “get_kr_practice_guide”
- [functional] New tool “analyze_journal_entries”
- [functional] New tool “calculate_insurance_claim_payout”
- [functional] New tool “calculate_kics_ratio”
- [functional] New tool “calculate_kr_fine_reduction”
- [functional] New tool “calculate_kr_import_duty”
- [cosmetic] “get_kr_professional_scope” reworded the description of “domain”

### 2026-11-18 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 70, 0)

- [security] Tool “start_kr_law_intake” rewrote its description, which is the text the model reads
- [security] Tool “get_kr_professional_scope” rewrote its description, which is the text the model reads
- [security] Tool “search_kr_statutes” rewrote its description, which is the text the model reads
- [functional] Server version: 1.20.0 → 1.21.0
- [functional] Server version: 1.19.0 → 1.20.0
- [cosmetic] “get_kr_professional_scope” reworded the description of “domain”

### 2026-11-16 (score 70, 0)

- [functional regression] Schema quality: 183 → 223
- [functional regression] Schema quality: 183 → 206
- [functional regression] Schema quality: 6973 → 12418
- [functional regression] Schema quality: 6973 → 10967
- [functional regression] Schema quality: 6973 → 9611
- [functional] Server version: 1.14.0 → 1.19.0
- [functional] Server version: 1.11.0 → 1.14.0
- [functional] Server version: 1.9.0 → 1.11.0
- [functional] Server version: 1.7.0 → 1.9.0
- [functional] Server version: 1.5.0 → 1.7.0
- [functional] New tool “find_kr_policy_housing_loans”
- [functional] New tool “plan_kr_inheritance_gift_filing_deadline”
- [functional] New tool “compare_kr_ticket_vs_presale_tax”
- [functional] New tool “compare_kr_overseas_stock_vs_etf_tax”
- [functional] New tool “compare_kr_inherited_house_valuation”
- [functional] New tool “compare_kr_general_vs_simplified_vat”
- [functional] New tool “check_kr_youth_rent_support”
- [functional] New tool “check_kr_special_supply”
- [functional] New tool “check_kr_officetel_house_count”
- [functional] New tool “calculate_kr_yellow_umbrella_deduction”
- [functional] New tool “calculate_kr_sme_youth_tax_reduction”
- [functional] New tool “calculate_kr_business_car_expense”
- [functional] New tool “calculate_kr_dismissal_notice_pay”
- [functional] New tool “calculate_kr_reduced_hours_childcare_pay”
- [functional] New tool “calculate_kr_shutdown_allowance”
- [functional] New tool “check_kr_commercial_rent_increase”
- [functional] New tool “check_kr_family_loan_interest”
- [functional] New tool “check_kr_family_low_price_sale”
- [functional] New tool “check_kr_parent_house_free_use”
- [functional] New tool “check_kr_probation_minimum_wage”
- [functional] New tool “check_kr_subcontract_direct_payment”
- [functional] New tool “check_kr_voluntary_quit_unemployment”
- [functional] New tool “plan_kr_annual_leave_promotion”
- [functional] New tool “search_kr_statutes”
- [functional] New tool “calculate_kr_stock_major_shareholder_tax”
- [functional] New tool “check_kr_dependent_deduction”
- [functional] New tool “get_kr_professional_scope”
- [functional] New tool “start_kr_law_intake”
- [functional] New tool “check_kr_fixed_overtime_pay”
- [functional] New tool “calculate_kr_comprehensive_real_estate_tax”
- [functional] New tool “calculate_kr_housing_rental_income_tax”
- [functional] New tool “calculate_kr_long_term_care_copay”
- [functional] New tool “calculate_kr_ordinary_wage”
- [functional] New tool “calculate_kr_maternity_leave_pay”
- [functional] New tool “plan_quality_recovery”
- [functional] New tool “plan_campaign_supply”
- [functional] New tool “evaluate_influencer_deal”
- [functional] New tool “evaluate_acquisition”
- [functional] New tool “compare_kr_retirement_pension”
- [functional] New tool “compare_alternative_materials”
- [functional] New tool “check_sales_rebates”
- [functional] New tool “check_big_order_capacity”
- [functional] New tool “calculate_kr_work_child_incentive”
- [functional] New tool “calculate_kr_wage_guarantee”
- [functional] New tool “calculate_kr_monthly_rent_credit”
- [functional] New tool “calculate_kr_injury_leave_pay”
- [functional] New tool “analyze_market_test”

### 2026-11-15 (score 70, +1)

- [functional regression] Schema quality: 5623 → 6973
- [functional] Server version: 1.4.0 → 1.5.0
- [functional] New tool “evaluate_decision_tree”
- [functional] New tool “get_kr_business_tax_calendar”
- [functional] New tool “map_brand_positioning”
- [functional] New tool “rank_priorities”
- [functional] New tool “schedule_critical_path”
- [functional] New tool “classify_bcg_portfolio”
- [functional] New tool “calculate_unit_economics_runway”
- [functional] New tool “analyze_swot”

### 2026-11-14 (score 69, 0)

- [functional regression] Schema quality: 162 → 187
- [functional] Server version: 1.3.3 → 1.4.0
- [functional] New tool “value_kr_unlisted_shares”
- [functional] New tool “calculate_kr_incorporation_conversion”
- [functional] New tool “calculate_kr_family_business_deduction”
- [functional] New tool “calculate_dcf_valuation”

### 2026-11-12 (score 69, +1)

- [functional] Server version: 1.3.2 → 1.3.3
- [functional] Server version: 1.3.1 → 1.3.2

## MCP tools (179)

### `get_kr_minimum_wage` (~64 tokens)

get kr minimum wage

Verified Korean minimum wage by year, effective dates and 8/209-hour examples. Not a 2027 net-salary calculator; uncollected insurance is unavailable.

Input parameters:

- `year`: Korean applicable year; omission uses Asia/Seoul current year

### `get_kr_holidays` (~45 tokens)

get kr holidays

Get official South Korea public holidays, substitute holidays, and solar terms for a given year.

Input parameters:

- `year` (integer, required): Calendar year (e.g. 2026)

### `check_kr_business_day` (~43 tokens)

check kr business day

Determines if a given date is a South Korea working business day or a public holiday/weekend.

Input parameters:

- `date` (string, required): Date in YYYY-MM-DD format

### `calculate_saju_astrology` (~135 tokens)

calculate saju astrology

Computes traditional Korean Sexagenary Cycle (60 Gapja) Four Pillars and Five Elements (오행) balance from birth datetime and solar/lunar calendar.

Input parameters:

- `day` (integer, required): Birth day (1-31)
- `hour` (integer): Birth hour (0-23, optional)
- `isLeapMonth` (boolean): True if lunar leap month
- `isLunar` (boolean): True if lunar calendar
- `minute` (integer): Birth minute (0-59, optional)
- `month` (integer, required): Birth month (1-12)
- `year` (integer, required): Birth year

### `calculate_unemployment_benefits` (~101 tokens)

calculate unemployment benefits

Simulates statutory South Korean unemployment benefits (실업급여) duration, daily benefit rate, and total expected payout.

Input parameters:

- `age` (required): Whether age is under 50 ('under') or 50 and older / disabled ('over')
- `hours` (number): Daily contractual working hours (default 8)
- `period` (required): Employment insurance contribution period bracket
- `wage` (number, required): Pre-tax average monthly wage before dismissal in KRW

### `calculate_weekly_allowance` (~123 tokens)

calculate weekly allowance

Calculates statutory South Korean weekly holiday allowance (주휴수당) for part-time and hourly workers.

Input parameters:

- `completedScheduledDays` (boolean): Explicitly confirm attendance on all scheduled working days
- `employedWholeWeek` (boolean): Explicitly confirm employment through the entire applicable week
- `hourlyWage` (number, required): Hourly wage in KRW (2026 minimum wage: 10,320 KRW)
- `hours` (number, required): Contractual working hours per week (must be >= 15 for allowance)
- `tax`: Tax deduction option

### `calculate_overtime_pay` (~139 tokens)

calculate overtime pay

Calculates statutory overtime, night, and holiday allowances under Korean Labor Standards Act.

Input parameters:

- `holidayHours8orLess` (number): Holiday hours up to 8 hours (1.5x)
- `holidayHoursOver8` (number): Holiday hours exceeding 8 hours (2.0x)
- `hourlyWage` (number, required): 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)

### `calculate_net_salary` (~127 tokens)

calculate net salary

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.

Input parameters:

- `dependents` (integer): Number of dependents including self (default 1)
- `isAnnual` (boolean): True if salary parameter is annual base pay
- `nonTaxable` (number): Monthly non-taxable amount (meal subsidy etc., default 200,000 KRW)
- `salary` (number, required): Gross monthly or annual salary in KRW

### `calculate_severance_pay` (~155 tokens)

calculate severance pay

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.

Input parameters:

- `annualBonus` (number): Annual bonus paid during previous year in KRW
- `annualLeaveAllowance` (number): Annual unused leave cash-out allowance in KRW
- `endDate` (string, required): Resignation/leaving date in YYYY-MM-DD
- `startDate` (string, required): Enlistment/joining date in YYYY-MM-DD
- `threeMonthSalary` (number, required): Total gross base salary received during last 3 months in KRW
- `weeklyHoursCondition`: Whole service period four-week contractual hours, not hours in the last week

### `calculate_annual_leave` (~96 tokens)

calculate annual leave

Calculates statutory annual paid leave days (연차 휴가) and unused leave cash-out allowance by years of service.

Input parameters:

- `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, required): Continuous service duration in completed years

### `calculate_military_service` (~73 tokens)

calculate military service

Calculates South Korea mandatory military service duration, completion rate, remaining days, and rank promotion dates.

Input parameters:

- `branch`: Military branch (default army 18m)
- `currentDate` (string): Reference evaluation date (default today)
- `enlistmentDate` (string, required): Enlistment date in YYYY-MM-DD

### `calculate_gas_bill` (~82 tokens)

calculate gas bill

Calculates South Korea residential city gas invoice amount based on cubic meters used and heating/cooking tariff.

Input parameters:

- `calorific` (number): Optional regional average calorific value in MJ/m³ (default 42.8)
- `type`: Usage tariff type (default heating)
- `usageM3` (number, required): Gas meter volume in cubic meters (m³)

### `convert_units` (~118 tokens)

convert units

Universal deterministic unit conversion for area (pyeong ↔ m², sqft, ha), length, mass, and temperature.

Input parameters:

- `from` (string, required): Source unit (e.g. 'pyeong', 'm2', 'sqft', 'kg', 'lb', 'c', 'f')
- `to` (string, required): Target unit (e.g. 'm2', 'pyeong', 'ft', 'inch', 'lb', 'f', 'c')
- `value` (number, required): Numeric quantity to convert

### `calculate_cagr` (~78 tokens)

calculate cagr

Calculates Compound Annual Growth Rate (CAGR, 연평균 복합 성장률), total ROI, and Rule of 72 milestone.

Input parameters:

- `finalValue` (number, required): Final asset value or future valuation
- `initialValue` (number, required): Initial investment or starting asset amount
- `years` (number, required): Investment or operational time horizon in years

### `calculate_compound_interest` (~116 tokens)

calculate compound interest

Simulates compound interest growth with initial principal, annual yield, recurring monthly contributions, and annual balance trajectory.

Input parameters:

- `compoundingFrequency`: Compounding cycle (default monthly)
- `monthlyContribution` (number): Optional monthly recurring savings or investment amount
- `principal` (number, required): Initial lump sum principal investment amount in KRW or local currency
- `rate` (number, required): Annual return / interest rate in percent (e.g. 7 for 7%)
- `years` (number, required): Investment duration in years (maximum 100)

### `calculate_health_insurance` (~311 tokens)

calculate health insurance

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.

Input parameters:

- `age` (number): Candidate age (sibling test: under 30 or 65+)
- `businessIncome` (number): Annual business income (사업소득금액) in KRW
- `financialIncome` (number): Annual financial income (이자/배당소득) in KRW
- `hasBusinessRegistration` (boolean): Whether registered as a business owner
- `hasHousingRentalIncome` (boolean): Business income includes housing rental income (treated as registered even without registration)
- `isDisabledOrMerit` (boolean): Registered disabled person, national merit or veteran-compensation wounded (business income up to 5M allowed regardless of registration)
- `isMarried` (boolean): Candidate is married (both spouses must meet the income test)
- `otherIncome` (number): Other annual income (근로/연금 등) in KRW
- `propertyTaxBase` (number): Property tax base (재산세 과세표준) in KRW
- `relationship`: Candidate's relationship to the employee (default unknown)
- `siblingUnmarried` (boolean): Sibling is unmarried (divorced/widowed counts as unmarried)
- `spouseMeetsIncomeCriteria` (boolean): For a married candidate: spouse also meets the income test

### `diagnose_hug_guarantee` (~152 tokens)

diagnose hug guarantee

Diagnoses HUG Jeonse Deposit Return Guarantee eligibility (126% rule, 60% senior debt limit, 90% debt ratio limit) and calculates statutory guarantee fee.

Input parameters:

- `discountType`: Statutory fee discount type
- `jeonseDeposit` (number, required): Jeonse deposit amount (전세보증금) in KRW
- `officialPrice` (number, required): Publicly declared housing price (공시가격) in KRW
- `propertyType`: Type of property
- `seniorDebt` (number): Senior lien / mortgage amount (선순위 채권액) in KRW
- `termMonths` (number): Lease term in months (default 24)

### `calculate_capital_gains_tax` (~138 tokens)

calculate capital gains tax

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.

Input parameters:

- `acquisitionPrice` (number, required): Buying / acquisition price in KRW
- `expenses` (number): Necessary capital expenses (brokerage, remodel, acquisition tax) in KRW
- `holdingYears` (number): Holding period in years
- `houseType`: Taxation category
- `residenceYears` (number): Actual residence period in years
- `transferPrice` (number, required): Selling / transfer price in KRW

### `compare_vat_tax` (~102 tokens)

compare vat tax

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).

Input parameters:

- `industryType`: Industry classification
- `purchase` (number): Annual gross purchases with tax invoices in KRW
- `revenue` (number, required): Annual gross revenue (공급대가, VAT-inclusive) in KRW

### `calculate_inheritance_gift_tax` (~255 tokens)

calculate inheritance gift tax

Calculates South Korea 2026 statutory inheritance and gift tax, progressive tax brackets (10-50%), relationship deductions, and voluntary filing discount.

Input parameters:

- `assetValue` (number, required): Gross market value of assets in KRW
- `debtValue` (number): Liabilities or debts assumed in KRW
- `hasSpouse` (boolean): Whether surviving spouse exists (inheritance mode only)
- `hasVoluntaryReporting` (boolean): 3% voluntary filing tax credit
- `isGenerationSkipping` (boolean): Generation skipping surcharge (30%; 40% when a minor receives over 2,000,000,000 KRW)
- `isMinorRecipient` (boolean): Recipient is a minor (defaults to relationship child_minor)
- `marriageBirthDeduction` (number): Gift from lineal ascendant only: marriage/birth deduction to apply in KRW (lifetime max 100,000,000)
- `mode`: Calculation mode
- `relationship`: Beneficiary relationship
- `spouseDeduction` (number): Inheritance mode: spouse deduction in KRW, clamped to 500,000,000-3,000,000,000 (default 500,000,000)

### `calculate_loan_refinance` (~141 tokens)

calculate loan refinance

Calculates loan refinancing savings, prepayment penalty fees with 3-year sliding taper, and break-even point in months.

Input parameters:

- `currentRate` (number, required): Existing loan annual interest rate in %
- `elapsedMonths` (number): Months elapsed since loan origination (0-36)
- `incidentalCosts` (number): Incidental refinancing fees in KRW
- `loanBalance` (number, required): Remaining loan balance in KRW
- `newRate` (number, required): New loan annual interest rate in %
- `penaltyRate` (number): Prepayment penalty rate in % from the loan contract (example default 1.2; actual rates vary by product)

### `calculate_card_tax_deduction` (~183 tokens)

calculate card tax deduction

Calculates South Korea 2026 year-end card tax deduction, 25% threshold, credit (15%) vs check (30%) rates, and golden ratio strategy.

Input parameters:

- `annualSalary` (number, required): Gross annual salary (비과세 제외) in KRW
- `checkCardSpend` (number): Annual check/debit card and cash receipt spending in KRW
- `children` (number): Number of child/grandchild dependents (2026 base limit rises by child count, 2+ capped)
- `creditCardSpend` (number): Annual credit card spending in KRW
- `cultureSpend` (number): Book, performing arts, museum spending in KRW
- `publicTransitSpend` (number): Public transit spending in KRW (40%)
- `traditionalMarketSpend` (number): Traditional market spending in KRW (40%)

### `calculate_kr_year_end_settlement` (~884 tokens)

calculate kr year end settlement

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.

Input parameters:

- `birthOrder` (integer): Birth/adoption this year: 1 for first child, 2 second, 3 third or later; 0 none
- `cardChildren` (integer): Children counted for the raised card deduction limit
- `creditCardSpend` (number): Credit card spending in KRW
- `creditChildren` (integer): Children eligible for the child tax credit (자녀세액공제)
- `cultureSpend` (number): Books, performances, museums, movies, sports facilities in KRW
- `debitCardSpend` (number): Debit card and cash receipt spending in KRW
- `disabledPersons` (integer): Disabled dependents including self (장애인 추가공제 인원)
- `donation` (number): Designated (non-religious) donations in KRW
- `education` (number): Eligible dependent education expenses after per-person caps in KRW
- `educationSelf` (number): Own education expenses in KRW
- `healthEmployment` (number): Health, long-term care and employment insurance paid by the employee in KRW
- `hometownDonation` (number): Hometown love donations (고향사랑기부금) in KRW
- `housingSubscriptionPaid` (number): Housing subscription savings paid (주택청약종합저축) in KRW
- `insurancePremium` (number): Protection-type insurance premiums (보장성 보험료) in KRW
- `irp` (number): IRP / DC personal contributions in KRW
- `isaTransfer` (number): Matured ISA amount moved to a pension account this year in KRW
- `leaseLoanRepaid` (number): Jeonse loan principal and interest repaid (주택임차차입금) in KRW
- `marriage` (boolean): Marriage registered 2024-2026 and the one-time marriage credit not yet used
- `medical` (number): Medical expenses for general dependents in KRW (7M cap)
- `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
- `otherIncome` (number): Other comprehensive income amount (사업·연금·기타소득금액) in KRW; turns this into a May filing approximation
- `pensionSavings` (number): Pension savings account contributions (연금저축) in KRW
- `persons` (integer): Basic deduction persons including self (기본공제 인원, default 1)
- `politicalDonation` (number): Political donations in KRW
- `publicTransitSpend` (number): Public transit spending in KRW
- `religiousDonation` (number): Religious donations in KRW
- `rent` (number): Monthly rent paid for the year in KRW
- `rentEligible` (boolean): User confirmed the statutory rent credit requirements (homeless household head etc.)
- `salary` (number, required): Gross annual salary excluding non-taxable pay (총급여) in KRW
- `seniors` (integer): Dependents aged 70+ (경로우대 추가공제 인원)
- `singleParent` (boolean): 한부모 추가공제
- `taxYear`: Tax year (귀속연도). Only 2026 is supported
- `traditionalMarketSpend` (number): Traditional market spending in KRW
- `withheld` (number): Income tax withheld during the year (excluding local tax) in KRW; enables refund calculation
- `womanHead` (boolean): 부녀자 추가공제 (income 30M KRW or less)
- `youthSme` (boolean): Eligible for the SME youth employment income tax reduction

### `calculate_kr_freelancer_income_tax` (~206 tokens)

calculate kr freelancer income tax

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.

Input parameters:

- `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
- `people` (integer): Basic deduction persons including self (default 1)
- `revenue` (number, required): Annual gross freelance revenue before 3.3% withholding in KRW
- `taxYear`: Tax year (귀속연도), default 2026

### `calculate_kr_acquisition_tax` (~194 tokens)

calculate kr acquisition tax

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.

Input parameters:

- `houses`: Household houses including this one (4 = four or more), default 1
- `over85` (boolean): Exclusive area over 85 square meters (rural special tax applies)
- `price` (number, required): Purchase price in KRW
- `regulated` (boolean): The house is in an adjustment target area (조정대상지역)
- `taxYear`: Only 2026 is supported
- `temporaryTwo` (boolean): Temporary two-home case: the previous home will be sold within the deadline

### `calculate_kr_property_tax` (~168 tokens)

calculate kr property tax

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.

Input parameters:

- `officialPrice` (number, required): Official housing price (공시가격) in KRW
- `oneHouse` (boolean): One house per household (1세대1주택), default true
- `taxYear`: Only 2026 is supported
- `urbanArea` (boolean): Inside an urban planning area (도시지역분 0.14%), default true

### `value_kr_unlisted_shares` (~441 tokens)

value kr unlisted shares

South Korea unlisted share valuation for inheritance/gift tax (상증법 보충적 평가): 3-year weighted (3:2:1) net income value at 10% capitalization and net asset value, blended 3:2 (2:3 when real estate ≥ 50% of assets, net asset value only at ≥ 80% or 시행령 제54조 ④ cases), floored at 80% of net asset value, plus the 20% largest-shareholder premium unless exempt (SMEs, mid-sized firms under 500B KRW revenue). Same formulas as tools.oiyo.net. Inputs are the user's figures; returns statute basis and what is not covered.

Input parameters:

- `goodwill` (number): Goodwill value to add (시행령 제59조 ②), KRW; default 0
- `heldShares` (integer, required): Shares being valued (held by the person)
- `isMajorityHolder` (boolean): The holder is a largest shareholder (최대주주 등)
- `netAssetOnlyReason` (boolean): A 시행령 제54조 ④ case applies (under 3 years of business, closure/liquidation, shares ≥ 80% of assets, etc.)
- `netAssets` (number, required): Net asset value at the valuation date under 상증법 market values (assets − liabilities), KRW
- `netIncome1` (number, required): Net income (순손익액) of the latest fiscal year before the valuation date, whole company, KRW; may be negative
- `netIncome2` (number, required): Net income two years before, KRW
- `netIncome3` (number, required): Net income three years before, KRW
- `premiumExempt` (boolean): Premium exemption applies (SME, mid-sized firm under 500B KRW 3-year average revenue, 3 straight loss years, etc.). Default true
- `realEstateRatio` (number): Real estate and real-estate rights share of total assets, 0-1
- `sharesOutstanding` (integer, required): Issued shares excluding treasury shares

### `calculate_kr_family_business_deduction` (~325 tokens)

calculate kr family business deduction

South Korea family business inheritance deduction (가업상속공제, 상증법 제18조의2) and inheritance tax with vs without it: cap 30B/40B/60B KRW for 10/20/30+ years of operation, qualifying value = share value × (1 − non-business asset ratio), plus lump-sum 500M, spouse and financial asset deductions and the 3% filing credit. Same formulas as tools.oiyo.net. Does not judge eligibility requirements or post-management; the 2026-08 reform proposal is not applied.

Input parameters:

- `businessValue` (number, required): Value of the family business shares (or sole-proprietor business assets), KRW
- `debts` (number): Debts of the deceased, KRW
- `funeralSpent` (number): Funeral costs, KRW (5M-10M deduction)
- `hasSpouse` (boolean): A surviving spouse inherits
- `netFinancial` (number): Net financial assets among the other property, KRW
- `otherEstate` (number): Other inherited property outside the business, KRW
- `size` (required): sme, midsize (3-year average revenue under 500B KRW) or ineligible
- `spouseInherited` (number): Amount the spouse actually inherits, KRW
- `unrelatedAssetRatio` (number): Non-business assets ÷ total assets of the company, 0-1 (0 for a sole proprietorship)
- `years` (integer, required): Years the deceased operated the business

### `calculate_kr_incorporation_conversion` (~250 tokens)

calculate kr incorporation conversion

South Korea sole proprietor to corporation conversion (개인사업자 법인전환): minimum capital (net asset value at market), capital gains tax deferred by 조특법 제32조 이월과세 on business real estate, and the 50% acquisition tax relief (지특법 제57조의2 ④, through 2027-12-31, not for real estate rental) net of the 20% rural special tax. Same formulas as tools.oiyo.net. Houses are excluded from the deferral.

Input parameters:

- `acquisitionBase` (number): Acquisition tax base if different from market value, KRW; 0 uses market value
- `business`: Business type; consumption services (lodging, bars) get no deferral or relief
- `holdYears` (number, required): Years held
- `liabilities` (number): Business liabilities including provisions, KRW
- `otherAssets` (number): Other business assets at market value, KRW
- `realEstateCost` (number, required): Acquisition cost plus necessary expenses of that real estate, KRW
- `realEstateMarket` (number, required): Market value of business real estate (not houses), KRW

### `calculate_dcf_valuation` (~378 tokens)

calculate dcf valuation

Discounted cash flow (DCF) enterprise and equity valuation: 3-10 year FCFF forecast with growth fading to the terminal rate, Gordon terminal value, optional mid-year convention, WACC given directly or built with CAPM, plus a WACC × terminal growth sensitivity table. Ratios are decimals (0.1 = 10%). Same engine as tools.oiyo.net.

Input parameters:

- `beta` (number): Levered beta for CAPM
- `capexRatio` (number): Capital expenditure ÷ revenue
- `daRatio` (number): Depreciation and amortization ÷ revenue
- `debtWeight` (number): Debt weight D/(D+E)
- `ebitMargin` (number, required): EBIT margin
- `growth` (number, required): Year-1 revenue growth (e.g. 0.1)
- `marketPremium` (number): Market risk premium
- `midYear` (boolean): Use the mid-year discounting convention
- `netDebt` (number): Net debt (debt − cash); negative for net cash
- `nwcRatio` (number): Net working capital increase ÷ revenue increase
- `preTaxCostOfDebt` (number): Pre-tax cost of debt
- `revenue0` (number, required): Last fiscal year revenue
- `riskFree` (number): Risk-free rate for CAPM
- `shares` (integer, required): Shares outstanding
- `sizePremium` (number): Size / private company premium, default 0
- `taxRate` (number): Effective tax rate incl. local tax, default 0.22
- `terminalGrowth` (number, required): Perpetual growth rate, below WACC
- `wacc` (number): WACC; omit to build it from the CAPM inputs
- `years`: Forecast years, default 5

### `evaluate_decision_tree` (~195 tokens)

evaluate decision tree

Decision tree expected value with rollback: give simple options (success probability, payoff if success / fail, upfront cost) or a full tree of decision / chance / outcome nodes. Returns the best path, expected value, outcome distribution, worst/best case, probability of loss, and for options the success probability at which the best choice would flip. Same engine as tools.oiyo.net.

Input parameters:

- `options` (array): 2-8 simple options. Give options or tree, not both.
- `question` (string): The decision being made, e.g. '신규 매장을 열까?'
- `tree` (object): Full tree instead of options. Node: {label, kind: 'decision'|'chance'|'outcome', value (outcome only), branches: [{label, prob (chance branches, 0..1), cost, node}]}. Max 12 levels and 200 nodes.

### `schedule_critical_path` (~147 tokens)

schedule critical path

Project schedule by critical path method (CPM) with PERT three-point estimates: earliest/latest start and finish, slack and critical tasks, project duration, standard deviation and the probability of finishing by a deadline. Optional start date converts days to calendar dates (weekends skipped when workdaysOnly). Refuses unknown dependency ids and cycles. Same engine as tools.oiyo.net.

Input parameters:

- `deadline` (number): Deadline in days from the start, for the on-time probability
- `startDate` (string): Project start date YYYY-MM-DD
- `tasks` (array, required): 1-80 tasks
- `workdaysOnly` (boolean): Count only Monday-Friday when converting to dates

### `analyze_swot` (~103 tokens)

analyze swot

SWOT analysis with TOWS strategy pairs and the internal/external factor evaluation (IFE/EFE) and IE matrix: impact 1-5 decides the stance (SO attack, ST diversify, WO turnaround, WT defend); weight and rating 1-4 give IFE/EFE totals (2.5 is average) and the grow / hold / harvest cell. Same engine as tools.oiyo.net.

Input parameters:

- `items` (array, required): 1-40 factors

### `classify_bcg_portfolio` (~131 tokens)

classify bcg portfolio

BCG growth-share matrix: classifies each business unit as star, cash cow, question mark or dog from market growth and relative market share (our share ÷ largest rival's share; if we lead, ÷ the runner-up), with revenue mix by quadrant, the recommended move and portfolio warnings. Ratios are decimals. Same engine as tools.oiyo.net.

Input parameters:

- `growthThreshold` (number): High-growth line, default 0.1
- `shareThreshold` (number): Relative share line, default 1.0
- `units` (array, required): 1-20 units

### `map_brand_positioning` (~98 tokens)

map brand positioning

Marketing positioning map on two axes (-10..10 each): nearest competitor and distance for every brand, brands crowded together, and the largest empty spot on the map (optionally pulled toward a customer ideal point). Same engine as tools.oiyo.net.

Input parameters:

- `brands` (array, required): 2-12 brands
- `idealX` (number): Customer ideal point, horizontal
- `idealY` (number): Customer ideal point, vertical

### `calculate_unit_economics_runway` (~302 tokens)

calculate unit economics runway

Startup and small business economics in one call; give any complete group. Unit economics (arpu, grossMargin, monthlyChurn, cac): LTV, LTV/CAC grade, CAC payback months. Runway (cash, revenue, expenses, monthly growth rates): month-by-month cash, the month cash runs out, break-even month and whether the company is default alive. Break-even (fixedCost, price, variableCost): units and revenue. Same engine as tools.oiyo.net.

Input parameters:

- `arpu` (number): Monthly revenue per customer
- `cac` (number): Customer acquisition cost
- `cash` (number): Cash in the bank now
- `discountRate` (number): Annual discount rate for LTV, default 0
- `expenseGrowth` (number): Monthly expense growth
- `expenses` (number): Monthly expenses now, including cost of sales
- `fixedCost` (number): Fixed cost for the break-even period
- `grossMargin` (number): Gross margin, 0..1
- `monthlyChurn` (number): Monthly churn, 0..1
- `months` (integer): Months to project, default 36
- `price` (number): Unit price
- `revenue` (number): Monthly revenue now
- `revenueGrowth` (number): Monthly revenue growth, e.g. 0.05
- `variableCost` (number): Variable cost per unit

### `rank_priorities` (~114 tokens)

rank priorities

Prioritise work or choose between options. method 'rice': Reach × Impact × Confidence ÷ Effort ranking. method 'weighted': weighted decision matrix (scores per criterion, weights normalised) with the weight each criterion would need to flip first and second place. Same engine as tools.oiyo.net.

Input parameters:

- `criteria` (array): Criteria (method weighted)
- `items` (array): RICE items (method rice)
- `method` (required): rice or weighted
- `options` (array): Options (method weighted)

### `get_kr_business_tax_calendar` (~260 tokens)

get kr business tax calendar

South Korea business filing calendar for one year (부가세·법인세·종합소득세·원천세·지급명세서·고용산재 보수총액): statutory date and the actual due date moved past weekends and public holidays (국세기본법 제5조), with the statute for each. Optional stage or role adds the must-do / must-not-do checklist for founders, management teams, bookkeepers and tax advisers. December fiscal year-end; estimate, not tax advice.

Input parameters:

- `employer` (boolean, required): Pays employees or freelancers (withholding obligations)
- `entity` (required): corp (법인) or indiv (개인사업자)
- `from` (string): Also list the next 5 deadlines on or after this date (YYYY-MM-DD)
- `halfYearWithholding` (boolean): Approved for half-yearly withholding tax filing
- `role`: Add the checklist for this role
- `sincere` (boolean): Subject to 성실신고확인
- `stage`: Add the checklist for this stage
- `vat` (required): VAT type: general (일반), simple (간이), exempt (면세)
- `year` (integer, required): Calendar year

### `plan_kr_small_business_month` (~323 tokens)

plan kr small business month

One-page monthly back-office list for a Korean sole proprietor or small company: this month's filing deadlines (withholding tax, VAT, payment statements, income or corporate tax), 4 social insurance premiums (10th), monthly-total tax invoices (10th, 부가가치세법 제34조③), wage statements on payday (근로기준법 제48조②), and event deadlines for hires (written contract, insurance enrolment by the 15th of the next month) and leavers (settle wages and severance within 14 days, insurance loss report). Due dates move past weekends and public holidays; overdue items and deadlines that fall next month are separated; adds routine monthly bookkeeping. December fiscal year-end; no filing or drafting.

Input parameters:

- `employer` (boolean, required): Pays employees or freelancers
- `entity` (required): corp (법인) or indiv (개인사업자)
- `halfYearWithholding` (boolean): Approved for half-yearly withholding tax filing
- `hires` (array): Hire dates this or last month, YYYY-MM-DD
- `leaves` (array): Leaving dates this or last month, YYYY-MM-DD
- `month` (string, required): Month YYYY-MM
- `payday` (integer): Monthly payday (day of month)
- `sincere` (boolean): Subject to 성실신고확인
- `today` (string): Reference date for days left and overdue (YYYY-MM-DD)
- `vat` (required): VAT type: general (일반), simple (간이), exempt (면세)

### `plan_campaign_supply` (~156 tokens)

plan campaign supply

Campaign demand vs supply: from weekly demand, opening stock, weekly production capacity and the lead time for extra production, returns the first stockout week, total shortage, fill rate, the uniform extra production per week needed from the first week extra output can arrive, and the shortage that extra production cannot fix in time. Same engine as tools.oiyo.net.

Input parameters:

- `capacityPerWeek` (number, required): Units produced or received per week
- `demand` (array, required): Weekly demand, 1-52 weeks
- `leadTimeWeeks` (integer, required): Weeks before extra production arrives
- `openingStock` (number, required): Stock on hand at the start
- `safetyStock` (number): Stock to keep at all times, default 0

### `evaluate_influencer_deal` (~228 tokens)

evaluate influencer deal

Influencer (creator) contract check: expected clicks, orders, revenue, ROAS, contribution after gross margin and fees, CPM, CPA, break-even orders and conversion, plus South Korea withholding on the payment (3.3% business income, 8.8% other income) or 10% VAT for a business payee, and the disclosure/contract checklist with statutes. Same engine as tools.oiyo.net.

Input parameters:

- `aov` (number, required): Average order value
- `clickRate` (number, required): Views to clicks, 0..1
- `conversionRate` (number, required): Clicks to orders, 0..1
- `fee` (number, required): Fixed fee before tax
- `grossMargin` (number, required): Gross margin, 0..1
- `payee` (required): freelancer (사업소득 3.3%), oneOff (기타소득 8.8%), business (tax invoice + VAT)
- `performanceRate` (number): Revenue-linked performance fee, 0..1
- `views` (number, required): Expected views

### `plan_quality_recovery` (~146 tokens)

plan quality recovery

Quality incident recovery: defects and units in market per lot, cost of three recall scopes (defects only, all shipped units of the lots, whole lots including warehouse), and how to allocate the remaining good stock among customers (priority first, highest penalty first, pro rata) with the shortfall penalty of each rule. Same engine as tools.oiyo.net.

Input parameters:

- `customers` (array, required): Customers waiting for stock
- `goodStock` (number, required): Good stock available now
- `lots` (array, required): Affected lots
- `recallCostPerUnit` (number, required): Recall/disposal cost per unit
- `remakeCostPerUnit` (number, required): Cost to remake one unit

### `compare_alternative_materials` (~129 tokens)

compare alternative materials

Alternative raw material review: annual saving vs the current price, months to recover test/certification cost, weeks to approval (test plus filing when labels or functional claims change), and a weighted 1-5 score on cost, quality, supply stability and speed, with warnings. Same engine as tools.oiyo.net.

Input parameters:

- `annualVolume` (number, required): Annual volume
- `candidates` (array, required): Candidates
- `currentPrice` (number, required): Current unit price
- `filingWeeks` (number): Weeks added when filing is needed, default 8
- `weights` (object, required)

### `check_big_order_capacity` (~142 tokens)

check big order capacity

Big new order vs existing commitments under limited capacity: profit of declining, accepting in full, accepting only spare capacity, accepting with overtime/outsourcing, and the profit-maximising quantity; existing orders are cut in order of lowest margin plus penalty and locked commitments are never cut in the recommendation. Same engine as tools.oiyo.net.

Input parameters:

- `capacity` (number, required): Units that can be made in the period
- `existing` (array, required): Existing commitments
- `extraCapacity` (number): Extra units from overtime/outsourcing
- `extraCostPerUnit` (number): Extra cost per overtime/outsourced unit
- `newOrder` (object, required)

### `analyze_market_test` (~188 tokens)

analyze market test

Overseas market test: sample size per group to detect a relative lift (two-sided, alpha 0.05), two-proportion z-test of A/B results with p-value and 95% CI, and full-entry economics (monthly profit, payback of entry cost, break-even conversion, go / extend / stop). Give any of the three parts. Same engine as tools.oiyo.net.

Input parameters:

- `baseline` (number): Current conversion rate for sample size
- `convA` (integer): Conversions in A
- `convB` (integer): Conversions in B
- `entry` (object)
- `lift` (number): Relative lift to detect, e.g. 0.2
- `nA` (integer): Visitors in A
- `nB` (integer): Visitors in B
- `power` (number): Power, default 0.8

### `check_sales_rebates` (~149 tokens)

check sales rebates

Sales rebate (판매장려금) check: rebate due per partner from contract tiers, optional aggregation of related partners in a group, overpayment (hold) and underpayment (review) against requests, related-party rates above the unrelated range (부당행위계산 부인 risk), group splits that would change the tier, and Korean VAT/corporate tax notes with statutes. Same engine as tools.oiyo.net.

Input parameters:

- `aggregateGroups` (boolean, required): Contract allows group sales to be combined for the tier
- `armsLengthCheck` (boolean, required): Compare related-party rates with the unrelated range
- `partners` (array, required): Partners
- `tiers` (array, required): Contract tiers

### `evaluate_acquisition` (~253 tokens)

evaluate acquisition

Acquisition screen: new shares and after-tax interest from the stock/debt mix, EPS accretion or dilution by year as synergies ramp up, payback year of price plus after-tax integration cost, implied vs own P/E, the synergy needed to keep year-1 EPS, and a default 100-day integration (PMI) schedule. Same engine as tools.oiyo.net.

Input parameters:

- `acquirerNetIncome` (number, required): Acquirer annual net income
- `acquirerShares` (number, required): Acquirer shares outstanding
- `debtRate` (number, required): Interest rate on debt
- `integrationCost` (number, required): One-off pre-tax integration cost
- `price` (number, required): Purchase price for 100%
- `rampYears` (integer, required): Years to reach full synergy
- `sharePrice` (number, required): Acquirer share price
- `stockPortion` (number, required): Share of price paid in stock, rest debt, 0..1
- `synergy` (number, required): Annual pre-tax synergy when fully realised
- `targetNetIncome` (number, required): Target annual net income
- `taxRate` (number, required): Corporate tax rate
- `years` (integer): Years to project, default 7

### `calculate_kr_work_child_incentive` (~262 tokens)

calculate kr work child incentive

Korean earned income tax credit (근로장려금) and child tax credit (자녀장려금) estimate for the 2026 application (2025 income): household type, combined total income, household assets (debts not deducted) and children under 18. Applies phase-in / maximum / phase-out bands, 50% cut at assets ≥ 170M KRW, nothing at ≥ 240M KRW, 95% for late filing. Returns both amounts, the band and how to apply.

Input parameters:

- `assets` (number, required): Total assets of all household members on June 1 (housing, deposits incl. jeonse, savings, cars; debts not deducted) (KRW)
- `children` (integer, required): Dependent children under 18
- `household` (required): single = no spouse or dependants; oneEarner = spouse earns under 3M KRW or supports a child/parent; twoEarner = spouse earns 3M KRW or more
- `income` (number, required): Combined household total income for the year (wages gross, business revenue × industry ratio) (KRW)
- `late` (boolean): Filed after May (June-November): paid at 95%

### `calculate_kr_maternity_leave_pay` (~176 tokens)

calculate kr maternity leave pay

Korean maternity leave pay (출산전후휴가 급여) and spouse childbirth leave (배우자 출산휴가 20일) for 2026: monthly ordinary wage, priority-support (SME) employer or not, single / multiple / premature birth. Splits employer and employment-insurance shares with the 2026 caps (2.2M KRW per 30 days; 20-day spouse cap 1,684,210 KRW) and the minimum-wage floor.

Input parameters:

- `kind`: single 90 days, multiple 120 days, premature 100 days
- `monthlyWage` (number, required): Monthly ordinary wage (통상임금) (KRW)
- `priorityFirm` (boolean, required): Priority-support employer (most SMEs): insurance pays all leave days

### `calculate_kr_wage_guarantee` (~267 tokens)

calculate kr wage guarantee

Korean wage guarantee payment (대지급금) the state pays first for unpaid wages and severance: simple payment for retired workers (wages 7M + severance 7M, total 10M KRW), simple payment for current low-income workers (7M), or insolvency payment with age-based monthly caps (220/310/350/330/230만원) covering the last 6 months of wages when the insolvency decision is on or after 2026-08-20 (3 months before) and the last 3 years of severance.

Input parameters:

- `afterReform` (boolean): Insolvency decision on or after 2026-08-20 (default true)
- `age` (number, required): Age at retirement (or application if employed)
- `kind` (required): simpleRetired = retired, employer still exists; simpleEmployed = still employed; insolvency = rehabilitation, bankruptcy or recognised insolvency
- `monthlyWage` (number, required): Unpaid monthly wage (KRW)
- `serviceYears` (number): Years of service behind the severance
- `unpaidMonths` (integer, required): Number of final months not paid
- `unpaidSeverance` (number): Total unpaid severance pay (KRW)

### `calculate_kr_injury_leave_pay` (~191 tokens)

calculate kr injury leave pay

Korean industrial accident leave pay (산재 휴업급여) for 2026: 70% of average daily wage, the low-income minimum-wage guarantee (82,560 KRW a day), the maximum compensation base 268,299 KRW, nothing when treatment is 3 days or less. Give avgDailyWage, or threeMonthWages with calendarDays.

Input parameters:

- `annualBonus` (number): Bonuses paid in the last year (3/12 added) (KRW)
- `avgDailyWage` (number): Average daily wage (KRW)
- `calendarDays` (integer): Calendar days in those 3 months (default 92)
- `days` (integer, required): Days unable to work
- `threeMonthWages` (number): Wages in the 3 months before the accident (instead of avgDailyWage) (KRW)

### `calculate_kr_monthly_rent_credit` (~194 tokens)

calculate kr monthly rent credit

Korean monthly rent tax credit (월세 세액공제, 조세특례제한법 제95조의2): 17% when total salary ≤ 55M KRW (comprehensive income ≤ 45M), 15% up to 80M (70M), rent up to 10M KRW a year, plus the 10% local income tax reduction. Optional tax before credit caps the credit.

Input parameters:

- `income` (number, required): Total salary (wage earners) or comprehensive income amount (KRW)
- `incomeType` (required): wage = total salary, comprehensive = 종합소득금액
- `monthlyRent` (number, required): Monthly rent excluding maintenance fees (KRW)
- `months` (integer, required): Months of rent paid this year
- `taxBeforeCredit` (number): Income tax left before this credit (optional cap) (KRW)

### `compare_kr_retirement_pension` (~157 tokens)

compare kr retirement pension

Korean retirement pension DB vs DC comparison (퇴직연금 DB형 vs DC형): DB = final monthly wage × total years; DC = past DB accrual moved now plus one month's wage each year compounded at the return. Returns both amounts, the gap, year-by-year series and the break-even return.

Input parameters:

- `dcReturn` (number, required): Annual DC return after fees, e.g. 0.04
- `monthlyWage` (number, required): Current average monthly wage (KRW)
- `wageGrowth` (number, required): Annual wage growth, e.g. 0.03
- `yearsLeft` (integer, required): Years until retirement
- `yearsServed` (number, required): Years of service so far

### `calculate_kr_ordinary_wage` (~307 tokens)

calculate kr ordinary wage

Korean ordinary wage (통상임금) hourly rate and statutory overtime / night / holiday premiums, before and after the Supreme Court en banc ruling of 2024-12-19 (2020다247190) that counts regular bonuses with an employment-on-payday condition. Monthly ordinary wage = base + fixed allowances + annual regular bonus ÷ 12, divided by contracted monthly hours (209 for 40 h/week). Overtime ×1.5, night +0.5, holiday ×1.5 up to 8 h and ×2 beyond; firms under 5 employees pay no premium.

Input parameters:

- `basePay` (number, required): Monthly base pay (KRW)
- `bonusAnnual` (number, required): Regular bonus per year (KRW)
- `bonusConditional` (boolean, required): Bonus paid only to those employed on the payday (or after a minimum number of days)
- `fixedAllowances` (number, required): Monthly allowances paid to everyone at a fixed amount (KRW)
- `holiday` (number, required): Holiday hours per month
- `holidayOver8` (number): Holiday hours beyond 8 a day (part of holiday)
- `monthlyHours` (number): Contracted monthly hours (default 209)
- `night` (number, required): Night hours (22:00-06:00) per month
- `overtime` (number, required): Overtime hours per month
- `smallFirm` (boolean): Fewer than 5 employees: no premium

### `check_kr_fixed_overtime_pay` (~248 tokens)

check kr fixed overtime pay

Check a Korean fixed overtime allowance (포괄임금 고정 연장수당) against the statutory premium for the hours actually worked. Hourly = pay excluding the fixed allowance ÷ monthly hours; shortfall per month × up to 36 months (3-year wage claim limitation). Also flags pay below the 2026 minimum wage (10,320 KRW/h) and how many overtime hours the fixed allowance covers.

Input parameters:

- `basePay` (number, required): Monthly base pay and fixed allowances, excluding the fixed overtime allowance (KRW)
- `fixedOtPay` (number, required): Fixed overtime / night / holiday allowance in the monthly pay (KRW)
- `holiday` (number, required): Actual holiday hours per month
- `holidayOver8` (number): Holiday hours beyond 8 a day
- `monthlyHours` (number): Contracted monthly hours (default 209)
- `months` (integer): Months worked this way (capped at 36)
- `night` (number, required): Actual night hours per month
- `overtime` (number, required): Actual overtime hours per month
- `smallFirm` (boolean): Fewer than 5 employees: no premium

### `calculate_kr_comprehensive_real_estate_tax` (~226 tokens)

calculate kr comprehensive real estate tax

Korean comprehensive real estate holding tax on housing (종합부동산세 주택분) for 2026: deduction 1.2B KRW for a one-house household (900M otherwise, 0 for corporations), fair market ratio 60%, rates 0.5-2.7% (3+ houses: 2-5% above a 1.2B base; corporations 2.7%/5%), property-tax overlap credit, one-house age (20/30/40%) and holding (20/40/50%) credits up to 80%, rural special tax 20%. Excludes the 150% year-on-year cap.

Input parameters:

- `age` (number): Owner age on June 1 (one-house only)
- `corporate` (boolean): Owned by a corporation
- `holdYears` (number): Years held (one-house only)
- `oneHouse` (boolean, required): One-house household (incl. joint-ownership special election)
- `prices` (array, required): Official price of each house

### `calculate_kr_housing_rental_income_tax` (~307 tokens)

calculate kr housing rental income tax

Korean housing rental income tax (주택임대소득세): one house exempt unless standard price > 1.2B KRW, deemed rent on deposits for 3+ houses ((deposits − 300M) × 60% × 3.1%), separate taxation at 14% when revenue ≤ 20M (expense 60% registered / 50% not, basic deduction 4M / 2M when other income ≤ 20M) compared with comprehensive taxation; both include local income tax.

Input parameters:

- `actualExpenseRate` (number): Actual expense ratio for comprehensive taxation (books)
- `annualRent` (number, required): Monthly rent received over the year (KRW)
- `deposits` (number, required): Total deposits (jeonse) received (KRW)
- `highPriceOneHouse` (boolean): With one house: its standard price is above 1.2B KRW
- `houses` (integer, required): Houses owned by the couple (small houses excluded)
- `interestRate` (number): Deposit interest rate for deemed rent (default 0.031)
- `otherIncome` (number, required): Other comprehensive income amount (wage income amount etc.) (KRW)
- `otherTaxBase` (number): Tax base of other income (default otherIncome × 0.7) (KRW)
- `registered` (boolean, required): Registered as a rental business with both the local government and the tax office

### `calculate_kr_long_term_care_copay` (~268 tokens)

calculate kr long term care copay

Korean long-term care insurance copay (노인장기요양 본인부담금) for 2026: home care (재가) monthly limits by grade (1: 2,512,900 … 5: 1,208,900; cognitive 676,320 KRW) at 15%, facility care (시설) daily rates (1: 93,070, 2: 86,340, 3-5: 81,540 KRW) at 20%, 40%/60% reductions, basic livelihood recipients exempt; home use above the limit and facility meals are paid in full.

Input parameters:

- `dailyExtra` (number): Facility non-covered cost per day such as meals (default 15,000) (KRW)
- `days` (integer): Facility days per month (default 30)
- `grade` (required): Long-term care grade
- `homeUse` (number): Home care used per month at official fees (default: the grade limit) (KRW)
- `kind` (required): home = 방문요양·주야간보호, facility = 요양원
- `reduction` (required): Copay reduction: 40%, 60%, or basic livelihood recipient (0)

### `check_kr_dependent_deduction` (~298 tokens)

check kr dependent deduction

Korean year-end dependent deduction check (부양가족 기본공제) for 2026: for each family member judges age (parents 60+, children 20 or under, siblings ≤20 or 60+, foster children under 18; disabled or basic-livelihood recipients any age), income (wage-only total pay ≤ 5M KRW, otherwise income amount ≤ 1M KRW), living together (siblings, grandchildren, foster children) and double claims; adds 70+ (1M) and disabled (2M) extra deductions and counts child tax credit children (ages 9-20, born 2017 excluded). Compares year-end tax with and without the family using the same settlement formula (other deductions assumed zero, social insurance estimated) and gives the tax each person saves.

Input parameters:

- `married` (boolean): Claimant has a spouse (used for single-parent and woman-head extra deductions)
- `people` (array, required): Family members to check
- `salary` (number, required): Claimant's total pay for the year (non-taxable excluded) (KRW)
- `selfBirthYear` (integer): Claimant birth year (70+ extra deduction)
- `selfDisabled` (boolean): Claimant is disabled
- `selfFemale` (boolean): Claimant is a woman (woman-head deduction 500,000 KRW when earned income amount ≤ 30M)

### `calculate_kr_stock_major_shareholder_tax` (~322 tokens)

calculate kr stock major shareholder tax

Korean listed stock capital gains tax for major shareholders (상장주식 대주주 양도세) in 2026: major shareholder if, at the end of the previous business year, the holding in one stock was worth 5B KRW or more, or the stake was at least 1% (KOSPI) / 2% (KOSDAQ) / 4% (KONEX); the September 2025 plan to lower the line to 1B KRW was withdrawn. Tax = (gain − 2.5M basic deduction) × 20% up to a 300M tax base and 25% above (30% for non-SME shares held under one year) + 10% local income tax. Non-major individuals selling on the exchange owe none. Securities transaction tax not included.

Input parameters:

- `deductionUsed` (boolean): The 2.5M KRW basic deduction was already used on other share sales this year
- `gain` (number, required): Capital gain from this year's sales of the stock (sale − cost − fees) (KRW)
- `heldShare` (number): Stake on that date (0-1)
- `heldValue` (number, required): Market value of the stock held at the end of the previous business year (largest shareholder: include related parties) (KRW)
- `market` (required): Listing market
- `overOneYear` (boolean): Held for one year or more
- `sme` (boolean): Small and medium enterprise shares

### `calculate_kr_dismissal_notice_pay` (~256 tokens)

calculate kr dismissal notice pay

Korean dismissal notice pay (해고예고수당, 근로기준법 제26조): without 30 days' notice the employer owes 30 days of ordinary wage (the Ministry of Employment and Labor treats any shorter notice as owing the full 30 days). Exceptions: under 3 months of service, natural disaster making the business impossible, intentional serious damage listed in the enforcement rule. Applies to workplaces of any size; written notice (제27조) and unfair-dismissal remedy within 3 months (제28조) only for 5+ employees. Daily ordinary wage = monthly ordinary wage ÷ monthly paid hours (40 h/week = 209) × daily hours.

Input parameters:

- `exception`: 제26조 exception claimed by the employer
- `fivePlus` (boolean): Workplace normally employs 5 or more people
- `monthlyOrdinaryWage` (number, required): Monthly ordinary wage (기본급 + fixed monthly allowances) (KRW)
- `noticeDays` (integer, required): Days of notice before the dismissal date (0 = same day)
- `tenureMonths` (number, required): Months of continuous service
- `weeklyHours` (number): Contracted weekly hours (default 40)

### `calculate_kr_shutdown_allowance` (~251 tokens)

calculate kr shutdown allowance

Korean shutdown allowance (휴업수당, 근로기준법 제46조 · 시행령 제26조) when the employer suspends work for its own reasons: at least 70% of average wage for the shutdown days; the ordinary wage may be paid instead when 70% of average wage exceeds it; wages paid for partial work during the period are deducted first; less is allowed only with Labor Relations Commission approval; not applicable under 5 employees (시행령 별표 1). Average daily wage = 3-month wages ÷ calendar days.

Input parameters:

- `approvedReduction` (boolean): The Labor Relations Commission approved a lower allowance
- `calendarDays` (integer): Calendar days in those 3 months (default 92)
- `fivePlus` (boolean): Workplace normally employs 5 or more people
- `monthlyOrdinaryWage` (number, required): Monthly ordinary wage (KRW)
- `paidDuringShutdown` (number): Wages received for partial work during the shutdown (KRW)
- `shutdownDays` (integer, required): Calendar days of shutdown
- `threeMonthWages` (number, required): Total wages for the 3 months before the shutdown (KRW)

### `calculate_kr_reduced_hours_childcare_pay` (~216 tokens)

calculate kr reduced hours childcare pay

Korean reduced working hours for childcare benefit (육아기 근로시간 단축 급여) for 2026: child aged 12 or under (grade 6 or lower), hours after reduction 15-35 per week. First 10 weekly hours cut: monthly ordinary wage (base capped 2.5M, floor 0.5M KRW) × cut ÷ hours before; hours beyond 10: 80% of ordinary wage (cap 1.6M, floor 0.5M) × cut ÷ hours before (고용보험법 시행령 제104조의2). Returns the insurance benefit, the employer's reduced pay, the monthly total and the remaining loss.

Input parameters:

- `afterHours` (number, required): Weekly contracted hours after the reduction (15-35)
- `beforeHours` (number): Weekly contracted hours before (default 40)
- `monthlyOrdinaryWage` (number, required): Monthly ordinary wage on the start date (KRW)

### `check_kr_probation_minimum_wage` (~209 tokens)

check kr probation minimum wage

Korean probation minimum wage check (수습 최저임금) for 2026: 90% of the minimum wage (9,288 KRW/hour instead of 10,320) only for a contract of one year or more (or open-ended), within 3 months from the start of probation, and not in simple manual jobs (최저임금법 제5조②, 시행령 제3조). Returns the applicable minimum and the hourly and monthly shortfall (209 hours).

Input parameters:

- `contractMonths` (number, required): Contract length in months (0 = no fixed term)
- `hourlyWage` (number, required): Hourly wage paid (KRW)
- `monthlyHours` (number): Monthly paid hours (default 209)
- `monthsIntoProbation` (number, required): Months since probation started (0 in the first month)
- `simpleLabor` (boolean, required): Simple manual job (cleaning, security, delivery, kitchen help, shelving etc.)

### `plan_kr_annual_leave_promotion` (~210 tokens)

plan kr annual leave promotion

Korean annual leave use promotion schedule (연차 사용촉진, 근로기준법 제61조): annual leave (①) = written prompt within 10 days from 6 months before the period ends, worker replies within 10 days, employer designates dates in writing by 2 months before; first-year monthly leave (②) = prompt within 10 days from 3 months before (leave arising later: 5 days from 1 month before), designation by 1 month before (later leave: 10 days before). Only when every step is done in writing on time does the employer owe no pay for unused leave. Not applicable under 5 employees.

Input parameters:

- `kind` (required): annual = leave of workers with 1+ year; firstYear = monthly leave in the first year
- `periodEnd` (string, required): Last day the leave can be used (YYYY-MM-DD), e.g. 2027-12-31 for a fiscal-year system

### `check_kr_voluntary_quit_unemployment` (~259 tokens)

check kr voluntary quit unemployment

Korean unemployment benefit after voluntary resignation: checks the justified reasons in 고용보험법 시행규칙 별표 2 (amended 2024-07-01). Item 1 (worse conditions, unpaid wages, below minimum wage, overtime limit violations, shutdown pay under 70%) counts only if it lasted 2+ months within the year before leaving; commuting needs 3+ hours round trip; family care needs 30+ days and refused leave; health and pregnancy/childcare need refused leave or transfer. Also checks 180 insured days in the 18 months before leaving (제40조). Returns per-reason results with evidence to bring; the employment center decides.

Input parameters:

- `careDays` (number): Days of family care needed
- `commuteHours` (number): Round-trip commute hours after the change, by ordinary transport
- `insuredDays` (number, required): Insured (paid) days in the 18 months before leaving
- `leaveRefused` (boolean): The employer refused leave, a leave of absence or a job transfer
- `months` (number): Months within the year before leaving that an item-1 reason lasted
- `reasons` (array, required): Reasons for leaving

### `check_kr_subcontract_direct_payment` (~292 tokens)

check kr subcontract direct payment

Korean subcontract direct payment (하도급대금 직접 지급, 하도급법 제14조): the client (발주자) must pay the subcontractor directly when the prime contractor stops payment, goes bankrupt or loses its license (on request), the three parties agree, the prime missed 2+ installments (on request), or the prime gave no payment guarantee (on request); blocked when the prime documents the subcontractor's own wage or material arrears (③); limited to what the client has not yet paid the prime (④). Also late interest at 15.5% a year after 60 days from delivery (제13조⑧, FTC notice).

Input parameters:

- `cause` (required): Direct payment ground
- `daysSinceDelivery` (integer, required): Days since delivery or completion was accepted
- `missedInstallments` (integer): Installments the prime has not paid
- `ownerUnpaidToPrime` (number, required): Amount the client still owes the prime for that work (KRW)
- `primeStopRequest` (boolean): The prime documented the subcontractor's wage/material arrears and asked the client to stop
- `receivedFromPrime` (number, required): Amount already received from the prime (KRW)
- `requested` (boolean, required): The subcontractor asked the client for direct payment
- `workValue` (number, required): Subcontract price of the work done (KRW)

### `check_kr_family_loan_interest` (~229 tokens)

check kr family loan interest

Korean gift tax on a low- or zero-interest family loan (상증법 제41조의4): the benefit is interest at the statutory 4.6% (시행규칙 제10조의5) minus interest actually agreed; it is a gift only when the benefit reaches 10M KRW a year (then the whole benefit, recomputed every year). Returns the benefit, gift tax after the remaining 증여재산공제 and 3% filing credit, the largest interest-free principal (about 217.39M), the lowest safe rate for this principal and the lender's 27.5% withholding on interest received. The principal itself must be a real loan with repayment records.

Input parameters:

- `deductionLeft` (number): Borrower's unused gift deduction over 10 years (adult child 50M, minor 20M, spouse 600M) (KRW)
- `principal` (number, required): Loan principal (KRW)
- `rate` (number, required): Agreed annual interest rate as a decimal (0.02 = 2%)

### `check_kr_parent_house_free_use` (~238 tokens)

check kr parent house free use

Korean gift tax on living rent-free in a family member's property (상증법 제37조①): benefit = property value × 2% a year, summed over 5 years discounted at 10% (factor ≈ 3.7908); a gift only when it reaches 100M KRW (property ≈ 1.319B KRW) and not when living together with the owner. Also free use as loan collateral (제37조②): loan × 4.6% − interest paid, a gift from 10M KRW a year. Returns both benefits and gift tax.

Input parameters:

- `coResiding` (boolean): The user lives together with the owner in that home
- `collateralInterest` (number): Interest actually paid on that loan per year (KRW)
- `collateralLoan` (number): Loan borrowed using the property as free collateral (KRW)
- `deductionLeft` (number): Unused gift deduction over 10 years (KRW)
- `propertyValue` (number, required): Market value of the property (or standard value if none) (KRW)

### `check_kr_family_low_price_sale` (~168 tokens)

check kr family low price sale

Korean below-market sale between related parties: buyer gift (상증법 제35조①) when market value − price ≥ min(30% of market value, 300M KRW), gift value = the difference minus that threshold; seller capital gains recomputed at market value (소득세법 제101조, 시행령 제167조③) when the difference ≥ min(5%, 300M KRW). Returns both tests, gift tax and the lowest prices that avoid each.

Input parameters:

- `deductionLeft` (number): Buyer's unused gift deduction over 10 years (KRW)
- `marketValue` (number, required): Market value (appraisal or comparable sales) (KRW)
- `price` (number, required): Actual price between family members (KRW)

### `check_kr_commercial_rent_increase` (~320 tokens)

check kr commercial rent increase

Korean commercial lease rent increase cap (상가건물 임대차보호법): converted deposit = deposit + monthly rent × 100; if within the regional limit (Seoul 900M, other overcrowding zones and Busan 690M, metropolitan cities etc. 540M, elsewhere 370M KRW) increases are capped at 5% of rent or deposit (시행령 제4조) and allowed once a year (제11조②); converting deposit to rent is capped at min(12%, base rate × 4.5) (시행령 제5조). Above the limit, renewal rights (10 years), opposability and key-money protection still apply (제10조의2).

Input parameters:

- `baseRate` (number): Bank of Korea base rate as a decimal (default 0.03)
- `deposit` (number, required): Current deposit (KRW)
- `monthlyRent` (number, required): Current monthly rent (KRW)
- `monthsSinceLast` (integer, required): Months since the contract or the last increase
- `newDeposit` (number, required): Deposit the landlord asks for (KRW)
- `newMonthlyRent` (number, required): Monthly rent the landlord asks for (KRW)
- `region` (required): seoul; overcrowded = 과밀억제권역 outside Seoul and Busan; metro = metropolitan cities, Sejong, Paju, Hwaseong, Ansan, Yongin, Gimpo, Gwangju (Gyeonggi); other

### `calculate_kr_sme_youth_tax_reduction` (~200 tokens)

calculate kr sme youth tax reduction

Korean income tax reduction for young employees of SMEs (조특법 제30조): 15-34 at contract (military service up to 6 years subtracted), 90% of earned-income tax, capped at 2M KRW per year, for the months through 5 years after starting. Computes year-end tax with and without the reduction (social insurance estimated from salary), the end month and a 5-year estimate. The 2026 tax reform proposal to lengthen the period outside the capital region from 2027 is not applied.

Input parameters:

- `ageAtContract` (number, required): Age at the employment contract
- `militaryMonths` (number): Months of military service (max 72 counted)
- `persons` (integer): Basic deduction persons including self (default 1)
- `salary` (number, required): Annual taxable salary (KRW)
- `start` (string, required): Start month YYYY-MM

### `calculate_kr_yellow_umbrella_deduction` (~215 tokens)

calculate kr yellow umbrella deduction

Korean 노란우산공제 (small business mutual aid) income deduction (조특법 제86조의3): payments deducted from business income up to 6M (income ≤ 40M KRW), 5M (≤ 60M), 4M (≤ 100M) or 2M (above); small-company CEOs only with salary ≤ 80M, against earned income. Returns the limit, deduction and tax saved including local tax at progressive rates. Annual payment cap 18M from July 2026.

Input parameters:

- `income` (number, required): Business income (revenue − expenses, excluding real-estate rental); for ceo the total salary (KRW)
- `kind` (required): business = sole proprietor; ceo = small-company representative
- `otherDeductions` (number): Other income deductions such as personal deductions (default 1.5M) (KRW)
- `paid` (number, required): Payments this year (KRW)

### `compare_kr_general_vs_simplified_vat` (~235 tokens)

compare kr general vs simplified vat

Korean VAT: general vs simplified taxpayer (부가가치세법). Simplified allowed under 104M KRW annual sales including VAT (48M for real-estate rental etc.), pays sales × sector value-added rate (15-40%) × 10% − 0.5% of purchases, no refunds, exempt under 48M; general pays output − input VAT and can get refunds. Both get the 1.3% card-sales credit (cap 10M). Returns both taxes, which is cheaper, eligibility and the tax invoice duty.

Input parameters:

- `cardShare` (number): Share of sales paid by card or cash receipt (0-1)
- `purchases` (number, required): Annual purchases with tax invoices or cards, including VAT (KRW)
- `sales` (number, required): Annual sales including VAT (KRW)
- `sector` (required): retail = retail and restaurants 15%; manufacturing 20%; lodging 25%; construction = construction, transport, ICT 30%; service = other services 30%; professional = professional services, finance, real…

### `calculate_kr_business_car_expense` (~282 tokens)

calculate kr business car expense

Korean business passenger car expense limits (법인세법 제27조의2, 소득세법 제33조의2): without a logbook only 15M KRW of annual car costs count as business use; business-use depreciation (5-year straight line; lease = lease fee net of insurance/tax/repairs; long-term rent = 70% of rent) above 8M a year is carried over. Returns total, business ratio, deductible, disallowed, carry-over, tax saved and the amount deductible with a full logbook. Requires business-only car insurance; special corporations (500M/400M rules) not covered.

Input parameters:

- `amount` (number, required): own: purchase price incl. VAT; lease: annual lease fee net of included insurance/tax/repairs; rent: annual rent (KRW)
- `businessShare` (number): Business share of distance from the logbook (0-1)
- `logbook` (boolean, required): A business-use logbook is kept
- `marginalRate` (number): Marginal tax rate including local tax (0-1, default 0.264)
- `otherCosts` (number, required): Annual fuel, insurance, car tax, repairs, tolls (KRW)
- `ownership` (required): own = purchased; lease; rent = long-term rental

### `compare_kr_overseas_stock_vs_etf_tax` (~202 tokens)

compare kr overseas stock vs etf tax

Korean tax on the same gain via overseas stocks held directly (capital gains: 2.5M deduction then 22%, separate), a domestically listed overseas ETF (dividend income 15.4% withheld; above 20M of interest and dividends the excess is taxed at the marginal rate) or such an ETF inside an ISA (2M / 4M tax-free, then 9.9%). Returns the three taxes, the cheapest and the break-even gain (~8.33M).

Input parameters:

- `gain` (number, required): Realised gain this year (KRW)
- `isaLowIncome` (boolean): ISA low-income (서민형·농어민형) type
- `marginalRate` (number): Marginal rate for comprehensive taxation including local tax (0-1, default 0.264)
- `otherFinancial` (number): Other interest and dividend income this year (KRW)

### `check_kr_officetel_house_count` (~382 tokens)

check kr officetel house count

Korean officetel (오피스텔) house-count check by tax: acquisition tax counts officetels acquired from 2020-08-12 whose property tax is levied as housing (지방세법 시행령 제28조의4); capital-gains surcharge and comprehensive real estate tax count residential use in fact (소득세법 제88조); the 2024-01-10 small new-build rule (60㎡ or less, price 600M metro / 300M elsewhere, built and first sold 2024-01-10 to 2027-12-31) removes it from acquisition, surcharge and 종부세 counts but not from the one-house exemption test; housing subscription never counts officetels. Returns each test, the officetel's own 4.6% acquisition tax and the extra acquisition tax on the next home caused by the officetel.

Input parameters:

- `acquired` (string, required): Acquisition date (YYYY-MM-DD)
- `areaM2` (number): Exclusive area in m²
- `firstSaleNew` (boolean): New build (2024-01-10 to 2027-12-31) bought first from the developer
- `metro` (boolean): In the Seoul metropolitan area
- `nextHomePrice` (number): Price of the next home to buy (for acquisition tax comparison) (KRW)
- `nextRegulated` (boolean): Next home is in a regulated area
- `otherHouses` (number, required): Houses the household owns besides the officetel
- `price` (number, required): Officetel acquisition price (KRW)
- `propertyTaxAsHouse` (boolean): Property tax is levied as housing (default = residentialUse)
- `residentialUse` (boolean, required): Used as a home in fact (owner or tenant lives there)

### `compare_kr_ticket_vs_presale_tax` (~353 tokens)

compare kr ticket vs presale tax

Korean capital gains tax on a redevelopment/reconstruction member right (조합원입주권) vs an apartment pre-sale right (분양권) (소득세법 제104조①): member rights are taxed like houses (under 1 year 70%, under 2 years 60%, then 6-45%), original members get the long-term holding deduction on the gain up to the management-disposal approval date and the one-house exemption up to 1.2B if the old house qualified on that date; pre-sale rights are 70% under 1 year then 60%, with no deduction or exemption. 2.5M basic deduction, +10% local tax. Returns the chosen right's tax plus both totals.

Input parameters:

- `gain` (number, required): Capital gain (sale − purchase − expenses) (KRW)
- `holdYears` (number, required): Holding period in years (original members count from the old house's acquisition)
- `kind` (required): ticket = 조합원입주권; presale = 분양권
- `liveYears` (number): Years lived in the old house (one-house deduction table 2)
- `oneHouseExempt` (boolean): Met the one-house exemption on the approval date with no other house
- `original` (boolean): Original member who owned the old house
- `preApprovalGain` (number): Gain up to the management-disposal approval date (original members) (KRW)
- `salePrice` (number): Sale price (for the 1.2B high-price rule) (KRW)
- `yearsToApproval` (number): Years from old house acquisition to the approval date

### `compare_kr_inherited_house_valuation` (~273 tokens)

compare kr inherited house valuation

Inherited house: declare at the official price (기준시가) or an appraisal (감정평가)? The declared value becomes the acquisition cost when the heir sells (소득세법 시행령 제163조⑨), so a low value cuts inheritance tax but raises later capital gains tax. Computes inheritance tax (lump-sum 500M, spouse 500M-3B, appraisal fee up to 5M deducted, 3% filing credit, 10-50%) plus capital gains tax on a later sale (heir has another house, no surcharge; long-term deduction from the inheritance date) for both values and returns the cheaper choice.

Input parameters:

- `appraisal` (number, required): Appraised value (KRW)
- `appraisalFee` (number): Appraisal fee (default 2M) (KRW)
- `official` (number, required): Official (standard) price (KRW)
- `otherEstate` (number, required): Other net estate (after debts and funeral costs) (KRW)
- `salePrice` (number, required): Expected sale price (KRW)
- `spouse` (boolean, required): A spouse inherits
- `spouseAmount` (number): Amount the spouse actually inherits (KRW)
- `yearsAfter` (number, required): Years from inheritance to sale

### `plan_kr_inheritance_gift_filing_deadline` (~233 tokens)

plan kr inheritance gift filing deadline

Korean inheritance and gift tax filing deadlines (상증법 제67조·제68조): inheritance tax within 6 months (9 abroad) from the last day of the month of death, gift tax within 3 months from the last day of the month of the gift; also acquisition tax (지방세법 제20조), the deceased's income tax return, death report and renunciation deadlines, and the gift-return windows (제4조④). With tax and lateDays returns the 3% filing credit, no-filing penalty (20% with 50/30/20% relief for late filing within 1/3/6 months) and late-payment penalty (0.022% a day).

Input parameters:

- `abroad` (boolean): Deceased and all heirs live abroad (inheritance only)
- `date` (string, required): Date of death or gift (YYYY-MM-DD)
- `kind` (required): inheritance or gift
- `lateDays` (number): Days filed and paid after the deadline
- `tax` (number): Expected computed tax (KRW)

### `plan_kr_after_death_tasks` (~423 tokens)

plan kr after death tasks

What a Korean family must do after a death, with dated deadlines in order: death report (1 month from learning of the death, 가족관계등록법 제84조), 안심상속 one-stop asset and debt inquiry (1 year from the end of the month of death), renunciation or limited acceptance (3 months from learning, 민법 제1019조), unpaid wages and severance (employer pays within 14 days, 근로기준법 제36조), refusing a lease succession (1 month, 주택임대차보호법 제9조), closing a business VAT return (25 days after the month end), the deceased's income tax, inheritance acquisition tax, car transfer and inheritance tax (6 months from the month end, 9 abroad), life insurance and industrial-accident survivor claims (3 years) and National Pension survivor claims (5 years). Deadlines on holidays move to the next business day. Returns each task with where to go, what to bring, the statute and what happens if missed, plus overdue and next tasks for a given today.

Input parameters:

- `abroad` (boolean): Deceased and all heirs live abroad
- `business` (boolean): The deceased had a business registration
- `car` (boolean): Owned a car
- `deathDate` (string, required): Date of death (YYYY-MM-DD)
- `debts` (boolean): Debts may exceed assets
- `employed` (boolean): The deceased was an employee
- `insurance` (boolean): Life insurance may exist
- `knownDate` (string): Date the family learned of the death, if later
- `otherIncome` (boolean): The deceased had business, rental or pension income
- `pension` (boolean): National Pension member or recipient
- `realEstate` (boolean): Owned real estate
- `renting` (boolean): Family lived together in a rented home
- `today` (string): Today, to split overdue and next tasks
- `workAccident` (boolean): Death may be work-related

### `check_kr_youth_rent_support` (~404 tokens)

check kr youth rent support

Korean youth monthly rent support (청년월세 지원, MOLIT, ongoing from 2026, selected within budget): ages 19-34 living apart from parents without a home; youth household income at most 60% of the 2026 median and assets at most 122M KRW; parents' household income at most 100% of median and assets at most 470M (not checked from age 30, if married or an unmarried parent); deposit at most 50M and rent at most 600k (above that, rent + deposit × 2.5% ÷ 12 at most 700k). Pays actual rent up to 200k a month for 24 months, once, minus housing benefit; excludes public rentals, landlords within 2nd-degree kin and recipients of local rent programs. Returns each check, monthly and total.

Input parameters:

- `age` (number, required): Age
- `deposit` (number, required): Rental deposit (KRW)
- `excluded` (boolean): Public rental, landlord within 2nd-degree kin, or receiving a local rent program
- `housingBenefit` (number): Monthly housing benefit (rent part) (KRW)
- `livesApart` (boolean, required): Lives apart from parents
- `ownsHome` (boolean, required): Owns a home
- `parentAssets` (number, required): Parents' household assets (KRW)
- `parentExempt` (boolean): Parents' household check exempt (married, unmarried parent, etc.)
- `parentHousehold` (number): Parents' household size (incl. siblings)
- `parentIncome` (number, required): Parents' household monthly income (KRW)
- `rent` (number, required): Monthly rent excluding maintenance fees (KRW)
- `youthAssets` (number, required): Youth household assets (KRW)
- `youthHousehold` (number): Youth household size
- `youthIncome` (number, required): Youth household monthly income (KRW)

### `find_kr_policy_housing_loans` (~644 tokens)

find kr policy housing loans

Korean Housing and Urban Fund (주택도시기금) loan eligibility, 2026 rules from nhuf.molit.go.kr: buy = 내집마련 디딤돌 (income 60M / 70M first-time or 2+ children / 85M newlyweds, net assets 511M, price 500M / 600M, limit 200M / 240M / 320M, LTV 70%, first-time 80% outside the capital region), 신생아 특례 디딤돌 (birth within 2 years, income 130M or 200M dual with each ≤ 130M, price 900M, limit 400M), 청년 주택드림 디딤돌 (age ≤ 39, dream account 1 year and 10M + winning a sale, income 70M / 100M newlyweds, price 600M, limit 300M / 400M); jeonse = 버팀목 (income 50M / 60M two children / 75M newlyweds, net assets 345M, deposit 300M/200M or 400M/300M, limit 120M/80M or 250M/160M, 70% / 80% of deposit), 청년전용 버팀목 (19-34, 50M, deposit 300M, limit 150M or 120M under 25 single), 신생아 특례 버팀목 (deposit 500M/400M, limit 240M); monthly = 주거안정 월세대출 (deposit 100M, rent 600k, 14.4M). Returns each product with eligibility, blocking reasons, max loan and rate range, and the largest.

Input parameters:

- `age` (number, required): Age
- `amount` (number, required): Home price (buy) or deposit (jeonse, monthly) (KRW)
- `areaM2` (number): Exclusive area in m²
- `children` (number, required): Number of children
- `dreamAccount` (boolean): Youth housing dream account 1 year and 10M, and won a sale
- `dualIncome` (boolean): Both spouses earn
- `firstTimeBuyer` (boolean, required): First home purchase
- `higherEarner` (number): Higher of the two incomes (dual-income newborn rule) (KRW)
- `income` (number, required): Combined annual income of the couple (KRW)
- `metro` (boolean, required): Seoul metropolitan area
- `monthlyRent` (number): Monthly rent (monthly purpose) (KRW)
- `netAssets` (number, required): Combined net assets (KRW)
- `newbornWithin2y` (boolean, required): Birth or adoption within 2 years (born 2023 or later)
- `newlywed` (boolean, required): Married within 7 years or marrying within 3 months
- `purpose` (required): buy a home, jeonse deposit, or monthly rent
- `singleHousehold` (boolean): Single-person household head

### `check_kr_special_supply` (~518 tokens)

check kr special supply

Korean housing subscription special supply (특별공급) eligibility by type (주택공급에 관한 규칙 제40~47조의3): newlywed (married ≤ 7 years), newborn (child under 2), first-time buyer (never owned, 5 years of income tax; public also needs marriage or a child), multi-child (2+ minors), elderly-parent support (65+ parent for 3+ years, household head). Income is a share of the prior-year urban worker monthly income by household size (LH table, 3 or fewer people 7,533,763 KRW). Private: newlywed/newborn 100% (dual 120%) priority, 140% (160%) general, above that lottery if real estate ≤ 331M; first-time 130% / 160% / lottery; multi-child and elderly parent no income test. Public (general type): newlywed/first-time 100% (120%) / 130% (140%) / lottery 130% (200%); newborn 100% (120%) / 140% (150%) / 140% (200%); multi-child and elderly parent 120% (130%) / lottery 120% (200%); real estate ≤ 215.5M and car ≤ 45.42M. Returns each type's tier (priority, general, lottery, none) with reason, the income ratio and the best tier. The announcement prevails.

Input parameters:

- `car` (number): Car value (public) (KRW)
- `childUnder2` (boolean, required): Child under 2 (incl. pregnancy or adoption)
- `dualIncome` (boolean, required): Both spouses earn
- `elderParent3y` (boolean, required): Household head supporting a 65+ parent for 3+ years
- `householdSize` (number, required): Household members
- `marriedYears` (number): Years since marriage registration (omit if unmarried)
- `minorChildren` (number, required): Minor children incl. pregnancy
- `monthlyIncome` (number, required): Household average monthly income (KRW)
- `neverOwned` (boolean, required): No household member has ever owned a home
- `noHome` (boolean, required): No household member owns a home
- `realEstate` (number, required): Household real estate value (KRW)
- `sector` (required): private (민영) or public (공공분양 일반형)
- `taxPaid5y` (boolean, required): Paid income tax for 5+ years

### `get_kr_professional_scope` (~476 tokens)

get kr professional scope

Legal scope of Korean licensed professions — 세무사 (tax), 공인회계사 (accounting/audit), 공인노무사 (labor), 행정사 (administrative), 법무사 (court documents/registry), 보험계리사·손해사정사·보험설계사 (insurance actuarial, loss adjusting, registered sales), 관세사 (customs), 변리사 (patents/trademarks), 감정평가사 (appraisal), 공인중개사 (real estate brokerage) — with the statute article, the work a non-licensed person may not do as a business, the title-protection rules, free public help lines, and a who-can-do-what matrix (incl. 변호사). Use it to tell users what an AI legal-information assistant may and may not do, and when to hand off to a licensed professional.

Input parameters:

- `domain`: tax = 세금(세무사), accounting = 회계·장부(공인회계사), labor = 노동(공인노무사), admin = 행정(행정사), court = 등기·법원 서류(법무사), insurance = 보험(보험계리사·손해사정사·등록 설계사), customs = 관세·통관(관세사), ip = 특허·상표(변리사), appraisal = 감정평가·보상(감정평…

### `start_kr_law_intake` (~495 tokens)

start kr law intake

Clarify-first intake for Korean tax, accounting, labor, administrative, court/registry, insurance, customs, patent/trademark, appraisal/compensation and real estate brokerage problems (e.g. a tax notice, missed filing, inheritance/gift filing, home sale, bookkeeping duty, external audit test, dismissal, unpaid wages, workplace harassment, industrial accident, business suspension, permit refusal, fines, information disclosure, inheritance renunciation, ownership transfer registration, collecting a debt, jeonse deposit, corporate change registration, cancelling an insurance policy within the cooling-off period, illegal-contract termination, a denied/reduced insurance claim or rescission for non-disclosure, for insurance agents: gift (special benefit) limit and policy-replacement checks, overseas direct-purchase duty exemption, customs duty correction/refund/appeal, patent grace period after self-disclosure, patent/trademark rejection response, expropriation compensation objection, official land price objection, brokerage fee and transaction report, broker liability). Call it BEFORE answering: send the user's situation (or a topic id) and any answers collected so far; it returns the next 1-3 questions to ask (with why each matters), deadlines computed from the answers (first day excluded, month-end rules, weekend/holiday roll-over; national tax also skips Workers' Day) with days left, warnings with statute citations, plain-language statutes with law.go.kr links, OIYO calculators, documents to bring, where to find official forms and online applications (public site home page + search term; never fills them in), free public help lines and when a licensed professional is needed. Legal information only — not tax/labor/legal representation.

Input parameters:

- `answers` (object): Answers collected so far, keyed by the question keys this tool returned (strings, numbers in KRW / months / days, YYYY-MM-DD dates, 'yes'/'no'). Up to 20 keys.
- `domain`: Optional: restrict topic matching to one field
- `limit` (integer): How many next questions to return (default 3)
- `situation` (string): The user's situation in their own words (Korean works best). Used to pick the topic when topic is omitted.
- `today` (string): Reference date YYYY-MM-DD for days left (default: today in Asia/Seoul)
- `topic`: Topic id from a previous call. Overrides situation.

### `search_kr_statutes` (~351 tokens)

search kr statutes

Search a curated index of about 130 Korean statute articles used in everyday tax, accounting, labor, administrative, court/registry, insurance, customs, IP, appraisal and real estate matters (국세기본법, 소득세법, 상속세 및 증여세법, 부가가치세법, 지방세법, 법인세법, 외부감사법, 상법, 근로기준법, 근로자퇴직급여 보장법, 고용보험법, 산재보험법, 행정절차법, 행정기본법, 행정심판법, 행정소송법, 민원처리법, 정보공개법, 질서위반행위규제법, 민법, 민사소송법, 부동산등기 특별조치법, 주택임대차보호법, 보험업법, 금융소비자보호법, 관세법, 관세사법, 특허법, 상표법, 변리사법, 토지보상법, 부동산공시법, 감정평가법, 공인중개사법, 부동산거래신고법, 변호사법 ...). Returns the article, a plain-Korean summary (not the official text) and a law.go.kr link.

Input parameters:

- `domain`: Optional field filter
- `limit` (integer): Max results (default 8)
- `query` (string, required): Keywords, e.g. 경정청구, 부당해고 구제신청, 임차권등기, 과태료 이의제기

### `calculate_kr_fine_reduction` (~261 tokens)

calculate kr fine reduction

South Korea administrative fine (과태료) under 질서위반행위규제법: 20% reduction for voluntary payment within the opinion period (제18조, 시행령 제5조), 50% reduction for vulnerable people (시행령 제2조의2; the larger single reduction is applied), late-payment surcharge 3% plus 1.2% per month up to 60 months (제24조), and the opinion deadline from the notice date. Not traffic 범칙금.

Input parameters:

- `fine` (number, required): Fine amount on the advance notice (KRW)
- `monthsLate` (integer): Months past the payment due date (when late)
- `noticeDate` (string): Date the advance notice was received, YYYY-MM-DD
- `opinionDays` (integer): Opinion period on the notice in days (at least 10, default 10)
- `vulnerable` (boolean): 기초생활수급자·차상위·중증장애인·미성년자 등 (시행령 제2조의2)
- `when` (required): early = within the opinion period, due = after imposition but before the payment due date, late = after the due date

### `calculate_kr_import_duty` (~273 tokens)

calculate kr import duty

South Korea import duty and VAT: customs value = (price + freight + insurance) × customs FX rate (관세법 제30조), duty = value × rate, VAT = (value + duty) × 10%. Compares the general rate with an FTA preferential rate (only with proof of origin, FTA관세특례법 제8조) and checks the personal direct-purchase exemption (goods price ≤ USD 150, USD 200 from the US). Rates come from the user (HS code lookup at the customs law portal); no tariff classification. Excludes individual consumption/liquor taxes.

Input parameters:

- `baseRate` (number, required): General/WTO duty rate as a fraction, e.g. 0.13
- `freight` (number): Freight in USD
- `fromUS` (boolean): Shipped from the United States
- `ftaRate` (number): FTA preferential rate as a fraction (omit or equal to baseRate if none)
- `fx` (number, required): Customs FX rate, KRW per USD
- `hasOrigin` (boolean): Has a certificate/proof of origin
- `insurance` (number): Insurance in USD
- `personal` (boolean): Personal-use direct purchase
- `price` (number, required): Goods price in USD

### `simulate_ifrs17_csm` (~211 tokens)

simulate ifrs17 csm

Teaching model of IFRS 17 (K-IFRS 1117) general measurement: present value of premiums (start of year) vs claims and expenses (end of year) plus acquisition cost and a risk adjustment (% of outflow PV) → fulfilment cash flows, initial contractual service margin (CSM) or loss component, and the yearly CSM release with interest accretion and equal coverage units. Illustration only, not reserve certification.

Input parameters:

- `acquisition` (number): One-off acquisition cost (KRW)
- `claims` (number, required): Expected claims per year (KRW)
- `expense` (number): Maintenance expense per year (KRW)
- `premium` (number, required): Annual premium (KRW)
- `ra` (number): Risk adjustment as a fraction of the outflow PV, e.g. 0.05
- `rate` (number, required): Discount rate as a fraction, e.g. 0.03
- `years` (integer, required): Coverage years

### `calculate_kics_ratio` (~195 tokens)

calculate kics ratio

Teaching model of the Korean insurance solvency ratio K-ICS: basic required capital = √(Σ ρij·Ri·Rj) over life/long-term, general non-life, market and credit risk (illustrative Solvency II-like correlations), plus operational risk minus tax adjustment; ratio = available capital ÷ required capital, with prompt corrective action bands (100% / 50% / 0%). Not the supervisory calculation.

Input parameters:

- `available` (number, required): Available capital (KRW)
- `credit` (number): Credit risk (KRW)
- `life` (number): Life and long-term non-life underwriting risk (KRW)
- `market` (number): Market risk (KRW)
- `nonlife` (number): General non-life underwriting risk (KRW)
- `operational` (number): Operational risk (KRW)
- `taxAdj` (number): Tax adjustment (KRW)

### `calculate_insurance_claim_payout` (~219 tokens)

calculate insurance claim payout

Insurance payout from (a) permanent disability: sum insured × disability rate, rates of several body parts added and capped at 100%, pre-existing disability of the same part deducted (Korean standard policy disability table); or (b) a fault-based loss: damage × (1 − own fault %) − deductible, capped at the policy limit (민법 제396조·제763조). Calculation only; not loss adjusting or a fault ruling.

Input parameters:

- `damage` (number): Damage amount (KRW)
- `deductible` (number): Deductible (KRW)
- `fault` (number): Own fault as a fraction
- `kind` (required): disability = 후유장해 보험금, fault = 과실상계 보상
- `limit` (number): Policy limit (KRW, 0 = none)
- `prior` (number): Pre-existing disability rate of the same part, fraction
- `rates` (array): Rates per body part
- `sum` (number): Disability sum insured (KRW)

### `analyze_journal_entries` (~144 tokens)

analyze journal entries

Journal-entry analytics for audit and internal control: Benford first-digit distribution with MAD conformity (Nigrini bands), weekend/Korean public holiday postings, exact duplicates (date+account+amount), amounts just below an approval limit (95-100%), round millions and period-end postings; returns counts and the riskiest entries first. Signals are an order to review, not evidence of fraud or an audit opinion.

Input parameters:

- `approvalLimit` (number): Approval limit (KRW); amounts at 95-100% of it are flagged
- `entries` (array, required): Journal lines
- `top` (integer): How many flagged entries to return (default 30)

### `check_kr_privacy_breach_policy` (~404 tokens)

check kr privacy breach policy

Korean Personal Information Protection Act helper for businesses. mode=breach (default): from the time a leak (incl. loss or theft) became known, returns the 72-hour deadline to notify data subjects (제34조①, 시행령 제39조; hours, not moved for holidays), whether a report to PIPC or KISA is also required within 72 hours (1,000+ people, sensitive or unique identifiers, or unlawful external access such as hacking; 시행령 제40조), the five required notice items and ordered steps (30-day website posting when contacts are unknown). mode=policy: checks a pasted privacy policy for required items (purpose, items, retention, destruction, rights, privacy officer, safety measures, remedies, changes; plus cookies, outsourcing, third-party provision and overseas transfer when they apply; 제30조①, 시행령 제31조①) by keyword and lists what seems missing. Keyword check only; no filing or drafting.

Input parameters:

- `affected` (number): Number of people affected, estimate (breach)
- `contactUnknown` (boolean): Some people cannot be contacted individually (breach)
- `hacking` (boolean): Caused by unlawful external access such as hacking (breach)
- `knownAt` (string): When the breach became known, YYYY-MM-DD or YYYY-MM-DDTHH:mm (breach)
- `mode`: breach = 72-hour clock, policy = privacy policy checklist
- `outsource` (boolean): Outsources delivery, payment, hosting or support (policy)
- `overseas` (boolean): Transfers data overseas (policy)
- `policyText` (string): Privacy policy text in Korean (policy)
- `sensitive` (boolean): Sensitive data or unique identifiers such as resident numbers (breach)
- `thirdParty` (boolean): Provides data to other companies (policy)
- `website` (boolean): Collects through a website or app, cookies (policy)

### `check_kr_freelance_contract` (~301 tokens)

check kr freelance contract

Reads a Korean freelance or outsourcing service contract (용역·외주 계약서) for the freelancer before signing. Checks by keyword for 13 items that prevent disputes (scope and deliverables, deadline, fee, payment date (민법 제665조), tax handling 3.3% or VAT, acceptance, revision count, copyright ownership and portfolio use (when deliverables are copyrightable; 저작권법 제45조), termination settlement (민법 제673조), liability cap (민법 제398조), confidentiality, dispute resolution) and flags risky sentences: transfer of all rights, unlimited revisions, payment only after the end client pays, one-sided termination, large penalties, fixed office hours or supervision (possible employee status, 근로기준법 제2조), non-compete. Notes payment terms over 60 days (하도급법 제13조). With amount, returns take-home pay: 3% income tax + 0.3% local tax withheld, or +10% VAT for a registered business. Keyword check only; never drafts or edits the contract.

Input parameters:

- `amount` (number): Contract amount in KRW before tax (optional)
- `contractText` (string, required): Contract text in Korean
- `creative` (boolean): Deliverables are copyrightable: design, writing, video, photos, software
- `registered` (boolean): The freelancer is a registered general VAT business

### `get_kr_practice_guide` (~228 tokens)

get kr practice guide

Korean practice checklists for work next to licensed professions: business permit filings (restaurant/cafe, online retail, beauty), foreigner stay deadlines (registration 90 days, address change 15 days, extension window), public e-portals (Hometax, 4 social insurances/Work24, Internet Registry, e-Court, UNI-PASS, Patent-ro) and how to read professional documents (loss adjustment report, appraisal report, broker's confirmation statement, patent specification/claims, import declaration documents). Returns what to prepare, what to check (with statute citations), deadlines computed from given dates (first day excluded, holiday roll-over), official links and who may act as representative. Information only; no filing or drafting.

Input parameters:

- `case` (string): Case id within the guide (from the list). Omit to get every case of the guide.
- `dates` (object): Start dates keyed by deadline id from a previous call, YYYY-MM-DD. Up to 10 keys.
- `guide`: Guide slug. Omit to list guides and cases.

### `check_insurance_explanation_record` (~208 tokens)

check insurance explanation record

Insurance sales record check under the Korean Financial Consumer Protection Act: suitability items (제17조), material explanations (제19조, incl. replacement comparison when switching), how the explanation document was delivered and how understanding was confirmed (signature, seal or recording). Returns missing items, the cooling-off outer date (청약일 + 30 days, 제46조), the 10-year retention date (제28조) and a copy-ready Korean record text. Not an official compliance determination.

Input parameters:

- `confirm`: How understanding was confirmed
- `customer` (string): Customer initials or label (avoid full personal data)
- `date` (string): Application date YYYY-MM-DD
- `delivered`: How the explanation document was given
- `explained` (array): Material items explained
- `note` (string): Notes
- `product` (string): Product name
- `replace` (boolean): Replacing an existing policy
- `suitability` (array): Suitability items checked

### `calculate_kr_corporate_tax` (~422 tokens)

calculate kr corporate tax

South Korea corporate income tax estimate for 2026 from book numbers: tax adjustments (entertainment expense limit 법인세법 제25조 with culture extra, donation limits 제24조 special 50% / general 10%, loss carryforward 80% for general companies 제13조), tax base, 2026 rates 10/20/22/25% (9/19/21/24% before 2026 changes are not used), minimum tax 7% SME / 10-17% general (조특법 제132조), tax due after credits and prepaid tax, and next year's interim prepayment (half of this year's tax). Estimate only; no filing.

Input parameters:

- `addBack` (number): Other add-backs (손금불산입·익금산입)
- `credits` (number): Credits and reductions subject to minimum tax
- `creditsOutside` (number): Credits outside minimum tax (foreign tax etc.)
- `cultureEntertainment` (number): Culture entertainment expense spent
- `deduct` (number): Other deductions (손금산입·익금불산입)
- `entertainment` (number): Entertainment expense spent
- `entertainmentNoProof` (number): Entertainment without legal proof (fully disallowed)
- `generalDonation` (number): 일반기부금
- `losses` (number): Loss carryforward available
- `months` (integer): Months in the fiscal year (default 12)
- `prepaid` (number): Interim prepayment and withholding already paid
- `profit` (number, required): Book profit before income tax (KRW, may be negative)
- `relatedRevenue` (number): Part of revenue from related parties
- `revenue` (number): Revenue for the entertainment limit
- `size` (required): sme = 중소기업, general = 일반법인
- `smallRealEstate` (boolean): Small real-estate rental company (19% lowest bracket, 법인세법 제55조)
- `specialDonation` (number): 특례기부금

### `calculate_kr_tax_penalty` (~305 tokens)

calculate kr tax penalty

South Korea national tax penalties (가산세, 국세기본법): failure to file 20% (fraud 40%) or 0.07% of revenue for bookkeeping businesses, under-reporting 10% (fraud 40%), late payment 0.022% per day, withholding late payment 3% + 0.022%/day capped at 10%, and the reduction for late filing (50/30/20% within 1/3/6 months) or amended return (90%…10% within 1 month…2 years). Shows when the next reduction step ends. No reduction after a tax audit notice.

Input parameters:

- `due` (string, required): Statutory filing and payment due date
- `filed` (string): Date of late or amended filing
- `fraud` (boolean): Fraudulent (부정행위)
- `kind` (required): none = did not file, under = under-reported, withholding = withholding tax paid late
- `noticed` (boolean): Filed after a tax audit notice (no reduction)
- `paid` (string): Date actually paid (default: filed date, or today)
- `revenue` (number): Revenue, for the 0.07% comparison when a bookkeeping business did not file
- `tax` (number, required): Tax not reported or paid (KRW)
- `today` (string): Reference date YYYY-MM-DD for days left (default: today)

### `find_kr_appeal_deadlines` (~195 tokens)

find kr appeal deadlines

Korean objection and appeal deadlines (불복·이의신청) from the date a decision or notice was received: tax (이의신청·심사·심판 90 days), administrative appeal and suit (90 days), labor (부당해고 구제 3 months), court (항소 2 weeks, 지급명령 이의 2 weeks), insurance, customs, patents, traffic fines and more (31 rules). First day excluded, weekend/holiday roll-over. Give a rule key for one deadline or a domain to filter. Follow the decision letter if it states a different period.

Input parameters:

- `domain`: Filter by domain
- `from` (string, required): Date the decision or notice was received YYYY-MM-DD
- `key`: One rule key (omit for all)
- `today` (string): Reference date YYYY-MM-DD for days left (default: today)

### `calculate_kr_inheritance_reserve` (~349 tokens)

calculate kr inheritance reserve

Korean statutory inheritance shares (민법 제1009조: spouse 1.5 vs 1 per child or parent) and forced-heirship reserve shortfall (유류분, 민법 제1112조 as amended 2026-03-17: children and spouse 1/2, parents 1/3, siblings removed). Reserve basis = estate + lifetime gifts to heirs + gifts to others within 1 year − debts. Gifts and bequests are keyed by heir id (spouse, child1, child2, parent1 …). Returns each heir's share, reserve, what they received and the shortfall, plus the 1-year / 10-year claim limits. Excludes representation, renunciation and contribution shares.

Input parameters:

- `bequests` (object): Bequests to heirs keyed by heir id
- `children` (integer): Number of children (or their descendants as one line each)
- `death` (string): Date of death (10-year claim limit)
- `debts` (number): Debts of the deceased
- `estate` (number, required): Positive estate at death including bequeathed property (KRW)
- `gifts` (object): Lifetime gifts to heirs keyed by heir id, e.g. {"child1": 300000000}
- `parents` (integer): Number of surviving parents
- `siblings` (integer): Number of siblings (heirs only when no spouse, child or parent)
- `spouse` (boolean): Spouse survives
- `thirdBequests` (number): Bequests to non-heirs
- `thirdGifts` (number): Gifts to non-heirs within 1 year before death

### `simulate_kr_auction_distribution` (~300 tokens)

simulate kr auction distribution

Korean court auction distribution (경매 배당) estimate in priority order: auction costs, small-tenant top priority (주택임대차보호법 제8조, region and table by the senior mortgage date, capped at 1/2 of the sale), wage priority, current-property tax, then mortgages, taxes and tenants with fixed-date priority by date, then other wages and general creditors. Shows what each tenant and creditor gets. Simplified; the court's table decides.

Input parameters:

- `baseDate` (string): Senior mortgage registration date (picks the small-tenant table)
- `claims` (array): Dated secured claims and taxes
- `cost` (number): Auction costs
- `currentTax` (number): Tax levied on this property (당해세)
- `general` (number): General unsecured claims
- `region` (required): seoul, overcrowded = 과밀억제권역(세종·용인·화성·김포 포함), metro = 광역시 등, other
- `sale` (number, required): Sale price (매각대금, KRW)
- `tenants` (array): Tenants
- `today` (string): Reference date YYYY-MM-DD for days left (default: today)
- `wageOther` (number): Other wage claims
- `wagePriority` (number): Last 3 months' wages, 3 years' severance, accident compensation

### `calculate_kr_customs_practice` (~426 tokens)

calculate kr customs practice

Korean customs practice estimates (관세법): mode travel = traveler's duty-free USD 800 and 20% simple rate with 30% self-report reduction (cap KRW 200,000) or 40%/60% penalty; mode direct = personal direct-purchase orders arriving the same day bundled against the USD 150 (USD 200 from US) exemption; mode rvc = FTA regional value content build-down or build-up against a threshold; mode refund = simplified fixed-rate drawback (간이정액환급) per KRW 10,000 of FOB with the 2-year claim limit. Rates come from the user; no classification or declaration.

Input parameters:

- `accepted` (string): refund: export acceptance date (2-year limit)
- `caught`: travel: caught without reporting (repeat = more than twice in 2 years)
- `dutyRate` (number): direct: duty rate as a fraction (default 0.08)
- `fobKrw` (number): refund: export FOB in KRW
- `fx` (number): travel/direct: customs FX rate KRW per USD
- `method`: rvc: method
- `mode` (required): Which calculation
- `nonOriginating` (number): rvc: value of non-originating materials
- `orders` (array): direct: orders
- `originating` (number): rvc: value of originating materials (build-up)
- `perTenThousand` (number): refund: drawback per KRW 10,000 from the fixed-rate table
- `rate` (number): travel: simple rate as a fraction (default 0.2)
- `selfReport` (boolean): travel: self-reported
- `threshold` (number): rvc: required RVC as a fraction, e.g. 0.4
- `totalUsd` (number): travel: goods bought abroad in USD (excluding separate liquor/tobacco/perfume allowances)
- `value` (number): rvc: adjusted value (usually FOB)

### `check_kr_workforce` (~215 tokens)

check kr workforce

Korean workplace size and schedule check (근로기준법): mode count = regular headcount from daily worker counts over the past month (시행령 제7조의2 average plus the half-of-days rule) against 5 / 10 / 30 thresholds; mode schedule = a weekly shift list checked for daily 8 h / weekly 40 h, overtime cap 12 h (minors 7/35/5), breaks (30 min per 4 h, 1 h per 8 h), night hours 22-06, weekly paid holiday and the 15-hour weekly-holiday-pay line. Small (<5) workplaces skip overtime caps and premiums.

Input parameters:

- `daily` (array): count: workers on each operating day (exclude dispatched workers)
- `minor` (boolean): schedule: worker under 18
- `mode` (required): Which check
- `shifts` (array): schedule: shifts for one week
- `small` (boolean): schedule: fewer than 5 regular workers

### `build_accounting_schedule` (~421 tokens)

build accounting schedule

Accounting schedules (K-IFRS / 일반기업회계기준): mode depreciation = straight-line, declining-balance (rate from residual, 5% if none) or sum-of-years with a partial first year; mode lease = IFRS 16 lease liability and right-of-use asset with interest and principal per period; mode bond = effective-interest amortization of a bond discount or premium; mode audit = whether a Korean company needs an external audit next year (외부감사법 시행령 제5조: listed, assets or revenue ≥ 50 billion, or 2 of 4 size tests, 3 of 5 for 유한회사). Estimates; no audit opinion.

Input parameters:

- `advance` (boolean): lease: payments at the start of each period
- `assets` (number): audit: total assets at last year end
- `cost` (number): depreciation: acquisition cost
- `couponRate` (number): bond: coupon rate per period
- `directCost` (number): lease: initial direct costs
- `employees` (integer): audit: employees
- `face` (number): bond: face value
- `firstMonths` (integer): depreciation: months used in the first year (default 12)
- `liabilities` (number): audit: total liabilities
- `listed` (boolean): audit: listed or about to list
- `llc` (boolean): audit: 유한회사
- `marketRate` (number): bond: market (effective) rate per period
- `members` (integer): audit: members (유한회사)
- `method`: depreciation: method
- `mode` (required): Which schedule
- `payment` (number): lease: payment per period
- `periods` (integer): lease/bond: number of periods
- `rate` (number): lease: incremental borrowing rate per period as a fraction
- `residual` (number): depreciation: residual value
- `revenue` (number): audit: revenue
- `years` (integer): depreciation: useful life in years

### `calculate_kr_license_points` (~314 tokens)

calculate kr license points

Korean driver's license penalty points (도로교통법 시행규칙 별표 28, 2025-12-02 version): mode status = running points from a dated history — suspension at 40 points (1 point = 1 day), revocation at 121 in 1 year / 201 in 2 / 271 in 3, expiry of under-40 points after 1 clean year, 20-point education reduction, 10-point pledge credits; events may give points directly or a violation id (speed100, speed80, speed60, speed40, speed20, drunk, signal, center, pedestrian, phone) with school-zone doubling. Mode surcharge = business suspension days converted to a monetary penalty (daily amount × days, 1 month = 30 days, cap 1 billion by default). Not a police decision.

Input parameters:

- `asOf` (string): status: reference date (default today)
- `cap` (number): surcharge: legal cap (default 1,000,000,000)
- `days` (integer): surcharge: suspension days
- `education` (boolean): status: completed the reduction course
- `events` (array): status: point history
- `mileage` (integer): status: completed 1-year pledges (10 points each)
- `mode` (required): Which calculation
- `months` (number): surcharge: suspension months (30 days each)
- `perDay` (number): surcharge: amount per day from the statute's table

### `estimate_kr_appraisal_compensation` (~512 tokens)

estimate kr appraisal compensation

Korean appraisal methods and expropriation compensation structure (감정평가에 관한 규칙, 토지보상법): mode cost = replacement cost minus straight-line depreciation; comparison = comparable unit prices × situation × time × regional × individual factors, weighted; income = net operating income ÷ cap rate; reconcile = weighted values and spread; land = official land price × land-price change × factors × area; business = business loss (pause: profit for the pause months + fixed costs + moving, close: 2 years' profit + sale loss); relocation = housing relocation allowance (owner 2 months, tenant 4 months of household spending). Learning estimate, not an appraisal.

Input parameters:

- `age` (number): cost: elapsed years
- `annualProfit` (number): business: annual operating profit
- `area` (number): land: area m²
- `capRate` (number): income: cap rate
- `comps` (array): comparison: comparables
- `expenses` (number): income: operating expenses
- `fixedCosts` (number): business: fixed costs during the pause
- `grossIncome` (number): income: potential gross income
- `individual` (number): land: individual factor
- `kind`: business: pause or close
- `land` (number): cost: land value to add
- `landChange` (number): land: land-price change rate since the notice date as a fraction
- `mode` (required): Which calculation
- `monthlySpending` (number): relocation: monthly household spending for the household size (통계청)
- `months` (number): business: pause months (default 4)
- `moving` (number): business: moving costs
- `officialPrice` (number): land: official standard land price per m²
- `other` (number): land: other factor
- `regional` (number): land: regional factor
- `replacementCost` (number): cost: replacement cost
- `residualRate` (number): cost: residual rate
- `saleLoss` (number): business: loss on selling assets (close)
- `subjectArea` (number): comparison: subject area m²
- `tenant` (boolean): relocation: tenant (4 months) rather than owner (2 months)
- `usefulLife` (number): cost: economic life in years
- `vacancy` (number): income: vacancy and loss rate
- `values` (array): reconcile: values by method

### `plan_kr_ip_deadlines` (~308 tokens)

plan kr ip deadlines

Korean patent, utility model, design and trademark deadlines (특허법·실용신안법·디자인보호법·상표법): priority claim 12 months (6 for designs and trademarks), grace period for own disclosure 12 months, PCT national phase 31 months, examination request 3 years, office action response period, appeal or re-examination 3 months from a final rejection, registration fee within 3 months of the grant decision (+6 months late), terms (patent and design 20 years from filing, utility model 10, trademark 10 from registration) and the trademark renewal window (last year before expiry, or 6 months after). First day excluded and holiday roll-over. Follow the office's notice when it differs.

Input parameters:

- `decisionServed` (string): Grant decision served date
- `disclosed` (string): Date the applicant disclosed the invention or design
- `filed` (string): Filing date
- `kind` (required): Right type
- `noticeMonths` (integer): Response period in months on the notice (default 2)
- `noticeServed` (string): Office action (의견제출통지) served date
- `priority` (string): Earliest priority (first filing) date
- `registered` (string): Registration date
- `rejectionServed` (string): Final rejection served date
- `today` (string): Reference date YYYY-MM-DD for days left (default: today)

### `calculate_kr_vat_credits` (~366 tokens)

calculate kr vat credits

Korean VAT credits (부가가치세법, 2026): mode deemed = deemed input tax on untaxed farm and fishery purchases (조특법·부가세법 제42조: individual restaurants 9/109 up to KRW 200M tax base else 8/108, corporate restaurants and bakeries 6/106, SME manufacturers 4/104, others 2/102) with the limit ratio of the tax base; mode card = credit-card sales credit 1.3% up to KRW 10M a year for individuals with prior-year supply ≤ 1 billion (제46조); mode bad-debt = bad-debt credit 10/110 and the last period to claim (10 years after supply). The 2027 government proposal (1.2%, 5M) is not law yet.

Input parameters:

- `amount` (number): bad-debt: bad-debt amount including VAT
- `cardSales` (number): card: card and cash-receipt sales including VAT
- `confirmed` (string): bad-debt: date the bad debt was confirmed
- `corp` (boolean): deemed/card: corporation
- `mode` (required): Which credit
- `payable` (number): card: VAT payable before this credit
- `priorYearSupply` (number): card: prior-year supply value
- `purchases` (number): deemed: purchases of untaxed farm/fishery products
- `supplied` (string): bad-debt: supply date
- `taxBase` (number): deemed: VAT tax base (supply value) for the period
- `type`: deemed: business type
- `usedThisYear` (number): card: credit already used this year

### `check_kr_franchise_contract` (~247 tokens)

check kr franchise contract

Korean franchise contract deadlines for a franchisee (가맹사업법): 14-day cooling-off after the disclosure document (7 days with legal advice, 제7조), contract given 14 days before signing (제11조), refund demand within 4 months (제10조), sales forecast in writing for big franchisors (제9조), renewal request window 180-90 days before expiry and the 10-year renewal right (제13조), termination requiring 2 written notices with 2 months' cure (제14조). Deadline check only; no representation.

Input parameters:

- `advised` (boolean): Got advice from a lawyer or franchise consultant
- `bigHq` (boolean): Franchisor is not an SME or has 100+ outlets
- `contractGiven` (string): Date the contract text was received
- `currentEnd` (string): End of the current contract term
- `firstStart` (string): Start of the first contract (10-year renewal right)
- `infoGiven` (string): Date the disclosure document (정보공개서) was received
- `signed` (string): Signing or franchise-fee payment date

### `check_kr_apartment_management` (~206 tokens)

check kr apartment management

Korean apartment complex management check (공동주택관리법): whether the complex is under mandatory professional management (300+ households, or 150+ with elevator, central/district heating or mixed use), defect warranty end dates (2 years finishing, 3 equipment, 5 structure/waterproofing, 10 load-bearing; common areas from use approval, units from handover), the month long-term repair reserves start and the next 3-year repair plan review. Information only.

Input parameters:

- `centralHeating` (boolean): Central or district heating
- `elevator` (boolean): Has elevators
- `handover` (string): Date the unit was handed over
- `households` (integer, required): Number of households
- `mixedUse` (boolean): Mixed-use building (주상복합)
- `today` (string): Reference date YYYY-MM-DD for days left (default: today)
- `useApproval` (string): Use approval (사용검사) date

### `calculate_kr_deferred_tax` (~246 tokens)

calculate kr deferred tax

Deferred tax under K-IFRS 1012 / 일반기업회계기준 22장: temporary differences × the rate expected when they reverse (default: 2026 average corporate tax rate incl. 10% local income tax for an expected tax base), deferred tax asset limited by expected future taxable income plus reversing taxable differences, deferred tax liability, change from opening net balance, total income tax expense, effective tax rate and a summary journal entry. Planning estimate; recognition is the company's and auditor's judgment.

Input parameters:

- `currentTax` (number): Current tax payable incl. local income tax
- `expectedBase` (number): Expected tax base in reversal years (for the average rate, default 300,000,000)
- `futureIncome` (number): Expected future taxable income available (omit = fully recoverable)
- `items` (array, required): Temporary differences
- `openingNet` (number): Opening net deferred tax asset (liability negative)
- `pretaxIncome` (number): Profit before tax (for effective rate)
- `rate` (number): Rate when differences reverse (e.g. 0.209). Omit to use expectedBase

### `plan_kr_audit_materiality_sample` (~291 tokens)

plan kr audit materiality sample

Audit planning numbers (Korean auditing standards = ISA): overall materiality from a benchmark × % (ISA 320; typical ranges, not legal rates), performance materiality by risk (low 75%, medium 65%, high 50%), clearly trivial threshold (ISA 450), monetary unit sample size n = population × reliability factor ÷ (tolerable − expected × expansion factor) and sampling interval, and attribute sample size for tests of controls with zero expected deviations (ISA 530). Planning aid only; no audit opinion.

Input parameters:

- `base` (number): Benchmark amount (KRW)
- `benchmark`: Materiality benchmark
- `confidence`: Confidence level % (default 95)
- `controlPopulation` (integer): Number of control occurrences (finite population correction)
- `expected` (number): Expected misstatement for MUS
- `pct` (number): Benchmark % as a fraction (default: typical for the benchmark)
- `population` (number): Population book value for MUS
- `risk`: Engagement risk for performance materiality
- `tolerable` (number): Tolerable misstatement for MUS (default: performance materiality)
- `tolerableRate` (number): Tolerable deviation rate for attribute sampling (e.g. 0.05)
- `trivialPct` (number): Clearly trivial as a fraction of overall (default 0.05)

### `calculate_kr_injury_disability_benefit` (~180 tokens)

calculate kr injury disability benefit

Korean industrial accident disability benefit (산재보험법 제57조, 시행령 별표 2): days by grade 1-14 × daily average wage clamped to the 2026 maximum 268,299 / minimum 82,560 KRW; grades 1-3 pension only, 4-7 pension or lump sum (with break-even years), 8-14 lump sum only; pension advance (선급) and the 5-year claim deadline from the healing date (제112조). Estimate only; grades are decided by 근로복지공단.

Input parameters:

- `avgWage` (number, required): Daily average wage (KRW)
- `grade` (integer, required): Disability grade 1-14
- `healed` (string): Healing (symptom fixed) date YYYY-MM-DD

### `check_kr_court_deposit` (~193 tokens)

check kr court deposit

Korean court deposit (공탁) check: whether the payment-deposit ground exists (refusal, inability to receive, unknown creditor; 민법 제487조), deposit interest at 0.35% a year (공탁금의 이자에 관한 규칙, since 2022-10-01, day-count approximated), and the 10-year extinctive prescription date for withdrawal (공탁법 제9조); criminal deposits (형사공탁) note. Estimate only; no filing.

Input parameters:

- `amount` (number, required): Deposit amount (KRW)
- `criminal` (boolean): Criminal case deposit (형사공탁)
- `deposited` (string): Deposit date
- `exercisable` (string): Date withdrawal became possible (default: deposit date)
- `ground`: Ground for the payment deposit
- `withdrawn` (string): Withdrawal date (default: today)

### `estimate_kr_self_registration_cost` (~275 tokens)

estimate kr self registration cost

Total cost of doing a Korean home purchase ownership-transfer registration yourself (셀프 등기): acquisition tax with local education and rural special tax (2026 rates by house count and regulated area), national housing bond purchase by standard price bracket (metro/other) and the discount loss when sold immediately, stamp duty on the contract (buyer's half; homes ≤100M exempt), registration filing fee (e-filing 10,000 / e-form 15,000 / paper 18,000), other costs, comparison with an agent fee, and the 60-day deadline steps. Estimate only.

Input parameters:

- `agentFee` (number): Quoted agent fee for comparison
- `bondDiscount` (number): Bond discount rate when sold immediately (e.g. 0.06)
- `houses` (integer): Houses owned including this one (1-4)
- `method`: Filing method
- `metro` (boolean): Seoul or a metropolitan city
- `other` (number): Other costs (documents, transport)
- `over85` (boolean): Exclusive area over 85㎡
- `price` (number, required): Purchase price (KRW)
- `regulated` (boolean): Regulated area (조정대상지역)
- `standardPrice` (number, required): Standard (official) price for the bond bracket

### `calculate_kr_f27_points` (~349 tokens)

calculate kr f27 points

Korean points-based residence visa (F-2-7) score under 법무부 고시 제2025-408호: age, education (STEM or double degree), Korean (TOPIK or KIIP level), annual income (needs minimum-wage proof), bonus points capped at 40 (ministry recommendation, KIIP level 5, Korean or top-ranked university degree, volunteering, Korean War participant country), penalties up to 70 (immigration fines, criminal fines); pass mark 80 and the gap. Eligibility and disqualification must be checked separately. Estimate only.

Input parameters:

- `aboveMinimumWage` (boolean): Income at least the minimum wage (default true)
- `age` (integer, required): Age
- `criminal`: Criminal fines
- `degree` (required): Highest degree
- `immigration`: Immigration law fines in 3 years
- `income` (number, required): Annual income from the income certificate (KRW)
- `kiip5` (boolean): Completed KIIP level 5
- `korean` (integer, required): Higher of TOPIK level or KIIP stage (0-5)
- `koreanUniDegree`: Degree from a Korean university
- `ministryRecommend` (boolean): Recommended by a central ministry
- `stemOrDouble` (boolean): STEM degree or two or more degrees
- `topUniDegree`: Degree from a top-ranked world university (last 5 years)
- `volunteer` (integer): Volunteering: 0 none, 1 = 1-2 years, 2 = 2-3 years, 3 = 3+ years
- `warCountry` (boolean): National of a Korean War participant country

### `check_kr_withholding_statement` (~301 tokens)

check kr withholding statement

Korean payment statement (지급명세서) filing deadline and late-filing penalty (소득세법 제164조·제164조의3·제81조의11): annual statements (interest/dividend/pension/other by end of Feb; wage/retirement/business by Mar 10), daily-worker statements and simplified statements for business/personal-service income (end of the next month), simplified wage statements (semi-annual for 2026 payments, monthly from Jan 2027 with no penalty in 2027 — 2028 for semi-annual withholding payers — if filed by the end of the month after each half). Deadlines move to the next business day. Penalty 1% (0.5% within 3 months) for annual, 0.25% (0.125% within 1 month) for daily and simplified. Estimate only; no filing.

Input parameters:

- `amount` (number, required): Payment amount not filed or filed late (KRW)
- `kind` (required): Statement type
- `month` (integer): Payment month 1-12 (not used for annual statements)
- `semiAnnualPayer` (boolean): Approved to pay withholding tax semi-annually
- `submitted` (string): Date filed (omit if not yet filed)
- `today` (string): Reference date YYYY-MM-DD for days left (default: today)
- `year` (integer, required): Payment year

### `check_kr_serious_accident` (~349 tokens)

check kr serious accident

Korean workplace accident: is it a 'serious industrial accident' under the Serious Accidents Punishment Act (중대재해처벌법 제2조: 1+ death, 2+ injured needing 6+ months of treatment from the same accident, or 3+ occupational illness cases from the same hazard within a year) and/or a 'serious accident' under the Occupational Safety and Health Act (시행규칙 제3조: 1+ death, 2+ simultaneously injured needing 3+ months of care, or 10+ injured/ill at once). Applies the 5-worker exclusion and the 2024-01-27 phase-in for under-50 workplaces, and states penalty ranges (death: 1+ years prison or up to 1B KRW fine for the responsible executive, 5B KRW for the company) and reporting duties. Information only; no case handling.

Input parameters:

- `date` (string): Accident date (for the 2024-01-27 phase-in)
- `deaths` (integer): Deaths
- `headcount` (integer, required): Regular workers (상시근로자)
- `illness1y` (integer): Occupational illness cases from the same hazard within 1 year
- `injured3m` (integer): Injured needing 3+ months of care, at the same time
- `injured6m` (integer): Injured needing 6+ months of treatment, same accident
- `injuredTotal` (integer): Injured or ill workers at the same time (total)
- `lostDays3` (boolean): Anyone needs 3+ days off work

### `calculate_kr_accident_report_deadline` (~287 tokens)

calculate kr accident report deadline

Korean industrial accident reporting: the accident investigation report (산업재해조사표) is due within 1 month of an accident causing death or 3+ days off work (산업안전보건법 제57조③, 시행규칙 제73조; next business day if the last day is a holiday); serious accidents must be reported immediately by phone/fax (제54조②). Fines (시행령 별표 35, amended 2026-07-28): not reporting 7M/10M/15M KRW by offence count, false report 15M, serious accident not reported 30M. Concealment is a crime (1 year prison or 10M fine, 제170조), not a fine. Information only; no filing.

Input parameters:

- `date` (string, required): Accident date
- `deaths` (integer): Deaths
- `lostDays3` (boolean): Death or 3+ days off work
- `nth` (integer): Offence count in the last 5 years incl. this one (1-3)
- `reported` (string): Date the report was filed (omit if not yet)
- `serious` (boolean): Serious accident under the OSH Act
- `today` (string): Reference date YYYY-MM-DD for days left (default: today)

### `calculate_kr_safety_education_hours` (~236 tokens)

calculate kr safety education hours

Korean mandatory occupational safety and health training hours (산업안전보건법 시행규칙 별표 4, amended 2025-05-30): regular training 6 hours per half-year for office and sales workers, 12 hours for others; on hiring 8 hours (1 week-1 month contracts 4, daily or ≤1 week 1); on job change 2 hours (daily 1); supervisors 16 hours a year; construction day workers 4-hour basic training; half hours for wholesale/lodging/restaurant workplaces under 50 workers. Returns per-worker hours and the yearly total.

Input parameters:

- `construction` (boolean): Construction site
- `half` (boolean): Wholesale, lodging or restaurant business with under 50 workers (half hours)
- `hire` (required): Over 1 month, 1 week-1 month, up to 1 week fixed-term, or daily worker
- `job` (required): Office work, sales work, or other (production, field)
- `supervisors` (integer): Number of supervisors
- `workers` (integer): Number of workers

### `check_kr_safety_staffing` (~308 tokens)

check kr safety staffing

Korean safety and health staffing duty (산업안전보건법 시행령 별표 2·3·5, 제24조): safety and health manager-in-chief (50/100/300 workers by industry, construction 2B KRW+), safety officers (manufacturing/transport 50-499 → 1, 500+ → 2; retail/food & lodging 50-999 → 1; construction by contract amount from 5B KRW), health officers (by industry from 50 workers; construction 80B KRW, civil 100B, or 600 workers), safety-health staff for 20-49 worker manufacturing etc., full-time requirement at 300 workers (construction 12B/civil 15B), and the risk assessment cycle (시행규칙 제37조, 고시 제2026-73호). Representative industries only; check the annex for others.

Input parameters:

- `amount` (number): Construction contract amount (KRW)
- `civil` (boolean): Civil engineering works (토목공사업)
- `headcount` (integer): Regular workers
- `sector` (required): mfg-heavy = chemicals/metals/machinery/electronics/auto/rubber-plastics manufacturing, mfg-food = food & beverage manufacturing, transport = transport & warehousing, retail = wholesale & retail, food…

### `calculate_kr_student_loan_repayment` (~228 tokens)

calculate kr student loan repayment

Korean income-contingent student loan (취업 후 상환 학자금) mandatory repayment: (annual income amount − repayment threshold 20,560,000 KRW, 교육부고시 제2026-12호, ≈ gross salary 30,370,000) × 20% undergraduate or 25% graduate (특별법 제18조, 시행령 제10조), monthly payroll deduction (1/12, from the month after the June notice) or a bill after the May income tax filing. Salary input is converted with the earned income deduction. The threshold changes each semester. Estimate only.

Input parameters:

- `amount` (number, required): Gross salary or income amount for the year (KRW)
- `balance` (number): Remaining loan balance (caps the repayment)
- `employee` (boolean): Wage earner (payroll deduction) — default true for salary
- `incomeType` (required): salary = gross wages only, income = total income amount (소득금액)
- `loan` (required): Undergraduate loans only, or graduate loans included

### `compare_kr_bookkeeping_vs_estimate` (~421 tokens)

compare kr bookkeeping vs estimate

Korean sole proprietor: bookkeeping vs estimated (추계) income tax filing. Decides simple-ledger vs double-entry duty (prior-year revenue 300M/150M/75M by industry group, 소득세법 시행령 제208조), simple vs standard expense ratio eligibility (60M/36M/24M; personal services 36M, 제143조), standard-ratio income capped at simple-ratio income × 3.4 (2.8 for simple-ledger filers, through tax year 2027), no-bookkeeping penalty = calculated tax × business income share × 20% (제81조의5; exempt for new businesses and prior revenue under 48M), and the bookkeeping tax credit 20% capped at 1M for simple-ledger filers using double entry (제56조의2). Uses basic rates with personal deductions only. Estimate only; no filing.

Input parameters:

- `actualExpense` (number, required): Actual expenses from books
- `group` (required): a = agriculture/wholesale-retail/real estate sales, b = manufacturing/food & lodging/construction/IT/finance, c = rental/professional services/education/health/arts/personal services, personal = VAT-…
- `majorExpense` (number): Documented purchases, rent and payroll (for the standard ratio)
- `newBusiness` (boolean): Started this year
- `otherIncome` (number): Other comprehensive income amount (e.g. wage income amount)
- `people` (integer): Basic deduction persons including self
- `prevRevenue` (number, required): Prior-year revenue (KRW)
- `revenue` (number, required): This year's revenue (KRW)
- `simpleRate` (number, required): Simple expense ratio % for the industry code
- `simpleRateOver` (number): Simple expense ratio % for revenue above 40M (자가율); default = simpleRate
- `standardRate` (number, required): Standard expense ratio % for the industry code

### `check_kr_exempt_business_report` (~208 tokens)

check kr exempt business report

Korean VAT-exempt business status report (사업장현황신고, 소득세법 제78조): due Feb 10 of the next year (next business day if a holiday), deemed filed if VAT returns covered all revenue (mixed businesses report the exempt part), personal-service freelancers included; the 0.5% penalty on unreported revenue applies only to medical, veterinary and pharmacy businesses (제81조의3, 시행령 제147조의2). Does not say the May income tax return replaces it. Estimate only; no filing.

Input parameters:

- `kind` (required): Business type
- `mixed` (boolean): Both taxable and exempt business
- `today` (string): Reference date YYYY-MM-DD for days left (default: today)
- `unreported` (number): Unreported revenue (for the 0.5% penalty)
- `vatFiledAll` (boolean): All revenue already reported in VAT returns
- `year` (integer, required): Revenue year

### `compare_kr_private_pension_tax` (~250 tokens)

compare kr private pension tax

Korean private pension (연금저축·IRP) income tax: withholding rate by age (under 70 5%, under 80 4%, 80+ 3%, lifelong annuity 3%, lower applies; 소득세법 제129조), up to 15M KRW a year can end with withholding (separate taxation, 제14조③9호다목), above 15M choose comprehensive taxation or 15% separate taxation (제64조의4). Comprehensive side uses the pension income deduction table capped at 9M (제47조의2) with public pension and other income, basic rates and personal deductions only (tax credits left out). Estimate only.

Input parameters:

- `age` (integer, required): Age when received
- `lifelong` (boolean): Lifelong annuity contract that cannot be cancelled
- `otherIncome` (number): Other comprehensive income amount
- `people` (integer): Basic deduction persons including self
- `privatePension` (number, required): Private pension received this year, excluding retirement-income annuity and unavoidable withdrawals (KRW)
- `publicPension` (number): Taxable public pension (National Pension etc.)

### `get_jp_tax_calendar` (~276 tokens)

get jp tax calendar

Japanese sole proprietor tax deadlines for a year: income tax return and payment for the previous year (3/15, filing from 2/16, NTA No.2020), consumption tax for individuals (3/31, No.6601), prepaid income tax (予定納税) 7/31 and 11/30 when the base amount is 150,000 JPY or more (No.2040), and the blue return application (3/15, or within 2 months of opening a business on or after 1/16, No.2070). Weekend deadlines move to the next weekday (国税通則法 第10条②). Japan, as of 2026-11-21 (e-Gov current law and NTA Tax Answer). General information and estimates only; individual tax advice and return preparation are reserved to 税理士 (税理士法 第52条).

Input parameters:

- `consumptionTax` (boolean): Taxable for consumption tax
- `prepaid` (boolean): Has prepaid income tax (previous year tax 150,000 JPY+)
- `started` (string): Business opening date (only if opened that year)
- `today` (string): Reference date YYYY-MM-DD for days left
- `year` (integer, required): Calendar year to list

### `calculate_jp_blue_return_deduction` (~187 tokens)

calculate jp blue return deduction

Compare Japanese income tax (2026 basic deduction, 2.1% reconstruction surtax) and resident tax income levy (10%, basic deduction 430,000) under white return and blue return special deductions of 100,000 / 550,000 / 650,000 JPY (措法 第25条の2, NTA No.2072), with yearly savings and requirements. Japan, as of 2026-11-21 (e-Gov current law and NTA Tax Answer). General information and estimates only; individual tax advice and return preparation are reserved to 税理士 (税理士法 第52条).

Input parameters:

- `income` (number, required): Business income before the blue return deduction (JPY)
- `otherDeductions` (number): Income deductions other than the basic deduction, e.g. social insurance (JPY)

### `check_jp_consumption_tax` (~397 tokens)

check jp consumption tax

Japanese consumption tax: whether you are taxable (base period sales over 10M JPY, specified period sales and wages both over 10M, or invoice registration; NTA No.6501) and the tax under the general method, simplified method (deemed purchase rates 90-40% by business type 1-6, base sales up to 50M, election required; No.6505), the 20% special rule (taxable periods including 2026-09-30) and the 30% rule for individuals in 2027-2028 (No.6498). Standard 10% rate only. Japan, as of 2026-11-21 (e-Gov current law and NTA Tax Answer). General information and estimates only; individual tax advice and return preparation are reserved to 税理士 (税理士法 第52条).

Input parameters:

- `baseSales` (number, required): Taxable sales in the base period (2 years before, excl. tax, JPY)
- `invoice` (boolean): Registered as a qualified invoice issuer
- `purchases` (number): This year's taxable purchases at 10% (excl. tax, JPY)
- `sales` (number, required): This year's taxable sales at 10% (excl. tax, JPY)
- `simpleFiled` (boolean): Filed the simplified method election
- `specSales` (number): Taxable sales in the specified period (Jan-Jun of the previous year)
- `specWages` (number): Wages paid in the specified period
- `type` (integer): Simplified method business type 1-6 (1 wholesale 90% … 5 services 50%, 6 real estate 40%)
- `wasExempt` (boolean): Would be exempt without the invoice registration
- `year` (integer, required): Taxable period (calendar year for individuals)

### `calculate_jp_penalty_tax` (~347 tokens)

calculate jp penalty tax

Japanese additional taxes and delinquency tax: failure-to-file (5% voluntary; after notice 10/15/25%, after audit 15/20/30% on parts over 500,000 and 3,000,000 JPY; NTA No.2024), underpayment (none if voluntary; 5/10% after notice, 10/15% after audit above the larger of original tax and 500,000; No.2026), heavy additional tax 35%/40% (国税通則法 第68条), and 2026 delinquency tax 2.8% up to 2 months then 9.1% (No.9205). Tax base rounded down to 10,000 JPY, additional tax under 5,000 and delinquency under 1,000 are zero. Japan, as of 2026-11-21 (e-Gov current law and NTA Tax Answer). General information and estimates only; individual tax advice and return preparation are reserved to 税理士 (税理士法 第52条).

Input parameters:

- `deadline` (string): Statutory payment deadline
- `fraud` (boolean): Concealment or disguise found (heavy additional tax)
- `kind` (required): none = late return (無申告), under = amended return (過少申告)
- `original` (number): Originally filed tax (amended returns)
- `paid` (string): Payment date
- `stage` (required): voluntary = before audit notice, notice = after notice before audit, audit = after audit
- `tax` (number, required): Additional tax payable (JPY)

### `calculate_jp_appeal_deadlines` (~184 tokens)

calculate jp appeal deadlines

Japanese tax appeal deadlines (国税通則法 第77条): request for reinvestigation or for review within 3 months from the day after learning of the disposition, review within 1 month after a reinvestigation decision, and no appeal after 1 year from the disposition without justifiable reason. Weekend ends move to the next weekday. Japan, as of 2026-11-21 (e-Gov current law and NTA Tax Answer). General information and estimates only; individual tax advice and return preparation are reserved to 税理士 (税理士法 第52条).

Input parameters:

- `disposed` (string): Date of the disposition, if different
- `noticed` (string, required): Date you learned of the disposition (notice received)
- `reinvestigationDecided` (string): Date the reinvestigation decision was received

### `calculate_jp_depreciation` (~281 tokens)

calculate jp depreciation

Japanese depreciation for sole proprietors: under 100,000 JPY expensed, under 200,000 lump-sum 3 years, SME blue filers under 400,000 (acquired from 2026-04-01; 300,000 before) expensed up to 3M a year until 2029-03-31 (措法 第28条の2, NTA No.2100), else straight-line with the 別表第八 rate (ceil(1/life, 3 decimals)), first year by months used, down to 1 JPY. Japan, as of 2026-11-21 (e-Gov current law and NTA Tax Answer). General information and estimates only; individual tax advice and return preparation are reserved to 税理士 (税理士法 第52条).

Input parameters:

- `acquired` (string, required): Date first used in the business
- `blue` (boolean): Blue return filer
- `cost` (number, required): Acquisition cost (JPY)
- `life` (integer, required): Statutory useful life in years (PC 4, car 6, kei car 4, wooden building 22)
- `sme` (boolean): Small business (blue filer with up to 500 employees)
- `years` (integer): Max schedule years

### `get_us_tax_calendar` (~269 tokens)

get us tax calendar

US federal tax deadlines for a tax year: Form 1040 (April 15 of the next year), Form 4868 extension (October 15), 1040-ES estimated tax (April 15, June 15, September 15, January 15), Form 1099-NEC (January 31), Forms 1065/1120-S (March 15) and 1120 (April 15), moved to the next business day for weekends, New Year's Day, MLK Day and DC Emancipation Day (IRS Pub 509). United States federal, tax year 2026, as of 2026-11-21 (IRS publications, Rev. Proc. 2025-32, eCFR). General information and estimates only; no individual advice, return preparation or IRS representation (31 CFR Part 10).

Input parameters:

- `entity`: Business entity return
- `extension` (boolean): Will file Form 4868
- `pays1099` (boolean): Paid contractors (Form 1099-NEC)
- `selfEmployed` (boolean): Has self-employment income (estimated tax)
- `taxYear` (integer, required): Tax year
- `today` (string): Reference date YYYY-MM-DD for days left

### `calculate_us_self_employment_tax` (~231 tokens)

calculate us self employment tax

US 2026 self-employment tax (15.3% on 92.35% of net earnings, Social Security part capped at the $184,500 wage base after W-2 wages), Additional Medicare 0.9% above $200,000/$250,000, half-SE deduction, QBI deduction 20% with the $400 minimum (only below the $201,750/$403,500 threshold), and 2026 federal income tax with the standard deduction ($16,100/$32,200). United States federal, tax year 2026, as of 2026-11-21 (IRS publications, Rev. Proc. 2025-32, eCFR). General information and estimates only; no individual advice, return preparation or IRS representation (31 CFR Part 10).

Input parameters:

- `filing`: single or married filing jointly
- `net` (number, required): Net self-employment profit (Schedule C, USD)
- `otherIncome` (number): Other taxable income (USD)
- `wages` (number): W-2 wages (USD)

### `calculate_us_estimated_tax` (~247 tokens)

calculate us estimated tax

US estimated tax safe harbor (2026 Form 1040-ES): required when tax after withholding is $1,000+; pay the smaller of 90% of this year's tax and 100% of last year's (110% if last year's AGI was over $150,000, $75,000 married filing separately), split over the four due dates. United States federal, tax year 2026, as of 2026-11-21 (IRS publications, Rev. Proc. 2025-32, eCFR). General information and estimates only; no individual advice, return preparation or IRS representation (31 CFR Part 10).

Input parameters:

- `currentTax` (number, required): Expected total tax this year (USD)
- `mfs` (boolean): Married filing separately
- `priorAgi` (number, required): Last year's AGI (USD)
- `priorFullYear` (boolean): Last year's return covered 12 months (default true)
- `priorTax` (number, required): Last year's total tax (USD)
- `taxYear` (integer): Tax year (default 2026)
- `withholding` (number): Expected withholding this year (USD)

### `calculate_us_irs_penalty` (~251 tokens)

calculate us irs penalty

US failure-to-file (5% per month or part, max 25%, reduced by failure-to-pay in the same month; minimum $535 or 100% of tax for returns filed in 2027 over 60 days late) and failure-to-pay (0.5% per month, 0.25% on an approved plan, max 25%) penalties, plus interest compounded daily at the underpayment rate (2026 quarters 7/6/7/7%; later quarters reuse 7% until published). United States federal, tax year 2026, as of 2026-11-21 (IRS publications, Rev. Proc. 2025-32, eCFR). General information and estimates only; no individual advice, return preparation or IRS representation (31 CFR Part 10).

Input parameters:

- `due` (string, required): Original due date
- `extension` (boolean): Valid extension filed (filing due October 15)
- `filed` (string): Date filed
- `installment` (boolean): On an approved installment agreement
- `paid` (string): Date paid
- `tax` (number, required): Tax unpaid on the original due date (USD)

### `calculate_us_tax_appeal_deadlines` (~224 tokens)

calculate us tax appeal deadlines

US tax dispute deadlines: Tax Court petition 90 days after a notice of deficiency (150 if addressed outside the US, Pub 556), Collection Due Process hearing request 30 days (Form 12153), and refund claims within 3 years of filing or 2 years of payment, whichever is later (Topic 308). United States federal, tax year 2026, as of 2026-11-21 (IRS publications, Rev. Proc. 2025-32, eCFR). General information and estimates only; no individual advice, return preparation or IRS representation (31 CFR Part 10).

Input parameters:

- `abroad` (boolean): Notice addressed outside the United States
- `filed` (string): Date the return was filed (refund claims)
- `kind`: Notice of deficiency or collection due process notice
- `notice` (string): Date on the IRS notice
- `paid` (string): Date the tax was paid
- `returnDue` (string): Original return due date (early returns count as filed on it)

### `calculate_us_depreciation` (~342 tokens)

calculate us depreciation

US business asset write-off for 2026: de minimis safe harbor $2,500 per item ($5,000 with an applicable financial statement, 26 CFR 1.263(a)-1(f)), Section 179 up to $2,560,000 reduced above $4,090,000 (Rev. Proc. 2025-32), 100% bonus for property acquired after 2025-01-19 (Pub 946), and MACRS 5- or 7-year half-year schedules (Table A-1). Passenger car caps for 2026 are not published and not applied. United States federal, tax year 2026, as of 2026-11-21 (IRS publications, Rev. Proc. 2025-32, eCFR). General information and estimates only; no individual advice, return preparation or IRS representation (31 CFR Part 10).

Input parameters:

- `acquired` (string): Date acquired, if different
- `afs` (boolean): Has an applicable (audited) financial statement
- `bonus` (boolean): Take bonus depreciation (default true)
- `businessIncome` (number): Business taxable income limit for Section 179 (USD)
- `cost` (number, required): Business-use cost (USD)
- `life` (integer, required): MACRS class: 5 (computers, vehicles) or 7 (furniture, equipment)
- `placed` (string, required): Date placed in service
- `sec179` (number): Section 179 amount to elect (USD)
- `totalPlaced` (number): Total Section 179 property placed in service this year (USD)

### `get_fr_tax_calendar` (~210 tokens)

get fr tax calendar

French business tax dates for a year: income tax return (opens in April; per-département deadlines published each spring), corporate tax instalments 15 March/June/September/December for calendar-year companies (BOI-IS-DECLA-20-10), CFE by 15 December (F23547), and VAT (réel simplifié: annual CA12 in May, 55% July and 40% December instalments; réel normal monthly, F23566). Weekend dates move to the next business day. France, as of 2026-11-21 (service-public.fr and BOFiP). General information and estimates only; no personalised advice, bookkeeping or filing.

Input parameters:

- `cfe` (boolean): Liable for CFE
- `is` (boolean): Company subject to corporate tax (calendar year)
- `today` (string): Reference date YYYY-MM-DD for days left
- `tva`: VAT regime
- `year` (integer, required): Year

### `calculate_fr_micro_entrepreneur` (~343 tokens)

calculate fr micro entrepreneur

French micro-entrepreneur 2026: turnover ceilings 203,100 EUR (sales, lodging) / 83,600 EUR (services, BNC) with exit after two consecutive years above (F32353); social contributions 12.3% / 21.2% / 25.6% / CIPAV 23.2% of turnover (F36232); taxable income after the 71% / 50% / 34% allowance and the progressive scale (2025 income scale, 2026 not yet voted, no family quotient cap) versus the versement libératoire 1% / 1.7% / 2.2% (allowed if N-2 reference income < 29,579 EUR per part, F23267). France, as of 2026-11-21 (service-public.fr and BOFiP). General information and estimates only; no personalised advice, bookkeeping or filing.

Input parameters:

- `activity` (required): vente = sales/lodging, services = BIC services, bnc = unregulated liberal profession, cipav = regulated (CIPAV)
- `ca` (number, required): Annual turnover collected (EUR)
- `caPrev` (number): Turnover last year (EUR)
- `caPrev2` (number): Turnover two years ago (EUR)
- `otherIncome` (number): Other taxable household income (EUR)
- `parts` (number): Household tax parts (quotient familial)
- `rfr` (number): Household reference tax income N-2 (EUR)
- `vl` (boolean): Opted for the versement libératoire

### `check_fr_vat_franchise` (~183 tokens)

check fr vat franchise

French VAT franchise en base 2026 (F21746): exempt while last year's turnover is at most 85,000 EUR (sales, lodging) or 37,500 EUR (services); VAT due immediately above 93,500 / 41,250 EUR this year, or from next 1 January between the two. The single 25,000 EUR threshold plan was abandoned. Rates 20/10/5.5/2.1%. France, as of 2026-11-21 (service-public.fr and BOFiP). General information and estimates only; no personalised advice, bookkeeping or filing.

Input parameters:

- `activity` (required): Sales/lodging or services
- `ca` (number, required): Turnover excl. VAT this year (EUR)
- `caPrev` (number, required): Turnover excl. VAT last year (EUR)

### `calculate_fr_tax_penalty` (~195 tokens)

calculate fr tax penalty

French late interest 0.20% per month (CGI 1727) and surcharges: late filing 10%, 40% if not filed within 30 days of a formal notice, 80% for hidden activity (CGI 1728); deliberate failure 40%, fraudulent manoeuvres 80% (CGI 1729). Income tax late filing (CGI 1758 A) is flagged, not computed. France, as of 2026-11-21 (service-public.fr and BOFiP). General information and estimates only; no personalised advice, bookkeeping or filing.

Input parameters:

- `due` (string): Payment deadline
- `fault` (required): Situation
- `incomeTax` (boolean): Personal income tax
- `months` (integer): Months late (overrides the dates)
- `paid` (string): Payment date
- `tax` (number, required): Tax due (EUR)

### `calculate_fr_claim_deadline` (~147 tokens)

calculate fr claim deadline

French tax claim (réclamation contentieuse) deadline: 31 December of the second year after the assessment, payment or event; local direct taxes (taxe foncière, CFE) 31 December of the following year (LPF R*196-1, BOI-CTX-PREA-10-30). The administration answers in principle within 6 months. France, as of 2026-11-21 (service-public.fr and BOFiP). General information and estimates only; no personalised advice, bookkeeping or filing.

Input parameters:

- `eventYear` (integer, required): Year of the assessment, payment or event
- `local` (boolean): Local direct tax

### `calculate_fr_depreciation` (~206 tokens)

calculate fr depreciation

French depreciation schedule: straight-line with day-based pro rata from first use, or declining balance (coefficient 1.25 for 3-4 years, 1.75 for 5-6, 2.25 above 6, CGI 39 A) from the first day of the acquisition month with a switch to straight-line; small tools and office equipment up to 500 EUR excl. VAT expensed immediately (BOI-BIC-CHG-20-30-10). France, as of 2026-11-21 (service-public.fr and BOFiP). General information and estimates only; no personalised advice, bookkeeping or filing.

Input parameters:

- `cost` (number, required): Cost excl. VAT (EUR)
- `life` (integer, required): Useful life in years
- `method`: Straight-line or declining balance
- `start` (string, required): Acquisition or first-use date
- `toolUnder500` (boolean): Small tool or office equipment

### `get_es_tax_calendar` (~338 tokens)

get es tax calendar

Spanish tax dates from the AEAT 2026 taxpayer calendar: quarterly VAT (303), IRPF instalments (130/131) and withholdings (111/115) on 20 April, 20 July and 20 October 2026 (Q4 2025 and annual 390 on 30 January; 111/115 on 20 January), Renta 2025 online 8 April-30 June 2026 (25 June with direct debit), corporate tax 200 by 27 July 2026 (LIS art. 124) and 202 instalments 20 April, 20 October, 21 December 2026 (LIS art. 40). Other years return months only. Spain, as of 2026-11-21 (BOE consolidated texts, AEAT and Seguridad Social). General information and estimates only; no personalised advice, representation or filing. Unverified 2026 values (reduced autónomo quota, 7% hard-to-justify expenses, 2026 late-payment interest rate, regional scales, 2027 calendar) are flagged, not assumed.

Input parameters:

- `iva` (boolean): Files quarterly VAT (303)
- `pago`: IRPF instalment model
- `renta` (boolean): Include the Renta campaign (default true)
- `retenciones` (boolean): Files withholdings 111/115
- `sociedad` (boolean): Company under corporate tax, calendar-year
- `today` (string): Reference date YYYY-MM-DD for days left
- `year` (integer, required): Year (exact dates only for 2026)

### `calculate_es_autonomo_quota` (~304 tokens)

calculate es autonomo quota

Spanish self-employed (autónomo) 2026: contribution bracket by monthly net income (15 brackets, min/max base, Orden PJC/297/2026 art. 18), quota at 31.50% (own calculation, not an official table); optional IRPF estimate for simplified direct estimation with 5% hard-to-justify expenses capped at 2,000 EUR (RIRPF 30.2), state scale + Madrid 2025 regional scale as an example, personal allowance 5,550 EUR, and 15% / 7% (new activity) withholding (RIRPF 95.1). Spain, as of 2026-11-21 (BOE consolidated texts, AEAT and Seguridad Social). General information and estimates only; no personalised advice, representation or filing. Unverified 2026 values (reduced autónomo quota, 7% hard-to-justify expenses, 2026 late-payment interest rate, regional scales, 2027 calendar) are flagged, not assumed.

Input parameters:

- `gastos` (number): Annual deductible expenses incl. own quota (EUR)
- `ingresos` (number): Annual income excl. VAT (EUR)
- `netMonthly` (number, required): Expected monthly net income for Social Security (EUR)
- `nuevo` (boolean): New activity (first registration or none in 2 years)
- `retenido` (number): IRPF already withheld (EUR)

### `calculate_es_vat` (~220 tokens)

calculate es vat

Spanish VAT on an invoice: 21% / 10% / 4% (LIVA art. 90, 91) and equivalence surcharge 5.2% / 1.4% / 0.5% (tobacco 1.75%, LIVA art. 161). Notes that Spain has no domestic small-business VAT franchise (LIVA art. 120, as of 2026-11-21). Spain, as of 2026-11-21 (BOE consolidated texts, AEAT and Seguridad Social). General information and estimates only; no personalised advice, representation or filing. Unverified 2026 values (reduced autónomo quota, 7% hard-to-justify expenses, 2026 late-payment interest rate, regional scales, 2027 calendar) are flagged, not assumed.

Input parameters:

- `base` (number, required): Taxable base (EUR)
- `recargo` (boolean): Customer is a retailer under the equivalence surcharge
- `tipo` (required): VAT rate %

### `calculate_es_late_filing_surcharge` (~234 tokens)

calculate es late filing surcharge

Spanish surcharge for filing late without a prior request (LGT art. 27): 1% plus 1% per full month late; after 12 months 15% plus late-payment interest (rate supplied by the caller, the 2026 rate is not verified); 25% reduction if paid on time. Spain, as of 2026-11-21 (BOE consolidated texts, AEAT and Seguridad Social). General information and estimates only; no personalised advice, representation or filing. Unverified 2026 values (reduced autónomo quota, 7% hard-to-justify expenses, 2026 late-payment interest rate, regional scales, 2027 calendar) are flagged, not assumed.

Input parameters:

- `cuota` (number, required): Tax due (EUR)
- `due` (string, required): End of the filing period
- `filed` (string, required): Filing date
- `interesAnual` (number): Late-payment interest rate % per year (only after 12 months)
- `pagoEnPlazo` (boolean): Will pay the surcharge on time (25% reduction)

### `calculate_es_tax_sanction` (~209 tokens)

calculate es tax sanction

Spanish tax penalty for unpaid tax (LGT art. 191): minor 50%, serious 50-100%, very serious 100-150% of the base, with reductions of 65% (agreement) or 30% (conformity) and a further 40% for paying without appeal (LGT art. 188). Spain, as of 2026-11-21 (BOE consolidated texts, AEAT and Seguridad Social). General information and estimates only; no personalised advice, representation or filing. Unverified 2026 values (reduced autónomo quota, 7% hard-to-justify expenses, 2026 late-payment interest rate, regional scales, 2027 calendar) are flagged, not assumed.

Input parameters:

- `acuerdo`: Reduction for agreement or conformity
- `base` (number, required): Penalty base: unpaid tax (EUR)
- `gravedad` (required): Classification
- `pronto` (boolean): Pays in the voluntary period without appealing

### `calculate_es_appeal_deadlines` (~214 tokens)

calculate es appeal deadlines

Spanish tax appeal dates from a notification: reposición 1 month (LGT 223.1), economic-administrative claim 1 month (LGT 235.1), contentious-administrative appeal 2 months (LJCA 46.1); and the 4-year limitation from the end of the voluntary filing period (LGT 66, 67). Months counted date to date, weekends moved to Monday, holidays not included. Spain, as of 2026-11-21 (BOE consolidated texts, AEAT and Seguridad Social). General information and estimates only; no personalised advice, representation or filing. Unverified 2026 values (reduced autónomo quota, 7% hard-to-justify expenses, 2026 late-payment interest rate, regional scales, 2027 calendar) are flagged, not assumed.

Input parameters:

- `finPlazoVoluntario` (string): End of the voluntary filing period
- `notificacion` (string): Notification date

### `calculate_es_depreciation` (~285 tokens)

calculate es depreciation

Spanish depreciation with the official table (LIS art. 12.1.a): maximum straight-line rate and maximum years per asset (IT equipment 25%/8, software 33%/6, transport 16%/14, furniture 10%/20, industrial buildings 3%/68...), any rate between 1/max-years and the maximum, first year pro rata by days; new items up to 300 EUR each freely depreciated up to 25,000 EUR per period (LIS 12.3.e). Spain, as of 2026-11-21 (BOE consolidated texts, AEAT and Seguridad Social). General information and estimates only; no personalised advice, representation or filing. Unverified 2026 values (reduced autónomo quota, 7% hard-to-justify expenses, 2026 late-payment interest rate, regional scales, 2027 calendar) are flagged, not assumed.

Input parameters:

- `coef` (number): Chosen rate as a fraction (default: maximum)
- `coste` (number, required): Cost excl. VAT (EUR)
- `elemento` (required): Asset type
- `inicio` (string, required): Date put into use
- `nuevo` (boolean): New asset
- `usadoLibertad` (number): Amount already freely depreciated this period under the 300 EUR rule (EUR)

### `get_cn_tax_calendar` (~249 tokens)

get cn tax calendar

Chinese monthly/quarterly filing deadlines for 2026 from 税总办征科函〔2025〕64号 (15th, extended to 1/20, 2/24, 3/16, 4/20, 5/22, 8/17, 10/26, 11/16), for VAT and individual income tax on business income (预缴), plus annual reconciliation: comprehensive income 3/1-6/30 and business income by 3/31 (IIT Law art. 11, 12). Other years return months only. Mainland China, as of 2026-11-21 (laws and State Taxation Administration announcements in the official regulations database). General information and estimates only; no individual tax consulting, agency or filing. The 2027 filing calendar is not yet published.

Input parameters:

- `business`: Business income prepayment period
- `comprehensive` (boolean): Include comprehensive income reconciliation (default true)
- `today` (string): Reference date YYYY-MM-DD for days left
- `vat`: VAT filing period
- `year` (integer, required): Year (exact dates only for 2026)

### `calculate_cn_business_income_tax` (~176 tokens)

calculate cn business income tax

Chinese individual income tax on business income (经营所得) at 5-35% progressive rates (IIT Law table 2), computed bracket by bracket, with the individual industrial and commercial household (个体工商户) 50% relief on the part up to 2 million CNY until 2027-12-31 (MOF/STA 2023 No. 12), estimated pro rata. Mainland China, as of 2026-11-21 (laws and State Taxation Administration announcements in the official regulations database). General information and estimates only; no individual tax consulting, agency or filing. The 2027 filing calendar is not yet published.

Input parameters:

- `individual` (boolean): Individual industrial and commercial household (default true)
- `taxable` (number, required): Annual taxable business income (CNY)

### `calculate_cn_comprehensive_income_tax` (~170 tokens)

calculate cn comprehensive income tax

Chinese individual income tax on comprehensive income (wages etc.): annual income minus the 60,000 CNY basic deduction, special and additional special deductions, taxed at 3-45% (IIT Law art. 3, 6). Mainland China, as of 2026-11-21 (laws and State Taxation Administration announcements in the official regulations database). General information and estimates only; no individual tax consulting, agency or filing. The 2027 filing calendar is not yet published.

Input parameters:

- `additional` (number): Additional special deductions (CNY)
- `income` (number, required): Annual income (CNY)
- `other` (number): Other legal deductions (CNY)
- `special` (number): Special deductions: social insurance and housing fund (CNY)

### `calculate_cn_small_profit_cit` (~188 tokens)

calculate cn small profit cit

Chinese small low-profit enterprise corporate income tax: 25% of taxable income at 20% (5% effective) until 2027-12-31 when taxable income <= 3 million CNY, employees <= 300, assets <= 50 million CNY and the industry is not restricted (MOF/STA 2023 No. 12); otherwise 25%. Mainland China, as of 2026-11-21 (laws and State Taxation Administration announcements in the official regulations database). General information and estimates only; no individual tax consulting, agency or filing. The 2027 filing calendar is not yet published.

Input parameters:

- `assets` (number, required): Total assets, quarterly average (CNY)
- `employees` (number, required): Employees
- `restricted` (boolean): Restricted or prohibited industry
- `taxable` (number, required): Annual taxable income (CNY)

### `check_cn_small_scale_vat` (~245 tokens)

check cn small scale vat

Chinese small-scale VAT taxpayer 2026: threshold (起征点) 100,000 CNY per month or 300,000 CNY per quarter until 2027-12-31 - below it VAT is exempt, at or above it the whole amount is taxed (VAT Law art. 23, MOF/STA 2026 No. 10); 3% levy rate reduced to 1% except selling or leasing real estate and land use rights; above 5 million CNY a year the taxpayer is no longer small-scale (VAT Law art. 9). Mainland China, as of 2026-11-21 (laws and State Taxation Administration announcements in the official regulations database). General information and estimates only; no individual tax consulting, agency or filing. The 2027 filing calendar is not yet published.

Input parameters:

- `annualSales` (number): Sales over the last 12 months (CNY)
- `period` (required): Filing period
- `realEstate` (boolean): Sale or lease of real estate or transfer of land use rights
- `sales` (number, required): Sales this period excl. VAT (CNY)

### `calculate_cn_late_payment_surcharge` (~204 tokens)

calculate cn late payment surcharge

Chinese late payment surcharge (滞纳金) of 0.05% per day from the day after the deadline (Tax Collection Law art. 32), with fine ranges: late filing up to 2,000 or 2,000-10,000 CNY (art. 62), tax evasion or unpaid tax 50%-5x (art. 63, 64), and the first-violation no-penalty lists (STA 2021 No. 6 and No. 33). Mainland China, as of 2026-11-21 (laws and State Taxation Administration announcements in the official regulations database). General information and estimates only; no individual tax consulting, agency or filing. The 2027 filing calendar is not yet published.

Input parameters:

- `due` (string, required): Payment deadline
- `paid` (string, required): Payment date
- `tax` (number, required): Unpaid tax (CNY)

### `calculate_cn_tax_appeal_deadlines` (~220 tokens)

calculate cn tax appeal deadlines

Chinese tax dispute dates: administrative reconsideration within 60 days of knowing the act (tax payment disputes require paying or guaranteeing first, Tax Collection Law art. 88), lawsuit within 15 days of the reconsideration decision, direct lawsuit against penalties within 6 months, overpaid tax refund claim within 3 years of payment (art. 51); recovery periods 3/5 years or unlimited (art. 52). Weekends shift to Monday; public holidays are not included. Mainland China, as of 2026-11-21 (laws and State Taxation Administration announcements in the official regulations database). General information and estimates only; no individual tax consulting, agency or filing. The 2027 filing calendar is not yet published.

Input parameters:

- `decision` (string): Date the reconsideration decision was received
- `kind`: Tax payment dispute or penalty/enforcement
- `known` (string): Date you learned of the tax authority's act
- `paid` (string): Date the overpaid tax was paid

### `calculate_cn_depreciation` (~289 tokens)

calculate cn depreciation

Chinese corporate income tax depreciation: minimum useful lives (buildings 20, machinery 10, tools and furniture 5, other vehicles 4, electronics 3 years; Implementation Regulations art. 60), straight-line from the month after first use with a reasonable residual value (art. 59); one-off deduction for new equipment up to 5 million CNY bought 2024-2027 (MOF/STA 2023 No. 37); accelerated depreciation with lives >= 60% of the minimum, double-declining or sum-of-years (art. 98). Mainland China, as of 2026-11-21 (laws and State Taxation Administration announcements in the official regulations database). General information and estimates only; no individual tax consulting, agency or filing. The 2027 filing calendar is not yet published.

Input parameters:

- `accelerated` (boolean): Asset qualifies for accelerated depreciation
- `category` (required): Asset category
- `cost` (number, required): Tax basis (CNY)
- `method`: Method (accelerated assets only for double/sum)
- `oneOff` (boolean): Use the one-off deduction (new equipment, 2024-2027)
- `residualRate` (number): Residual value rate as a fraction
- `start` (string, required): Date put into use
- `years` (integer): Useful life in years

### `get_uk_tax_calendar` (~298 tokens)

get uk tax calendar

UK deadlines for a tax year (taxYear 2025 = 2025-26): tell HMRC by 5 October if new to Self Assessment, paper return 31 October, online return and balancing payment plus first payment on account 31 January, second payment on account 31 July; Making Tax Digital quarterly updates 1 (7 August) and 2 (7 November), with 3 and 4 not confirmed; Corporation Tax payment 9 months and 1 day after the accounting period and Company Tax Return 12 months after; VAT return and payment 1 calendar month and 7 days after the period. United Kingdom, as of 2026-11-21 (gov.uk and legislation.gov.uk). Income Tax bands are for England, Wales and Northern Ireland; Scottish bands are not calculated. General information and estimates only; not personal tax advice, no agent services and no filing with HMRC.

Input parameters:

- `companyYearEnd` (string): Company accounting period end date
- `mtd` (boolean): Signed up to Making Tax Digital for Income Tax
- `newToSA` (boolean): First Self Assessment return (or no return last year)
- `taxYear` (integer, required): First calendar year of the tax year (2025 = 2025-26)
- `today` (string): Reference date YYYY-MM-DD for days left
- `vatPeriodEnd` (string): VAT period end date

### `calculate_uk_self_employed_tax` (~352 tokens)

calculate uk self employed tax

UK 2026-27 sole trader estimate: Income Tax with the £12,570 personal allowance (tapered £1 per £2 over £100,000), 20% to £50,270, 40% to £125,140, 45% above; Class 4 NI 6% between £12,570 and £50,270 and 2% above; Class 2 treated as paid at profits of £7,105 or more, otherwise voluntary £3.65 a week; and the Making Tax Digital start date (qualifying income over £50,000 in 2024-25 → 6 April 2026, over £30,000 in 2025-26 → 2027, over £20,000 in 2026-27 → 2028). Tax shown is the extra Income Tax caused by the profit on top of other income. United Kingdom, as of 2026-11-21 (gov.uk and legislation.gov.uk). Income Tax bands are for England, Wales and Northern Ireland; Scottish bands are not calculated. General information and estimates only; not personal tax advice, no agent services and no filing with HMRC.

Input parameters:

- `otherIncome` (number): Other income such as salary or pension (GBP)
- `profit` (number, required): Taxable self-employed profit (GBP)
- `qi2425` (number): Qualifying income 2024-25: self-employment and property turnover (GBP)
- `qi2526` (number): Qualifying income 2025-26 (GBP)
- `qi2627` (number): Qualifying income 2026-27 (GBP)

### `check_uk_vat_registration` (~232 tokens)

check uk vat registration

UK VAT: must register when taxable turnover in the last 12 rolling months goes over £90,000, or is expected to go over £90,000 in the next 30 days alone; can deregister under £88,000; Flat Rate Scheme can be joined with expected turnover up to £150,000 excluding VAT and must be left over £230,000 including VAT; rates 20%, 5%, 0%. United Kingdom, as of 2026-11-21 (gov.uk and legislation.gov.uk). Income Tax bands are for England, Wales and Northern Ireland; Scottish bands are not calculated. General information and estimates only; not personal tax advice, no agent services and no filing with HMRC.

Input parameters:

- `last12` (number, required): Taxable turnover in the last 12 months (GBP)
- `next12` (number): Taxable turnover expected in the next 12 months, excluding VAT (GBP)
- `next30` (number): Taxable turnover expected in the next 30 days alone (GBP)
- `registered` (boolean): Already VAT registered

### `calculate_uk_sa_penalty` (~234 tokens)

calculate uk sa penalty

UK Self Assessment penalties for a tax year (online deadline 31 January after the year ends): late filing £100, then £10 a day after 3 months for up to 90 days, then the greater of 5% of the tax or £300 at 6 and again at 12 months; late payment 5% of unpaid tax at 30 days, 6 months and 12 months; plus late payment interest. MTD for Income Tax penalties are different and not calculated. United Kingdom, as of 2026-11-21 (gov.uk and legislation.gov.uk). Income Tax bands are for England, Wales and Northern Ireland; Scottish bands are not calculated. General information and estimates only; not personal tax advice, no agent services and no filing with HMRC.

Input parameters:

- `filed` (string): Date the return was filed
- `paid` (string): Date the tax was paid
- `tax` (number, required): Tax due on the return (GBP)
- `taxYear` (integer, required): First calendar year of the tax year (2024 = 2024-25)

### `calculate_uk_late_payment_interest` (~172 tokens)

calculate uk late payment interest

HMRC late payment interest at base rate + 4%, simple daily: 7.75% from 9 January 2026 and 8.00% from 24 November 2026. Days before 9 January 2026 are returned as unknownDays and not charged because that rate has not been checked. United Kingdom, as of 2026-11-21 (gov.uk and legislation.gov.uk). Income Tax bands are for England, Wales and Northern Ireland; Scottish bands are not calculated. General information and estimates only; not personal tax advice, no agent services and no filing with HMRC.

Input parameters:

- `amount` (number, required): Unpaid tax (GBP)
- `from` (string, required): Date interest starts (the payment deadline)
- `to` (string, required): Date paid

### `calculate_uk_tax_appeal_deadlines` (~178 tokens)

calculate uk tax appeal deadlines

UK dates for disagreeing with HMRC: appeal or ask for a review usually within 30 days of the decision letter (then 30 days after a review to accept or go to the tribunal), and overpayment relief claims within 4 years after the end of the tax year (TMA 1970 Sch 1AB para 3). United Kingdom, as of 2026-11-21 (gov.uk and legislation.gov.uk). Income Tax bands are for England, Wales and Northern Ireland; Scottish bands are not calculated. General information and estimates only; not personal tax advice, no agent services and no filing with HMRC.

Input parameters:

- `decision` (string): Date of HMRC's decision letter
- `taxYear` (integer): First calendar year of the tax year for an overpayment claim

### `calculate_uk_capital_allowances` (~292 tokens)

calculate uk capital allowances

UK capital allowances on plant and machinery: Annual Investment Allowance up to £1m a year; for companies from 1 April 2023 full expensing (100%, main rate) or 50% first year allowance (special rate); 40% first year allowance on main-rate assets from 1 January 2026 (leased assets allowed); writing down allowances 14% main pool (from April 2026, 18% before) and 6% special rate pool, with a reducing-balance schedule. Cars get only writing down allowances; cash-basis sole traders deduct equipment as an expense. United Kingdom, as of 2026-11-21 (gov.uk and legislation.gov.uk). Income Tax bands are for England, Wales and Northern Ireland; Scottish bands are not calculated. General information and estimates only; not personal tax advice, no agent services and no filing with HMRC.

Input parameters:

- `aiaUsed` (number): AIA already used in the period (GBP)
- `car` (boolean): The asset is a car
- `cashBasis` (boolean): Sole trader using the cash basis
- `company` (boolean): Limited company
- `cost` (number, required): Cost (GBP)
- `date` (string, required): Date of expenditure
- `pool` (required): Main rate or special rate pool
- `years` (integer): Years in the writing down schedule

### `get_tw_tax_calendar` (~255 tokens)

get tw tax calendar

Taiwan deadlines: annual individual and business income tax return 5/1-5/31 (Income Tax Act art. 71; 2026 extended to 6/1), business tax every two months by the 15th of odd months or monthly for zero-rate applicants (Business Tax Act art. 35; 2026 3/16 and 11/16 computed from weekend shifts, not from a published notice), business income tax prepayment 9/1-9/30 (art. 67); Saturday moves to Monday and Sunday to the next day (Administrative Procedure Act art. 48). Taiwan, as of 2026-11-21 (law.moj.gov.tw and Ministry of Finance). General information and estimates only; no individual tax advice, agency or filing. The 2025 tax year is 114年度, filed in May 2026; national-holiday deadline shifts are not computed, only weekends.

Input parameters:

- `businessTax`: Business tax filing period
- `company` (boolean): Company or business (include business income tax and prepayment)
- `today` (string): Reference date YYYY-MM-DD for days left
- `year` (integer, required): Calendar year

### `calculate_tw_income_tax` (~377 tokens)

calculate tw income tax

Taiwan individual income tax estimate for income year 2025 (114年度: brackets 590k/1.33M/2.66M/4.98M, exemption 97,000 or 145,500 at 70+, standard deduction 131,000/262,000, salary deduction 218,000, basic living cost 213,000 per person) or 2026 (115年度: 610k/1.38M/2.77M/5.19M, 101,000, 136,000/272,000, 227,000; basic living cost not yet published), rates 5/12/20/30/40% (Income Tax Act art. 5, 17; MOF notice 2025-11-27). Itemized and other special deductions are not included. Taiwan, as of 2026-11-21 (law.moj.gov.tw and Ministry of Finance). General information and estimates only; no individual tax advice, agency or filing. The 2025 tax year is 114年度, filed in May 2026; national-holiday deadline shifts are not computed, only weekends.

Input parameters:

- `disabled` (integer): Of whom with a disability
- `elderly` (integer): Of whom aged 70 or over
- `married` (boolean): Joint return with spouse
- `otherIncome` (number): Other net income (TWD)
- `persons` (integer): People on the return (taxpayer, spouse, dependants)
- `salary` (number): Taxpayer's salary income (TWD)
- `spouseSalary` (number): Spouse's salary income (TWD)
- `year` (integer, required): Income year: 2025 (114年度) or 2026 (115年度)

### `check_tw_business_tax` (~291 tokens)

check tw business tax

Taiwan business tax: small-scale businesses under the monthly threshold are exempt (from 2025-01-01: 100,000 TWD for trading, manufacturing and ordinary food service; 50,000 TWD for renovation, advertising, repair, lodging, leasing, technical and design services; mixed businesses taxed when the ratios add up to 100%); small-scale businesses at or above it are assessed at 1% (Business Tax Act art. 13, 23); invoice-issuing businesses pay 5% output minus input tax (art. 10). The sales level for switching to uniform invoices is not verified. Taiwan, as of 2026-11-21 (law.moj.gov.tw and Ministry of Finance). General information and estimates only; no individual tax advice, agency or filing. The 2025 tax year is 114年度, filed in May 2026; national-holiday deadline shifts are not computed, only weekends.

Input parameters:

- `goodsSales` (number): Monthly (or, with invoices, this period's) sales in the 100,000 TWD threshold group (TWD)
- `invoice` (boolean): Issues uniform invoices (5%)
- `purchases` (number): Purchases and expenses excluding tax this period (TWD)
- `serviceSales` (number): Sales in the 50,000 TWD threshold group (TWD)

### `calculate_tw_late_fee` (~201 tokens)

calculate tw late fee

Taiwan late payment surcharge: 1% of the tax for every 3 days late, transferred to enforcement after 30 days (Tax Collection Act art. 20), plus fine caps: income tax under-reporting up to 2x, not filing up to 3x (Income Tax Act art. 110); business tax evasion up to 5x (Business Tax Act art. 51). Taiwan, as of 2026-11-21 (law.moj.gov.tw and Ministry of Finance). General information and estimates only; no individual tax advice, agency or filing. The 2025 tax year is 114年度, filed in May 2026; national-holiday deadline shifts are not computed, only weekends.

Input parameters:

- `due` (string, required): Payment deadline
- `kind`: Income tax or business tax
- `paid` (string, required): Payment date
- `tax` (number, required): Tax due (TWD)

### `calculate_tw_tax_appeal_deadlines` (~287 tokens)

calculate tw tax appeal deadlines

Taiwan tax dispute dates: 復查 within 30 days from the day after the payment period ends (or after the assessment notice is served) (Tax Collection Act art. 35), 訴願 within 30 days of service of the review decision (Administrative Appeal Act art. 14), administrative lawsuit within 2 months of the appeal decision (Administrative Litigation Act art. 106), overpaid tax refund within 10 years of payment or 15 years when the government is at fault (Tax Collection Act art. 28). Weekend shifts only. Taiwan, as of 2026-11-21 (law.moj.gov.tw and Ministry of Finance). General information and estimates only; no individual tax advice, agency or filing. The 2025 tax year is 114年度, filed in May 2026; national-holiday deadline shifts are not computed, only weekends.

Input parameters:

- `govFault` (boolean): Overpayment caused by the government
- `noticeDelivered` (string): Date the assessment notice was served (if no tax bill)
- `paid` (string): Date the overpaid tax was paid
- `paymentPeriodEnd` (string): Last day of the payment period on the tax bill
- `petitionDecision` (string): Date the appeal decision was served
- `reviewDecision` (string): Date the review decision was served

### `calculate_tw_depreciation` (~266 tokens)

calculate tw depreciation

Taiwan straight-line depreciation using the MOF fixed asset useful-life table (RC/steel buildings 50, reinforced brick 35, brick 25, clad metal 20, metal 15, wood 10, computers 3, tools and fixtures 5, transport-business vehicles 4, other vehicles 5, molds 2 years; lives cannot be shorter, Income Tax Act art. 51), first year prorated by months used, residual value deducted first (Audit Guidelines art. 95), and the expensing rule for items under 2 years or up to 80,000 TWD (art. 77-1). Taiwan, as of 2026-11-21 (law.moj.gov.tw and Ministry of Finance). General information and estimates only; no individual tax advice, agency or filing. The 2025 tax year is 114年度, filed in May 2026; national-holiday deadline shifts are not computed, only weekends.

Input parameters:

- `category` (required): Asset category
- `cost` (number, required): Cost (TWD)
- `residual` (number): Estimated residual value (TWD)
- `start` (string, required): Date put into use
- `years` (integer): Useful life in years (not below the table)

### `calculate_jp_labor_exit` (~326 tokens)

calculate jp labor exit

Japan job exit check: dismissal notice allowance (30 days' average wage less days of notice, 労働基準法 第20条), basic unemployment benefit days for self-quit (90/120/150 by insured years) and dismissal (特定受給資格者 table by age and insured years, 雇用保険法 第22条·第23条), statutory paid leave days by service (第39条), wage claim limitation date (3 years, 第115条·附則第143条) and the FY2026 (令和8年度) regional minimum wage check (Tokyo 1,280, Osaka 1,231 JPY; national weighted average 1,177). Japan (e-Gov, MHLW), as of 2026-11-21. General information and estimates only: no legal advice, no representation, no filing; values that could not be verified are flagged in the result, not computed.

Input parameters:

- `age` (integer, required): Age on the last day
- `dailyAverageWage` (number): Average daily wage (平均賃金, JPY)
- `end` (string, required): Last day of employment
- `hourlyWage` (number): Hourly wage (JPY)
- `insuredYears` (number, required): Years insured under employment insurance
- `noticeDays` (integer): Days of advance notice given
- `reason` (required): Self-quit or dismissal / company reasons
- `region`: Workplace region for the minimum wage check
- `start` (string, required): Employment start date

### `calculate_uk_labor_exit` (~331 tokens)

calculate uk labor exit

UK statutory redundancy pay (0.5/1/1.5 weeks per year by age, weekly pay capped at 751 GBP, at most 20 years, 2 years' service needed; ERA 1996 s.162), statutory notice (1 week per year up to 12), statutory holiday (5.6 weeks capped at 28 days), National Minimum Wage check (12.71 GBP at 21+, 10.85 at 18-20, 8.00 under 18, April 2026), SSP (lower of 123.25 GBP a week or 80% of average weekly earnings), and the employment tribunal claim deadline (3 months, 6 months for incidents from 2026-10-01 under the Employment Rights Act 2025). United Kingdom (gov.uk), as of 2026-11-21. General information and estimates only: no legal advice, no representation, no filing; values that could not be verified are flagged in the result, not computed.

Input parameters:

- `age` (integer, required): Age on the last day
- `averageWeeklyEarnings` (number): Average weekly earnings for Statutory Sick Pay (GBP)
- `daysPerWeek` (number): Days worked per week
- `end` (string, required): Last day of employment
- `hourlyPay` (number): Hourly pay (GBP)
- `incident` (string): Date of the incident or dismissal for the tribunal deadline
- `start` (string, required): Employment start date
- `weeklyPay` (number, required): Gross weekly pay (GBP)

### `check_us_labor_rights` (~325 tokens)

check us labor rights

US wage and layoff check: federal (7.25 USD) and state minimum wage (CA 16.90, NY outside NYC 16.00, NYC 17.00, TX 7.25), FLSA overtime at 1.5x over 40 hours, WARN Act 60-day notice (100+ employees, 50+ laid off at a site), California final pay on the last day, EEOC charge deadline (180 days, 300 with a state agency) and FLSA back-wage limitation (2 years, 3 if willful). NY and TX final pay are not verified. United States (DOL, eCFR, EEOC, CA DIR), as of 2026-11-21. General information and estimates only: no legal advice, no representation, no filing; values that could not be verified are flagged in the result, not computed.

Input parameters:

- `employees` (integer): Employer's employees
- `end` (string): Last day of employment
- `fired` (boolean): Discharged by the employer (CA final pay due immediately)
- `hourlyWage` (number): Hourly wage (USD)
- `incident` (string): Date of the discriminatory act or wage violation
- `layoffAtSite` (integer): Employees laid off at one site
- `state`: Minimum wage jurisdiction
- `stateAgency` (boolean): A state or local fair employment agency covers the claim (300 days)
- `weeklyHours` (number): Hours worked in a week

### `calculate_fr_labor_exit` (~271 tokens)

calculate fr labor exit

France indemnité légale de licenciement (8 months' service needed; 1/4 month per year up to 10 years, 1/3 beyond; Code du travail R1234-2), SMIC check (12.31 EUR an hour, 1,867.02 EUR a month from 2026-01-01), rupture conventionnelle 15-day retraction date, deadlines to contest the dismissal (12 months) and to claim wages (3 years). Préavis length and post-April 2025 ARE rules are not verified. France (service-public.gouv.fr, Légifrance), as of 2026-11-21. General information and estimates only: no legal advice, no representation, no filing; values that could not be verified are flagged in the result, not computed.

Input parameters:

- `end` (string, required): End of the contract (end of notice)
- `hourlyGross` (number): Hourly gross pay (EUR)
- `mode`: Dismissal or rupture conventionnelle
- `monthlyReference` (number, required): Reference monthly gross salary (EUR)
- `notified` (string): Date the dismissal was notified
- `signed` (string): Rupture conventionnelle signing date
- `start` (string, required): Employment start date

### `calculate_es_labor_exit` (~293 tokens)

calculate es labor exit

Spain severance: despido improcedente 33 days' salary per year (max 24 months) or objetivo 20 days per year (max 12 months) (Estatuto de los Trabajadores art. 53, 56), daily salary as annual / 365, unemployment benefit duration from days contributed (LGSS art. 269), SMI check (1,221 EUR a month in 14 payments, 40.70 a day, 2026), and the 20 business-day deadline to challenge the dismissal (Saturdays and Sundays skipped only). Service before 2012-02-12 uses a transition rule that is not computed. Spain (BOE), as of 2026-11-21. General information and estimates only: no legal advice, no representation, no filing; values that could not be verified are flagged in the result, not computed.

Input parameters:

- `annualSalary` (number, required): Gross annual salary including extra payments (EUR)
- `contributedDays` (integer): Days contributed to unemployment in the last 6 years
- `end` (string, required): Dismissal date
- `monthlySalary` (number): Monthly salary for the SMI check (EUR, 14 payments)
- `notified` (string): Date the dismissal was notified
- `start` (string, required): Employment start date
- `type` (required): Unfair dismissal or objective dismissal

### `calculate_cn_labor_exit` (~287 tokens)

calculate cn labor exit

China economic compensation N (1 month per year; 6 months or more counts as a year, under 6 months as half; 劳动合同法 第47条), the cap at 3x the local average monthly wage which also limits N to 12 years, 2N for unlawful termination (第87条), one month in lieu of notice (第40条), and unemployment benefit duration 12/18/24 months by insured years (失业保险条例 第17条). Annual leave, arbitration limitation and 2026 local minimum wages are not verified. China mainland (flk.npc.gov.cn), as of 2026-11-21. General information and estimates only: no legal advice, no representation, no filing; values that could not be verified are flagged in the result, not computed.

Input parameters:

- `end` (string, required): Last day of employment
- `insuredYears` (number): Years paying unemployment insurance
- `localAverageMonthly` (number): Local average monthly wage published by the city (CNY)
- `monthlyWage` (number, required): Average monthly wage over the last 12 months (CNY)
- `noNotice` (boolean): Terminated under article 40 without 30 days' notice
- `start` (string, required): Employment start date
- `unlawful` (boolean): Unlawful termination (2N)

### `calculate_tw_labor_exit` (~329 tokens)

calculate tw labor exit

Taiwan termination: notice period 10/20/30 days by service (勞動基準法 第16條), severance under the new pension system 0.5 month per year up to 6 months (勞工退休金條例 第12條) or the old system 1 month per year (勞基法 第17條), special leave days by service up to 30 (第38條), unemployment benefit at 60% of insured wage for 6 months, or 9 months at 45+ or with a disability (就業保險法 第16條), and the dates for paying severance (within 30 days) and the 5-year wage claim limitation (民法 第126條). The 2026 minimum wage amount is not verified. Taiwan (law.moj.gov.tw), as of 2026-11-21. General information and estimates only: no legal advice, no representation, no filing; values that could not be verified are flagged in the result, not computed.

Input parameters:

- `age` (integer): Age on the last day
- `averageMonthlyWage` (number, required): Average monthly wage over the last 6 months (TWD)
- `disabled` (boolean): Has a disability
- `end` (string, required): Last day of employment
- `insuredMonthlyWage` (number): Average insured monthly wage for employment insurance (TWD)
- `start` (string, required): Employment start date
- `system` (required): New (勞退新制) or old pension system for severance

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/yuli3-oiyo-calculations/api#diagnostics

## Score history

- 2026-11-21: 72
- 2026-11-20: 72
- 2026-11-19: 71
- 2026-11-18: 71
- 2026-11-17: 70
- 2026-11-16: 70
- 2026-11-15: 70
- 2026-11-14: 69
- 2026-11-13: 69
- 2026-11-12: 69
- 2026-11-11: 68
- 2026-11-10: 68
- 2026-11-09: 67

## Common questions

### What is the OIYO Korea Calculators MCP server?

OIYO Korea Calculators is an MCP server listed in the public MCP registry as io.github.yuli3/oiyo-calculations. Korean tax, payroll, labor, real estate, calendar and business strategy calculators. Code, no LLM. This page covers its hosted endpoint (https://api.oiyo.net/mcp).

### Is the OIYO Korea Calculators MCP server safe to use?

OIYO Korea Calculators scores 72 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the OIYO Korea Calculators MCP server expose?

OIYO Korea Calculators exposes 179 tools: get_kr_minimum_wage, get_kr_holidays, check_kr_business_day, calculate_saju_astrology, calculate_unemployment_benefits, and 174 more. Their descriptions and schemas cost roughly 45,058 tokens of context every time the server is loaded.

### Does the OIYO Korea Calculators MCP server require authentication?

No. We connected to OIYO Korea Calculators without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the OIYO Korea Calculators MCP server still maintained?

OIYO Korea Calculators is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the OIYO Korea Calculators MCP server?

VerifyMCP ran 13 checks on OIYO Korea Calculators, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://api.oiyo.net/mcp
- Repository: https://github.com/yuli3/api-oiyo
- Website: https://api.oiyo.net/docs
- Changelog RSS feed: https://verifymcp.io/servers/yuli3-oiyo-calculations/api.xml
- Changelog JSON feed: https://verifymcp.io/servers/yuli3-oiyo-calculations/api/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/yuli3-oiyo-calculations/api.json
- HTML version of this page: https://verifymcp.io/servers/yuli3-oiyo-calculations/api
