Skip to content
MCP server

SooTool

Decimal-exact Korean tax, payroll, finance and statistics maths for LLM tool use

Runs locally
Install
Platforms
CLI, self-hosted
Runs
Locally
Version
0.3.1
Listing updated
4 days ago

Similar MCP servers

About SooTool

SooTool is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Language models write plausible numbers rather than computing them. In the author's 20-problem test dated 2026-04-24, SooTool got all 20 exact, while gemini-3-pro-preview got 12, claude-opus-4-7 9 and gpt-5.4 5. Typical misses were income-tax bracket edges, long-term holding deductions, VAT rounding and AC impedance.

Everything is computed in Decimal, with inputs as strings. Statutory values such as rates and deductions live in YAML policy files with the article and effective date, and an as_of date picks the version in force that day. Every response carries a trace of formula, inputs and steps, and an integrity receipt that sootool receipt verify can re-run, optionally signed with an Ed25519 key.

The README counts 276 base tools across 18 domains plus 10 admin tools, with batch of up to 500 items and pipelines of up to 50 steps. It needs Python 3.12 or newer.

Install

Run in a terminal

claude mcp add sootool -- uvx sootool

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "sootool": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "sootool"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "sootool": {
      "command": "uvx",
      "args": [
        "sootool"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "sootool": {
      "command": "uvx",
      "args": [
        "sootool"
      ]
    }
  }
}

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

Tools this server provides (9)

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

tax.kr_income
Computes Korean income tax from taxable income and year.
finance.npv
Net present value of cash flows.
core.batch
Runs up to 500 independent calculations in parallel.
core.pipeline
Chains steps, feeding results forward.
core.solve_for
Finds the input that yields a target result.
core.compare
Tabulates scenarios against a baseline.
core.explain
Explains a calculation in Korean or English.
payroll.kr_salary
Payroll calculation for Korean salaries.
accounting.vat_extract
Separates VAT from a gross amount.

What it does

Decimal arithmetic
No floating-point error in calculations.
Dated policy files
Rates carry legal citations and effective dates.
Calculation trace
Each result shows formula, inputs and steps.
Verifiable receipts
Hashes allow re-running a calculation.
Batch and pipeline
Run many calculations or chain steps.
Rounding control
Caller picks the rounding mode and decimals.

Good for

  • Compute Korean income tax for a given year
  • Run payroll for hundreds of staff in one batch
  • Extract VAT from a list of invoices
  • Compare investment scenarios by NPV and IRR

Pricing

Pricing unknown

Free PyPI package

SooTool FAQ

How many tools?

276 base tools plus 10 admin tools across 18 domains.

How are numbers passed?

As strings or Decimals, never floats.

Which transports?

stdio, Streamable HTTP and Unix, with SSE deprecated.

What Python is needed?

3.12 or newer.

How do I add SooTool to Claude Code?

Run this command in your terminal: claude mcp add sootool -- uvx sootool

What are the best alternatives to SooTool?

The closest alternatives to SooTool are Korea Tax Calculator, OIYO Korea Calculators, Cuelark Tools, 노동 업무 도구 (k-labor) and GlanceDesk.

Where this comes from

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

How AIPoweredBot checks servers