Korean Tax Calc MCP
Korean taxes computed by code and not by a model: 109 tools for corporate, income and VAT tax with a statute in the answer
- 98 ★ on the repository
- Last commit
Extended access
Why this level
- Results are a review aid and do not replace a tax accountant, and an input error produces a wrong tax
- Three PDF tools send document content to the Upstage API when `UPSTAGE_API_KEY` is set
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/korean-tax-calc-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Results are a review aid and do not replace a tax accountant, and an input error produces a wrong tax
- Three PDF tools send document content to the Upstage API when `UPSTAGE_API_KEY` is set
This is third-party code. Review the repository files before installing.
What it does
An MCP server for tax calculations under the law of the Republic of Korea. The agent passes the year, amounts and ledger items, and the server validates input, takes rates and limits from the tables for that year and computes in statute order. The answer returns the tax, intermediate steps, a judgment for each item, the tax adjustment with its disposition type and the statute reference. Tools are grouped by task: corporate tax (21), income, withholding, transfer and inheritance (24), VAT, penalties, limitation and refund claims (16), converting ledgers into tax adjustments (15), share and property valuation (7) and tax audit checks (9). For years without a table the server stops and estimates nothing. `export_workbook` builds an Excel file with formulas between forms, and three PDF tools call Upstage Solar when `UPSTAGE_API_KEY` is set.
Who it is for. Accountants and tax consultants with Korean clients who need an agent to check calculations and prepare draft forms.
Good fit when
- Corporate tax for 2025 must be computed from a taxable base showing the rate and statute
- A tax adjustment is needed from a profit and loss statement and ledger, with expenses lacking supporting documents selected
- Interest on a loan to a shareholder needs an imputed interest calculation by issue and repayment dates
- Retirement income tax and an underreporting penalty need an exact calculation with dates
- An Excel workbook of forms must be built with formulas so it can be checked by hand
Not a fit when
- Tax advice or filing for a client is needed: the service does neither and does not replace a certified tax accountant
- A calculation is needed for a year outside the supported 2016–2026 range: the server will stop
- Taxes of another country: the server only knows Korean law
Example request
Compute corporate tax for 2025 on a taxable base of 500 million won and show the bracket rates and the statute articleMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
LAW_OCsecret- Korea Ministry of Government Legislation OC key for two tax audit tools.
UPSTAGE_API_KEYsecret- Upstage key for the three PDF tools.
Limitations
Results are a review aid and not tax advice, so check them with a tax accountant before filing. Years 2016 to 2026 are supported for corporate and income tax and VAT periods from 2016 to 2026, and local income tax is not computed. Facts that need judgment, such as the number of houses or related parties, are taken as entered. There is no tool for mergers or splits. It runs through `uvx`, no keys are needed, `LAW_OC` and `UPSTAGE_API_KEY` are optional. Documentation and tool descriptions are in Korean and English.
How to disable. Run `claude mcp remove korean-tax-calc` or remove the `korean-tax-calc` entry from `mcpServers` in the client config.
FAQ
How do I install Korean Tax Calc MCP in Claude Code?
With `claude mcp add korean-tax-calc -- uvx korean-tax-calc-mcp`. Use `uvx --refresh korean-tax-calc-mcp` for the latest version and `uvx korean-tax-calc-mcp@0.28.1` to pin one.
Are API keys needed?
No, calculations work without keys. `LAW_OC` for two tax audit tools and `UPSTAGE_API_KEY` for three PDF tools are optional.
Does the server use generative AI?
Not in 105 of the 109 tools, as calculations run in code. Three PDF tools call Upstage Solar when the key is set and mark it in the answer.
What about years missing from the tables?
The server stops and asks for data: it does not guess a calculation for a year without a table.
What license applies?
MIT.
Discussion
No questions or reviews yet.
Related
MCP serversHometax Doum is six free skills for the Korean Hometax tax portal: VAT, income tax, tax invoices and receipts.
MCP server for Korean company filings from OpenDART: 83 API methods in 15 tools, XBRL parsing and HWP and PDF attachments
MCP server for Korean stock analysis: DART disclosures and financials, daily prices and issuer data from KRX
Offline Russian tax calculator MCP server: VAT, simplified tax, sole proprietor contributions, income tax, patent and penalties with Tax Code references
An MCP server for Brazilian tax work: counterparty checks by CNPJ and parsing of NF-e invoices and SPED filings
MCP connects AI assistants to jurisdiction-specific tax references with sources for rates, thresholds and deadlines.
README in short
The way it works with a flow chart, the tax adjustment order with examples, a list of 109 tools by group, a recommended agent prompt, per-tool limits and legal notices.