Skip to content
MCP server

노동 업무 도구 (k-labor)

Korean payroll, leave, tax and labor-form tools: contracts, NHIS reports, calculators

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, self-hosted, Windows
Runs
Locally
Version
0.2.0
Listing updated
3 days ago

About 노동 업무 도구 (k-labor)

노동 업무 도구 (k-labor) is a free MCP server for legal and government. It runs locally on your machine and is started by your AI client.

Built by Yellow Envelope (yellowenvelope.kr), this package turns a Korean labor-compliance site into tools an assistant can call. The README says it can be run on your own PC through stdio, with tools grouped by area (nhis, popbill, contract, calc, leave, tax, duties, work-rules, nosa) so you switch on only what you need with the --groups option.

The tools cover finding the right National Health Insurance branch from an address or business number, building loss-of-eligibility and acquisition report PDFs, designing and checking employment contracts, and saving them as xlsx, hwpx or PDF. Calculators cover minimum wage, weekly holiday pay, severance, notice pay, leave pay, take-home pay, shutdown allowance, wage-delay interest, retirement tax and daily-worker withholding, with the legal basis cited. Optional Popbill tools send fax or SMS through your own account, only when you confirm.

Privacy is a design point. Names of people come from a local JSON file so resident numbers never enter the chat, and contract checks reject input that looks like a resident number. The site also lists a related Korean workers' compensation helper.

Install

Run in a terminal

claude mcp add k-labor --env POPBILL_SECRET_KEY='<POPBILL_SECRET_KEY>' -- npx -y k-labor

Add to claude_desktop_config.json

{
  "mcpServers": {
    "k-labor": {
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "k-labor": {
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "k-labor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "k-labor": {
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "k-labor": {
      "command": "npx",
      "args": [
        "-y",
        "k-labor"
      ],
      "env": {
        "POPBILL_SECRET_KEY": "<POPBILL_SECRET_KEY>"
      }
    }
  }
}

Configuration

  • LLG_MCP_GROUPS켤 묶음(쉼표 구분: nhis, popbill, contract, calc, leave, tax, duties, work-rules, nosa). 비우면 전부
  • LAW_OC법제처 국가법령정보 Open API 이용자 ID(OC). 없으면 work-rules 는 묶은 자료로만 답합니다
  • POPBILL_LINK_ID팩스·문자용 본인 팝빌 링크아이디
  • POPBILL_SECRET_KEY팩스·문자용 본인 팝빌 비밀키
  • POPBILL_CORP_NUM팝빌에 가입한 사업자등록번호(숫자 10자리)
  • POPBILL_FAX_SENDER팝빌에 등록한 팩스 발신번호
  • POPBILL_SMS_SENDER팝빌에 등록한 문자 발신번호
  • POPBILL_IS_TEST기본 true(팝빌 테스트환경). 운영환경은 false

Tools this server provides (31)

Taken from the project documentation; the running server may differ.

find_branch
Finds the NHIS branch and contacts for an address or business number.
make_form
Builds NHIS loss or acquisition report PDFs.
popbill_status
Checks the Popbill account and sender numbers.
send_fax
Sends a fax through your Popbill account when confirmed.
fax_result
Looks up a fax result.
send_sms
Sends an SMS through your Popbill account when confirmed.
sms_result
Looks up an SMS result.
design_contract_wage
Designs the wage structure of an employment contract.
check_contract
Checks an employment contract item by item.
make_contract_files
Saves a contract as xlsx, hwpx and PDF locally.
check_min_wage
Compares pay with the minimum wage.
calc_weekly_holiday_pay
Calculates weekly holiday pay.
count_regular_workers
Counts regular workers for the 5 and 10 employee thresholds.
calc_take_home_pay
Calculates take-home pay.
calc_notice_pay
Calculates dismissal notice pay.
calc_leave_pay
Calculates annual leave pay.
calc_severance
Calculates severance pay.
calc_holiday_pay
Calculates pay for work on public holidays.
calc_pay_proration
Prorates pay for partial months.
calc_shutdown_allowance
Calculates business-shutdown allowance.
check_ordinary_wage
Checks which items count as ordinary wage.
calc_wage_delay_interest
Calculates delayed-wage interest.
check_contractor
Checks whether a contractor resembles an employee.
check_monthly_pay
Recalculates a month's pay against the amount received.
calc_annual_leave
Calculates annual leave days.
settle_leave_on_exit
Resettles leave on leaving.
calc_attendance_rate
Calculates attendance rate for leave eligibility.
calc_retirement_tax
Calculates retirement income tax.
calc_midyear_settlement
Estimates mid-year leaver settlement.
calc_daily_worker_tax
Calculates daily-worker withholding.
list_employer_duties
Lists employer duties by worker count.

What it does

NHIS report forms
Finds the branch and builds loss or acquisition report PDFs from a local people file.
Contract design and check
Splits wages into items, reviews a written contract and saves xlsx, hwpx or PDF.
Wage calculators
Minimum wage, severance, notice pay, shutdown allowance, holiday pay and more with legal basis.
Leave and tax
Annual leave accrual, exit settlement, retirement tax and mid-year settlement.
Fax and SMS
Popbill tools send only with confirm true, through your own account.
Switchable groups
LLG_MCP_GROUPS or --groups enables just the bundles you need.

Good for

  • Find the insurance branch and fax number for a workplace
  • Check whether a contract's wage items are in order
  • Calculate severance and unused leave pay at resignation
  • Test whether a 3.3% contractor looks like an employee

Pricing

Free

No account or token required for the tools per the site; Popbill messaging uses your own account

Prices change. Check yellowenvelope.kr before you buy.

노동 업무 도구 (k-labor) FAQ

Where does it run?

Locally over stdio with npx -y k-labor mcp; the site also offers some bundles as a remote URL.

Does it send resident numbers to the AI?

The README and site say people lists are read from a local file and resident numbers are not sent to the chat.

Do I need any keys?

Only for optional features: Popbill credentials for fax and SMS, and a law API ID for work-rules lookups.

Can I enable only some tools?

Yes, by group names such as nhis, calc, contract.

Is 노동 업무 도구 (k-labor) free?

Yes. 노동 업무 도구 (k-labor) is free to use.

How do I add 노동 업무 도구 (k-labor) to Claude Code?

Run this command in your terminal: claude mcp add k-labor --env POPBILL_SECRET_KEY='<POPBILL_SECRET_KEY>' -- npx -y k-labor

What are the best alternatives to 노동 업무 도구 (k-labor)?

The closest alternatives to 노동 업무 도구 (k-labor) are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, NY LLC Publication (FileMyPublication) and Quantivex Research.

Alternatives to 노동 업무 도구 (k-labor)

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  5. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  6. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments