Skip to content
MCP server

Korea Tax Calculator

Korean tax calculations in code with statutory citations: corporate, VAT and withholding

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.65.0
Listing updated
today

Similar MCP servers

About Korea Tax Calculator

Korea Tax Calculator is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "korean-tax-calc-mcp": {
      "command": "uvx",
      "args": [
        "korean-tax-calc-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "korean-tax-calc-mcp": {
      "command": "uvx",
      "args": [
        "korean-tax-calc-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (11)

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

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

What it does

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

Pricing

Open source

Korea Tax Calculator 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.

How AIPoweredBot checks servers