Korea Tax Calculator logo

Korea Tax Calculator

Calculates Korean corporate, income, withholding, VAT, penalty, and tax-adjustment amounts with statutory citations.

Install Korea Tax Calculator

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "korea-tax-calculator": {
      "command": "uvx",
      "args": [
        "korean-tax-calc-mcp"
      ]
    }
  }
}

Settings โ†’ Developer โ†’ Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-testedโ€” the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Korea Tax Calculator MCP server provides code-based Korean tax calculations and tax-audit judgments with statutory citations in each result. It accepts structured values such as tax bases, dates, transaction types, rates, and ledger items, then returns amounts, intermediate calculations, judgments, and applicable provisions. Use it for Korean corporate tax, income tax, withholding, VAT, penalties, tax adjustments, and related-party assessments when a year-specific result is needed. The calculation tools run locally without an API key, while selected PDF extraction tools can use Upstage through an optional key.

Use cases

  • Calculate a corporationโ€™s Korean income tax from its fiscal-year tax base
  • Estimate withholding for domestic or nonresident payees
  • Check VAT input-tax deduction and deemed-supply treatment
  • Review ledger items for tax adjustments and income disposition
  • Assess penalties, carryforwards, and tax assessment deadlines

Key features

  • Year-specific Korean tax rates and limits
  • Corporate, income, withholding, and VAT calculations
  • Tax-adjustment and related-party judgments
  • Structured intermediate calculations and formulas
  • Statutory citations in results
  • Optional PDF table extraction

Tools85

What Korea Tax Calculator lets your agent do. Expand a tool for its parameters.

Verified live~35.8k tokens of context

Security & health

What it can reach and how reliably it runs โ€” from our own checks, not the maintainerโ€™s claims.

ActiveLast checked

Recent health check succeeded.

14/14 checks healthy over the last 33d

What it can do

From the 85 tools this server returned when we ran it; 73 declare their own safety hints.

Read-only tools ยท 85
Network at startup2 connections
Files written at startup13

Observed 2026-10-28 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 3d ago via OSV.dev ยท korean-tax-calc-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks โ€” not a rating.

GitHub stars100Stargazers on the source repository.
Last commitTodayMost recent push to the default branch.
Tools exposed85Callable tools this server registers over MCP.

How Korea Tax Calculator works

What Korea Tax Calculator MCP server does

Korea Tax Calculator covers Korean tax calculations and rule-based tax judgments across corporate tax, income tax, withholding, VAT, penalties, tax adjustments, and selected investigation checks. Inputs are generally structured JSON values: amounts in won, fiscal or income years, dates, transaction categories, business classifications, and ledger-level items.

Results can include the calculated tax or adjustment, intermediate figures, applicable rates and limits, item-level decisions, income treatments, carryforward amounts, and statutory references. Examples include corporate income tax, foreign tax credits, entertainment expense limits, deemed interest, loss carryforward limits, minimum tax, withholding, retirement income tax, VAT input-tax treatment, deemed supplies, bad-debt credits, and supply timing.

How it works

The server validates required fields and supported categories before calculating. Year-specific tax rates, deduction limits, and other parameters are selected from its coded tables. Calculations follow the applicable statutory sequence rather than asking a generative model to estimate a result. When a required fact or supported year is unavailable, the tool can return the information needed for a determination instead of producing an estimate.

Outputs are designed to show both the answer and how it was reached. Depending on the tool, that may include formulas, rate selection, allocation steps, item-by-item conclusions, tax adjustments, income disposition, carryforward treatment, or the legal provision used.

Setup and configuration

The server can be launched with uvx:

Terminal
claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp

An equivalent Claude MCP configuration uses korean-tax-calc-mcp as the command and does not require environment variables for the calculation tools. uvx --refresh korean-tax-calc-mcp refreshes the cached package. A package version can also be pinned when reproducibility is needed.

LAW_OC is an optional Law.go.kr lookup value used by two tax-investigation judgment tools. UPSTAGE_API_KEY is optional for PDF table extraction; with it, selected PDF tools send document content to Upstage. Without that key, local PDF text extraction is available for the supported workflow.

Tools and capabilities

  • Calculate corporate and comprehensive income tax from year-specific tax bases.
  • Determine foreign tax credits, withholding tax, retirement income tax, minimum tax, penalties, and assessment limitation dates.
  • Evaluate corporate tax adjustments for entertainment expenses, deemed interest, business vehicles, donations, bad debts, thin capitalization, and non-business interest.
  • Calculate VAT deemed rent, input-tax deductions, deemed supplies, deemed input credits, common-input allocation, simplified-taxpayer liability, card-sales credits, bad-debt credits, and supply timing.
  • Assess related-party transactions, unfair transaction thresholds, loss carryforward limits, and other rule-based judgments.
  • Return statutory citations and calculation details with results.

Limitations and notes

Supported periods depend on the tool. The stated coverage is generally 2016โ€“2026 for corporate and income tax, and 2016 first period through 2026 second period for VAT; unsupported periods stop with an error rather than an extrapolated result. Local and provincial income tax amounts may be separate from the returned national-tax calculation.

Some calculations require facts that must be supplied directly, such as related-party evidence, country-level foreign income, movement dates, business-use ratios, or ledger classifications. Specific exclusions apply to certain tools, including some transitional retirement-tax cases, selected foreign-tax-credit allocations, and unsupported VAT transaction types.

Results are reference calculations, not tax representation, filing services, or professional tax advice. Review the cited legislation and confirm facts with a qualified Korean tax professional before relying on an output for filing, an audit, or a dispute.

Written by AllMCPs with AI assistance from the projectโ€™s README and listing data. How we build listings

Reviews

No reviews yet โ€” be the first to share how it worked for you.

Frequently Asked Questions about Korea Tax Calculator

Korea Tax Calculator is an MCP server that connects AI clients to code-based Korean tax calculations and tax-rule judgments. Its main tools calculate corporate tax, income tax, withholding, VAT, penalties, tax adjustments, related-party assessments, and other statutory amounts, returning intermediate results and citations to Korean legal provisions.

Install it by adding `uvx korean-tax-calc-mcp` as an MCP server command, for example with `claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp`. The calculation tools do not require an API key. Use `uvx --refresh korean-tax-calc-mcp` to refresh the cached package.

Yes, Korea Tax Calculator can be configured for Claude Desktop through its MCP server configuration. Use `uvx` as the command and `korean-tax-calc-mcp` as the argument. Claude Code can also add it with the documented `claude mcp add` command.

No, the calculation and judgment tools run without an API key. `LAW_OC` is optional for selected law lookups, and `UPSTAGE_API_KEY` is optional for PDF table extraction. When the Upstage key is used, supported PDF content is sent to the Upstage API.

Related MCP servers

Add a badge to your READMEShow itโ€™s listed โ€” live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewKorea Tax Calculator AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/korea-tax-calculator?style=directory)](https://allmcps.com/mcp/korea-tax-calculator)
HTML Embed
<a href="https://allmcps.com/mcp/korea-tax-calculator"><img src="https://allmcps.com/api/badge/korea-tax-calculator?style=directory" alt="Korea Tax Calculator on AllMCPs" /></a>