OIYO Korea Calculators MCP server
Commit Nov 16, 2026Performs deterministic calculations for South Korean payroll, taxes, labor laws, real estate, and traditional astrology.
Also known as yuli3/api-oiyo, api-oiyo
- Stars
- 0
- Tools
- 26
- Downloads, 30 days
- —
- Latest version
- 1.9.0
- Last commit
- Nov 16, 2026
- License
- —
What is OIYO Korea Calculators MCP?
OIYO Korea Calculators performs deterministic calculations for South Korean payroll, taxes, labor laws, real estate, and traditional astrology. It exposes 26 tools, such as get_kr_minimum_wage, get_kr_holidays, check_kr_business_day.
Summary generated from the project's README
About OIYO Korea Calculators MCP server
Calculating South Korean payroll, taxes, and labor law compliance is what developers and users can achieve through this remote MCP server. It provides deterministic results for complex financial and legal scenarios, including net monthly salary after social insurance, severance pay, and unemployment benefits. The server also handles specialized real estate calculations like capital gains tax, acquisition tax, and HUG Jeonse deposit guarantee eligibility.
Users can connect via a remote HTTP endpoint to clients such as Claude, Cursor, VS Code, and ChatGPT without needing an API key or sign-in. Because the server contains no LLM inside, it functions as a pure calculation engine where the same input always produces the same output. It covers a wide range of specific Korean contexts, from freelancer 3.3% income tax and year-end tax settlements to traditional saju astrology and unit conversions.
Every successful calculation includes a link to an interactive version of the tool for manual adjustment and explanation. While it provides estimates based on 2026 statutory rates, it is not a substitute for professional tax or legal advice.
What you can do with it
- 1Calculate monthly take-home payDetermine the net monthly salary after social insurance and estimated income tax for a specific gross amount in South Korea.
- 2Estimate real estate tax liabilitiesCalculate the expected capital gains tax for a property sale, including exemptions for single-home owners.
- 3Verify labor law entitlementsFind out the statutory amount for weekly holiday allowances or overtime pay under the Korean Labor Standards Act.
- 4Check business day availabilityConfirm if a specific date in South Korea is a working day or a public holiday.
Written from the project's README. Every use case is checked against a quote from it.
How to install OIYO Korea Calculators MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall OIYO Korea Calculators MCP in Claude Code
$ claude mcp add --transport http api-oiyo https://api-oiyo.861106.workers.dev/mcpInstall OIYO Korea Calculators MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"api-oiyo": {
"url": "https://api-oiyo.861106.workers.dev/mcp"
}
}
}Install OIYO Korea Calculators MCP in VS Code
.vscode/mcp.json
{
"servers": {
"api-oiyo": {
"type": "http",
"url": "https://api-oiyo.861106.workers.dev/mcp"
}
}
}Install OIYO Korea Calculators MCP in VS Code CLI
$ code --add-mcp '{"name":"api-oiyo","type":"http","url":"https://api-oiyo.861106.workers.dev/mcp"}'Install OIYO Korea Calculators MCP in Codex
$ codex mcp add api-oiyo --url https://api-oiyo.861106.workers.dev/mcpInstall OIYO Korea Calculators MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.api-oiyo] url = "https://api-oiyo.861106.workers.dev/mcp"
Install OIYO Korea Calculators MCP in Gemini CLI
$ gemini mcp add -s user --transport http api-oiyo https://api-oiyo.861106.workers.dev/mcpInstall OIYO Korea Calculators MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"api-oiyo": {
"url": "https://api-oiyo.861106.workers.dev/mcp",
"type": "http"
}
}
}OIYO Korea Calculators MCP tools 26
Detected from the READMEget_kr_minimum_wageget_kr_holidayscheck_kr_business_daycalculate_saju_astrologycalculate_unemployment_benefitscalculate_weekly_allowancecalculate_overtime_paycalculate_net_salarycalculate_severance_paycalculate_annual_leavecalculate_military_servicecalculate_gas_bill
Show all 26 toolsShow fewer tools
convert_unitscalculate_cagrcalculate_compound_interestcalculate_health_insurancediagnose_hug_guaranteecalculate_capital_gains_taxcompare_vat_taxcalculate_inheritance_gift_taxcalculate_loan_refinancecalculate_card_tax_deductioncalculate_kr_year_end_settlementcalculate_kr_freelancer_income_taxcalculate_kr_acquisition_taxcalculate_kr_property_tax
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableyuli3/api-oiyo is public and reachablegithub.com/yuli3/api-oiyo ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-14github.com/yuli3/api-oiyo ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model26 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 148 msPass
README
View on GitHubOIYO 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/mcpserves 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
| Tool | What it does |
|---|---|
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. |
get_kr_holidays |
Get official South Korea public holidays, substitute holidays, and solar terms for a given year. |
check_kr_business_day |
Determines if a given date is a South Korea working business day or a public holiday/weekend. |
calculate_saju_astrology |
Computes traditional Korean Sexagenary Cycle (60 Gapja) Four Pillars and Five Elements (오행) balance from birth datetime and solar/lunar calendar. |
calculate_unemployment_benefits |
Simulates statutory South Korean unemployment benefits (실업급여) duration, daily benefit rate, and total expected payout. |
calculate_weekly_allowance |
Calculates statutory South Korean weekly holiday allowance (주휴수당) for part-time and hourly workers. |
calculate_overtime_pay |
Calculates statutory overtime, night, and holiday allowances under Korean Labor Standards Act. |
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. |
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. |
calculate_annual_leave |
Calculates statutory annual paid leave days (연차 휴가) and unused leave cash-out allowance by years of service. |
calculate_military_service |
Calculates South Korea mandatory military service duration, completion rate, remaining days, and rank promotion dates. |
calculate_gas_bill |
Calculates South Korea residential city gas invoice amount based on cubic meters used and heating/cooking tariff. |
convert_units |
Universal deterministic unit conversion for area (pyeong ↔ m², sqft, ha), length, mass, and temperature. |
calculate_cagr |
Calculates Compound Annual Growth Rate (CAGR, 연평균 복합 성장률), total ROI, and Rule of 72 milestone. |
calculate_compound_interest |
Simulates compound interest growth with initial principal, annual yield, recurring monthly contributions, and annual balance trajectory. |
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. |
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. |
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. |
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). |
calculate_inheritance_gift_tax |
Calculates South Korea 2026 statutory inheritance and gift tax, progressive tax brackets (10-50%), relationship deductions, and voluntary filing discount. |
calculate_loan_refinance |
Calculates loan refinancing savings, prepayment penalty fees with 3-year sliding taper, and break-even point in months. |
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. |
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. |
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. |
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. |
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. |
Limits and disclaimers
- Tax, payroll and labor results are estimates, not tax or legal advice. Tax routes return
basis(the legal articles used),notCoveredand 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.
OIYO Korea Calculators MCP questions
How do I add OIYO Korea Calculators MCP to Claude Code?
Run claude mcp add --transport http api-oiyo https://api-oiyo.861106.workers.dev/mcp in your terminal. Add --scope user to make it available in every project.
How do I add OIYO Korea Calculators MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does OIYO Korea Calculators MCP provide?
It exposes 26 tools, including get_kr_minimum_wage, get_kr_holidays, check_kr_business_day, calculate_saju_astrology, calculate_unemployment_benefits.
Does this server use LLMs for calculations?
No, the server contains no LLM inside; results are plain code so the same input always gives the same output.
Do I need an API key to use the tools?
No, there is no sign-in or API key required, and every tool is read-only.
Are my personal inputs stored?
No, inputs like salaries and birth dates are computed in memory and are not stored by the application.