SooTool
Decimal-exact Korean tax, payroll, finance and statistics maths for LLM tool use
- 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 sootoolAdd to claude_desktop_config.json
{
"mcpServers": {
"sootool": {
"command": "uvx",
"args": [
"sootool"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"sootool": {
"command": "uvx",
"args": [
"sootool"
]
}
}
}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.