# Korea Tax Calculator

> Korea Tax Calculator is an open-source MCP server for finance and payments. Korean tax calculations in code with statutory citations: corporate, VAT and withholding. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/upstageai/korean-tax-calc-mcp
- **MCP Registry name:** io.github.UpstageAI/korean-tax-calc-mcp
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [legal and government](https://ai-powered.com/categories/legal-and-government)
- **Listing updated:** 2026-11-18

## About

Tax maths is a place where models often slip, so this server does the arithmetic in code and attaches the statutory basis to each result. It reports 133 tools, of which 123 run without generative AI; only three PDF tools use an Upstage key, and two market-data lookups fetch public KRX and V-World data. The registry entry counts 126 tools, so the number may vary by version.

It validates inputs first and refuses unknown or missing items, then applies per-year tables (corporate and income tax 2016 to 2026, VAT from the first half of 2016 to the second half of 2026). For a year without a table it stops rather than estimate. Tools cover adjustments such as entertainment expenses, deemed interest on loans to officers, donation limits and company cars, plus international transfer pricing, then aggregate into returns.

export_workbook builds a review spreadsheet with statutory-form sheets for corporate tax, VAT and withholding. The README says it is a calculation aid, not a filing service. A companion server, korean-tax-mcp, handles statute and interpretation lookups. The documentation is mainly in Korean.

## Features

- **Code-based calculation:** Computes tax in code, with 123 of the tools needing no generative AI.
- **Statutory citations:** Attaches the relevant article and caveats to each result.
- **Year-specific tables:** Uses per-year rates and limits, and halts when a year has no table.
- **Adjustment tools:** Covers entertainment expenses, deemed interest, donations, bad debt and business cars.
- **Return aggregation:** Builds corporate tax, VAT and withholding return figures from adjustment items.
- **Review workbook:** Exports an Excel file with statutory-form sheets and calculation basis.
- **Tool finder:** Lets you ask in plain words which tool fits a question.

## Good for

- Compute corporate tax on a stated taxable base
- Calculate deemed interest on an officer loan
- Check an entertainment-expense limit for a fiscal year
- Prepare a VAT return draft from ledger items
- Test whether a transfer price falls in an arm's-length range

## Install

### Claude Code (Terminal)

```sh
claude mcp add korean-tax-calc-mcp -- uvx korean-tax-calc-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "korean-tax-calc-mcp": {
      "command": "uvx",
      "args": [
        "korean-tax-calc-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "korean-tax-calc-mcp": {
      "command": "uvx",
      "args": [
        "korean-tax-calc-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "korean-tax-calc-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "korean-tax-calc-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "korean-tax-calc-mcp": {
      "command": "uvx",
      "args": [
        "korean-tax-calc-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "korean-tax-calc-mcp": {
      "command": "uvx",
      "args": [
        "korean-tax-calc-mcp"
      ]
    }
  }
}
```

## Tools

- `corporate_tax`: Corporate tax computed from the taxable base
- `entertainment_limit`: Entertainment expense limit
- `deemed_interest`: Deemed interest on loans to officers
- `donation_limit`: Donation deduction limit
- `business_car_expense`: Business passenger car expenses
- `bad_debt_allowance`: Bad debt allowance limit
- `income_adjustment_total`: Aggregates adjustment items into income
- `vat_return_general`: General VAT return figures
- `withholding_return`: Withholding return figures
- `export_workbook`: Review workbook with statutory forms
- `find_tool`: Finds the right tool from a plain-language question

## FAQ

### Does it need an API key?

No. LAW_OC and UPSTAGE_API_KEY are optional, for statute lookups and PDF table extraction.

### What if a tax year isn't supported?

It stops instead of estimating.

### Does it file returns?

No. The README says it shows calculations for reference and is not an agent for preparing or filing returns.

### How do I install it?

Run claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp.

### Is Korea Tax Calculator free?

Yes. Korea Tax Calculator is open source, so you can use and self-host it for free.

### How do I add Korea Tax Calculator to Claude Code?

Run this command in your terminal: claude mcp add korean-tax-calc-mcp -- uvx korean-tax-calc-mcp

### What are the best alternatives to Korea Tax Calculator?

The closest alternatives to Korea Tax Calculator are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Data Ny and Crypto Feeds.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Data Ny](https://ai-powered.com/mcp/data-ny): Data Ny is a freemium MCP server for legal and government.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Datos Gob Es](https://ai-powered.com/mcp/datos-gob-es): Datos Gob Es is a freemium MCP server for legal and government.
- [Datos Cl](https://ai-powered.com/mcp/datos-cl): Datos Cl is a freemium MCP server for legal and government.
- [Cipo](https://ai-powered.com/mcp/cipo): Cipo is a freemium MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/korea-tax-calculator
