# SooTool

> SooTool is an MCP server for finance and payments. Decimal-exact Korean tax, payroll, finance and statistics maths for LLM tool use. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/jinho-von-choi/sootool
- **MCP Registry name:** io.github.JinHo-von-Choi/sootool
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add sootool -- uvx sootool
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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.

## 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.

## Alternatives

- [Korea Tax Calculator](https://ai-powered.com/mcp/korea-tax-calculator): Korea Tax Calculator is an open-source MCP server for finance and payments.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Cuelark Tools](https://ai-powered.com/mcp/cuelark-tools): Cuelark Tools is a free MCP server for developer tools.
- [노동 업무 도구 (k-labor)](https://ai-powered.com/mcp/k-labor): 노동 업무 도구 (k-labor) is a free MCP server for legal and government.
- [GlanceDesk](https://ai-powered.com/mcp/glancedesk): GlanceDesk is a free MCP server for finance and payments.
- [Canli Quant](https://ai-powered.com/mcp/canli-quant): Canli Quant is an open-source MCP server for finance and payments.
- [CalculatorLib](https://ai-powered.com/mcp/calculatorlib): CalculatorLib is a freemium MCP server for productivity.
- [Irfan Aslam Tools](https://ai-powered.com/mcp/irfan-aslam-tools): Irfan Aslam Tools is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/sootool
