Back to Browse

Api Oiyo MCP Server

by Yuli3
Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://api-oiyo.861106.workers.dev/mcp streamable-http: https://api.oiyo.net/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 2 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

85 tools verified · Open access · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-yuli3-oiyo-calculations": {
      "url": "https://api-oiyo.861106.workers.dev/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

OIYO Korea Calculators — MCP server

Deterministic calculators for South Korea: payroll and net salary, minimum wage, weekly holiday allowance, overtime, severance, annual leave, unemployment benefits, health insurance, year-end tax settlement, freelancer 3.3% income tax, acquisition/property/capital-gains/inheritance-gift tax, public holidays and business days, saju (Four Pillars), unit conversion and more.

  • Remote MCP endpoint (Streamable HTTP): https://api-oiyo.861106.workers.dev/mcp (https://api.oiyo.net/mcp serves the same tools, but its site-wide bot protection may challenge some datacenter clients)
  • No sign-in, no API key. Every tool is read-only.
  • No LLM inside. Results are plain code, so the same input always gives the same output.
  • REST + OpenAPI: https://api.oiyo.net/docs · openapi.json · tools.json · llms.txt
  • Official MCP Registry name: io.github.yuli3/oiyo-calculations

Each successful result includes a sourcePage link to the matching interactive calculator on tools.oiyo.net (Korean), where people can adjust inputs and read the explanation.

Connect

Claude (claude.ai / Desktop)

Settings → Connectors → Add custom connector → URL https://api-oiyo.861106.workers.dev/mcp.

Claude Code

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

Cursor

Add to .cursor/mcp.json (or use the .mcp.json in this repo):

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

VS Code (GitHub Copilot agent mode)

.vscode/mcp.json:

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

ChatGPT

With developer mode enabled: Settings → Apps & Connectors → Create → MCP server URL https://api-oiyo.861106.workers.dev/mcp, authentication None.

Grok (xAI API)

{
  "model": "grok-4",
  "input": [{ "role": "user", "content": "What is the 2026 net monthly pay in Korea on a 3,500,000 KRW salary?" }],
  "tools": [{ "type": "mcp", "server_url": "https://api-oiyo.861106.workers.dev/mcp", "server_label": "oiyo" }]
}

Tools

ToolWhat it does
get_kr_minimum_wageVerified Korean minimum wage by year, effective dates and 8/209-hour examples. Not a 2027 net-salary calculator; uncollected insurance is unavailable.
get_kr_holidaysGet official South Korea public holidays, substitute holidays, and solar terms for a given year.
check_kr_business_dayDetermines if a given date is a South Korea working business day or a public holiday/weekend.
calculate_saju_astrologyComputes traditional Korean Sexagenary Cycle (60 Gapja) Four Pillars and Five Elements (오행) balance from birth datetime and solar/lunar calendar.
calculate_unemployment_benefitsSimulates statutory South Korean unemployment benefits (실업급여) duration, daily benefit rate, and total expected payout.
calculate_weekly_allowanceCalculates statutory South Korean weekly holiday allowance (주휴수당) for part-time and hourly workers.
calculate_overtime_payCalculates statutory overtime, night, and holiday allowances under Korean Labor Standards Act.
calculate_net_salaryCalculates 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.
calculate_severance_paySouth 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_leaveCalculates statutory annual paid leave days (연차 휴가) and unused leave cash-out allowance by years of service.
calculate_military_serviceCalculates South Korea mandatory military service duration, completion rate, remaining days, and rank promotion dates.
calculate_gas_billCalculates South Korea residential city gas invoice amount based on cubic meters used and heating/cooking tariff.
convert_unitsUniversal deterministic unit conversion for area (pyeong ↔ m², sqft, ha), length, mass, and temperature.
calculate_cagrCalculates Compound Annual Growth Rate (CAGR, 연평균 복합 성장률), total ROI, and Rule of 72 milestone.
calculate_compound_interestSimulates compound interest growth with initial principal, annual yield, recurring monthly contributions, and annual balance trajectory.
calculate_health_insuranceCalculates 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_guaranteeDiagnoses HUG Jeonse Deposit Return Guarantee eligibility (126% rule, 60% senior debt limit, 90% debt ratio limit) and calculates statutory guarantee fee.
calculate_capital_gains_taxCalculates 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.
compare_vat_taxCompares 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).
calculate_inheritance_gift_taxCalculates South Korea 2026 statutory inheritance and gift tax, progressive tax brackets (10-50%), relationship deductions, and voluntary filing discount.
calculate_loan_refinanceCalculates loan refinancing savings, prepayment penalty fees with 3-year sliding taper, and break-even point in months.
calculate_card_tax_deductionCalculates South Korea 2026 year-end card tax deduction, 25% threshold, credit (15%) vs check (30%) rates, and golden ratio strategy.
calculate_kr_year_end_settlementSouth 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.
calculate_kr_freelancer_income_taxSouth 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.
calculate_kr_acquisition_taxSouth 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.
calculate_kr_property_taxSouth 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.
value_kr_unlisted_sharesSouth Korea unlisted share valuation for inheritance/gift tax (상증법 보충적 평가): net income value 3 : net asset value 2 (2:3 for real-estate-heavy companies), 80% net asset floor, 20% largest-shareholder premium unless exempt.
calculate_kr_family_business_deductionSouth Korea family business inheritance deduction (가업상속공제): 30/40/60B KRW caps by years operated, non-business asset exclusion, inheritance tax with vs without it.
calculate_kr_incorporation_conversionSouth Korea sole proprietor → corporation conversion: minimum capital, capital gains tax deferred under 조특법 제32조, 50% acquisition tax relief through 2027.
calculate_dcf_valuationDCF enterprise and equity value: FCFF forecast, Gordon terminal value, CAPM WACC builder, WACC × growth sensitivity table.
evaluate_decision_treeDecision tree expected value from simple options or a full decision/chance/outcome tree: best path, outcome distribution, loss probability, breakeven success probability.
schedule_critical_pathProject schedule by CPM with PERT estimates: slack, critical path, duration, on-time probability for a deadline, calendar dates.
analyze_swotSWOT stance (SO/ST/WO/WT) with TOWS strategy pairs, IFE/EFE weighted scores and the IE matrix cell.
classify_bcg_portfolioBCG matrix: star / cash cow / question mark / dog from market growth and relative share, revenue mix and recommended moves.
map_brand_positioningPositioning map: nearest competitor per brand, crowded brands, largest empty spot, distance to a customer ideal point.
calculate_unit_economics_runwayLTV, LTV/CAC grade, CAC payback; monthly cash runway, break-even month and default alive; break-even units.
rank_prioritiesRICE ranking or a weighted decision matrix with the weight each criterion would need to flip the winner.
plan_campaign_supplyCampaign stockout week, shortage, fill rate and extra weekly production needed after the lead time.
evaluate_influencer_dealCreator deal: orders, ROAS, contribution, break-even conversion, Korean 3.3% / 8.8% withholding or VAT, disclosure checklist.
plan_quality_recoveryQuality incident: recall scope costs and allocation of remaining stock by priority, penalty or pro rata.
compare_alternative_materialsRaw material switch: annual saving, test cost payback, weeks to approval, weighted score.
check_big_order_capacityBig order vs existing commitments under capacity: decline / full / partial / overtime / optimal profit.
analyze_market_testSample size, A/B z-test with p-value, overseas entry payback and go/extend/stop.
check_sales_rebatesSales rebates: tier amounts, related-party groups, overpayment holds, arm's-length range, VAT/corporate tax notes.
evaluate_acquisitionAcquisition: EPS accretion/dilution, payback, synergy needed, 100-day integration template.
calculate_kr_work_child_incentive근로장려금·자녀장려금 for the 2026 application: bands, asset cut, late filing, how to apply.
calculate_kr_maternity_leave_payMaternity leave (90/120/100 days) and spouse leave (20 days) pay split between employer and employment insurance with 2026 caps.
calculate_kr_wage_guaranteeUnpaid-wage guarantee (대지급금): simple retired/employed, insolvency with age caps and the 2026-08-20 six-month expansion.
calculate_kr_injury_leave_payIndustrial accident leave pay: 70%, minimum-wage guarantee, 2026 maximum base, 3-day rule.
calculate_kr_monthly_rent_creditMonthly rent tax credit 17%/15% up to 10M KRW plus local income tax.
compare_kr_retirement_pensionRetirement pension DB vs DC with yearly series and break-even return.
calculate_kr_ordinary_wageOrdinary wage (통상임금) hourly rate and overtime premiums before/after the 2024-12-19 Supreme Court ruling.
check_kr_fixed_overtime_payFixed overtime allowance (포괄임금) shortfall against statutory premiums, up to 36 months.
calculate_kr_comprehensive_real_estate_taxComprehensive real estate holding tax on housing (종부세) with overlap and one-house credits.
calculate_kr_long_term_care_copayLong-term care insurance copay (노인장기요양) by grade, home vs facility, 2026 limits.
check_kr_dependent_deductionYear-end dependent deduction (부양가족) check by age, income and living together, with tax saved per person.
calculate_kr_stock_major_shareholder_taxListed stock major shareholder test (5B KRW or stake at previous year-end) and capital gains tax 20%/25%/30%.
calculate_kr_dismissal_notice_payDismissal notice pay (해고예고수당): 30 days of ordinary wage without 30 days' notice, with the 제26조 exceptions.
calculate_kr_shutdown_allowanceShutdown allowance (휴업수당): 70% of average wage, ordinary-wage alternative, partial-work deduction, 5+ employees.
calculate_kr_reduced_hours_childcare_payReduced hours for childcare benefit 2026: first 10 h at 100% (cap 2.5M), rest 80% (cap 1.6M).
check_kr_probation_minimum_wageProbation minimum wage: 90% (9,288 KRW) only for 1-year+ contracts, first 3 months, non-manual jobs.
plan_kr_annual_leave_promotionAnnual leave use promotion (연차 사용촉진) schedule under 근로기준법 제61조.
check_kr_voluntary_quit_unemploymentJustified reasons for voluntary resignation (별표 2) and 180 insured days for unemployment benefit.
check_kr_subcontract_direct_paymentSubcontract direct payment grounds (하도급법 제14조), payable range and 15.5% late interest.
check_kr_family_loan_interestFamily loan gift test: 4.6% statutory interest vs agreed rate, 10M KRW a year threshold, safe rate.
check_kr_parent_house_free_useRent-free use of a family home: value × 2% × 5-year PV ≥ 100M is a gift; free collateral too.
check_kr_family_low_price_saleBelow-market family sale: buyer gift (30%/300M) and seller capital gains at market value (5%/300M).
calculate_kr_sme_youth_tax_reductionSME young-employee income tax reduction (조특법 제30조): 90%, 2M a year cap, end month.
calculate_kr_yellow_umbrella_deduction노란우산공제 income deduction limits (6M/5M/4M/2M) and tax saved.
compare_kr_general_vs_simplified_vatGeneral vs simplified VAT taxpayer: annual VAT by sector rate, exemption, refunds, invoice duty.
calculate_kr_business_car_expenseBusiness car expense limits: 15M KRW without a logbook, 8M depreciation cap with carry-over, lease/rent.
compare_kr_overseas_stock_vs_etf_taxOverseas stocks direct (22% after 2.5M) vs domestic overseas ETF (15.4%, comprehensive above 20M) vs ISA.
check_kr_officetel_house_countOfficetel house count for acquisition tax, surcharge/종부세, one-house exemption and subscription; small new-build rule.
compare_kr_ticket_vs_presale_taxRedevelopment member right (입주권) vs pre-sale right (분양권) capital gains tax.
compare_kr_inherited_house_valuationInherited house: official price vs appraisal, inheritance tax + later capital gains tax.
plan_kr_inheritance_gift_filing_deadlineInheritance (6 months) / gift (3 months) filing deadlines, related dates and late penalties.
check_kr_youth_rent_supportYouth monthly rent support (200k × 24 months): age, income, assets, deposit and rent checks.
check_kr_special_supplyHousing subscription special supply eligibility and tier (newlywed, newborn, first-time, multi-child, elderly parent).
find_kr_policy_housing_loansHousing and Urban Fund loans (디딤돌, 버팀목, 신생아 특례, 주택드림, 월세대출): eligibility, max loan, rate range.
check_kr_commercial_rent_increaseCommercial lease 5% rent increase cap, regional converted-deposit limits, 1-year rule, conversion rate.
start_kr_law_intakeClarify-first intake for Korean tax/accounting/labor/administrative/court problems: next questions, deadlines (D-day), statutes, free help, when to see a licensed professional.
search_kr_statutesSearch ~80 everyday Korean statute articles with plain-Korean summaries and law.go.kr links.
get_kr_professional_scopeLegal scope and title rules of 세무사·공인회계사·공인노무사·행정사·법무사, with a who-can-do-what matrix.
calculate_kr_housing_rental_income_taxHousing rental income tax: deemed rent, separate 14% vs comprehensive.
get_kr_business_tax_calendarSouth Korea business filing calendar (VAT, corporate/income tax, withholding, payment statements) with holiday-shifted due dates, plus must-do / must-not-do checklists by stage or role.

Limits and disclaimers

  • Tax, payroll and labor results are estimates, not tax or legal advice. Tax routes return basis (the legal articles used), notCovered and a disclaimer, and refuse unknown inputs or unsupported tax years instead of guessing.
  • Saju results are a calendar calculation for entertainment and self-reflection. They are not a prediction or a diagnosis.
  • Rates follow the published 2026 Korean rules (2027 where officially announced, e.g. the minimum wage).

Privacy

Inputs (salaries, birth dates and so on) are computed in memory and not stored by the application. Aggregate usage counts keep only the route, status class, country, a coarse client family and, for MCP, the listing or client name. No query strings, request bodies or IP addresses are recorded. Site privacy policy: https://oiyo.net/ko/legal/privacy/.

Support

Open an issue in this repository. Made by OIYO.

Reviews

No reviews yet

Be the first to review this server!