# OIYO Korea Welfare & Benefits

> OIYO Korea Welfare & Benefits is a free MCP server for legal and government. Korean welfare, labor-pay and benefit calculators for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://api.oiyo.net/docs
- **Repository:** https://github.com/yuli3/api-oiyo
- **MCP Registry name:** io.github.yuli3/oiyo-welfare
- **Categories:** [legal and government](https://ai-powered.com/categories/legal-and-government), [hr and payroll](https://ai-powered.com/categories/hr-and-payroll)
- **Listing updated:** 2026-11-20

## About

This server exposes 24 deterministic calculators for people in South Korea checking money they may be owed. They cover earned income and child tax credits, unemployment benefits including voluntary resignation, unpaid wage substitute payments, industrial accident leave pay, severance, weekly holiday, overtime and annual leave pay, maternity leave and reduced-hours pay, health insurance premiums, youth rent support, housing loans and subscription special supply.

There is no language model inside, so the same inputs always return the same result, and each successful answer links to a matching interactive calculator in Korean. No sign-in or key is needed, and every tool is read-only.

Results are simulations, not a determination of eligibility or a substitute for professional advice. Users should review personal birth dates and financial details before an assistant sends them. A fuller server on the same project adds payroll, tax, holiday and unit tools.

## Features

- **Benefit simulation:** Estimates unemployment benefits, maternity pay and other statutory payments.
- **Worker pay rights:** Calculates unpaid wages, overtime, weekly holiday allowance, severance and annual leave.
- **Tax credits:** Covers earned income and child tax credits and dependent deductions.
- **Housing support:** Includes youth rent support, policy housing loans and subscription special supply.
- **Deterministic results:** Uses plain code with no language model, so results repeat.
- **No sign-in:** Read-only tools with no key required.

## Good for

- Check expected unemployment benefit after leaving a job
- Estimate overtime or weekly holiday pay owed
- Calculate severance pay
- Check youth rent support or housing loan options
- Estimate maternity leave pay

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http oiyo-welfare https://api-oiyo.861106.workers.dev/mcp/welfare
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api-oiyo.861106.workers.dev/mcp/welfare
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "oiyo-welfare": {
      "url": "https://api-oiyo.861106.workers.dev/mcp/welfare"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "oiyo-welfare": {
      "type": "http",
      "url": "https://api-oiyo.861106.workers.dev/mcp/welfare"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "oiyo-welfare": {
      "serverUrl": "https://api-oiyo.861106.workers.dev/mcp/welfare"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api-oiyo.861106.workers.dev/mcp/welfare
```

Enter a Name (for example "OIYO Korea Welfare & Benefits"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "oiyo-welfare": {
      "type": "http",
      "url": "https://api-oiyo.861106.workers.dev/mcp/welfare"
    }
  }
}
```

## Tools

All 24 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `get_kr_minimum_wage` (says read-only): Verified Korean minimum wage by year, effective dates and 8/209-hour examples. Not a 2027 net-salary calculator; uncollected insurance is unavailable.
- `calculate_unemployment_benefits` (says read-only): Simulates statutory South Korean unemployment benefits (실업급여) duration, daily benefit rate, and total expected payout.
- `calculate_weekly_allowance` (says read-only): Calculates statutory South Korean weekly holiday allowance (주휴수당) for part-time and hourly workers.
- `calculate_overtime_pay` (says read-only): Calculates statutory overtime, night, and holiday allowances under Korean Labor Standards Act.
- `calculate_severance_pay` (says read-only): 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.
- `calculate_annual_leave` (says read-only): Calculates statutory annual paid leave days (연차 휴가) and unused leave cash-out allowance by years of service.
- `calculate_health_insurance` (says read-only): 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.
- `diagnose_hug_guarantee` (says read-only): Diagnoses HUG Jeonse Deposit Return Guarantee eligibility (126% rule, 60% senior debt limit, 90% debt ratio limit) and calculates statutory guarantee fee.
- `calculate_kr_work_child_incentive` (says read-only): 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.
- `calculate_kr_maternity_leave_pay` (says read-only): 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.
- `calculate_kr_wage_guarantee` (says read-only): 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
- `calculate_kr_injury_leave_pay` (says read-only): 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.
- `calculate_kr_monthly_rent_credit` (says read-only): 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.
- `calculate_kr_ordinary_wage` (says read-only): 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, ho
- `calculate_kr_long_term_care_copay` (says read-only): 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.
- `check_kr_dependent_deduction` (says read-only): 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 
- `calculate_kr_dismissal_notice_pay` (says read-only): 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 n
- `calculate_kr_shutdown_allowance` (says read-only): 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 (시
- `calculate_kr_reduced_hours_childcare_pay` (says read-only): 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, t
- `check_kr_probation_minimum_wage` (says read-only): 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).
- `check_kr_voluntary_quit_unemployment` (says read-only): 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 p
- `check_kr_youth_rent_support` (says read-only): 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 mo
- `find_kr_policy_housing_loans` (says read-only): 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
- `check_kr_special_supply` (says read-only): 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 b

## FAQ

### Do I need an account or key?

No. There is no sign-in and no API key, and every tool is read-only.

### Are the results official?

No. They are simulations and do not confirm eligibility or replace professional advice.

### How many tools does the welfare server have?

24.

### What is the endpoint?

https://api.oiyo.net/mcp/welfare, with a mirror at https://api-oiyo.861106.workers.dev/mcp/welfare.

### Is OIYO Korea Welfare & Benefits free?

Yes. OIYO Korea Welfare & Benefits is free to use.

### How do I add OIYO Korea Welfare & Benefits to Claude Code?

Run this command in your terminal: claude mcp add --transport http oiyo-welfare https://api-oiyo.861106.workers.dev/mcp/welfare

### What are the best alternatives to OIYO Korea Welfare & Benefits?

The closest alternatives to OIYO Korea Welfare & Benefits are OIYO Korea Calculators, Korea Payroll & Tax (kkuldogu), Korea Tax Calculator, 노동 업무 도구 (k-labor) and DecisionsCalc calculators.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Korea Payroll & Tax (kkuldogu)](https://ai-powered.com/mcp/korea-payroll-and-tax-kkuldogu): Korea Payroll & Tax (kkuldogu) is an MCP server for hr and payroll.
- [Korea Tax Calculator](https://ai-powered.com/mcp/korea-tax-calculator): Korea Tax Calculator is an open-source MCP server for finance and payments.
- [노동 업무 도구 (k-labor)](https://ai-powered.com/mcp/k-labor): 노동 업무 도구 (k-labor) is a free MCP server for legal and government.
- [DecisionsCalc calculators](https://ai-powered.com/mcp/decisionscalc-calculators): DecisionsCalc calculators is a free MCP server for finance and payments.
- [Klar Calculators](https://ai-powered.com/mcp/klar-calculators): Klar Calculators is a free MCP server for finance and payments.
- [Korea Benefits Eligibility](https://ai-powered.com/mcp/korea-benefits-eligibility): Korea Benefits Eligibility is an MCP server for legal and government.
- [日本の給与・社会保険・労働法](https://ai-powered.com/mcp/listing-mweod62t): 日本の給与・社会保険・労働法 is an open-source MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/oiyo-korea-welfare-and-benefits
