# SooTool

SooTool runs deterministic Decimal math for taxes, payroll, and finance, returning calculation traces with audit receipts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8 repo stars
- Author: JinHo-von-Choi
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/JinHo-von-Choi/SooTool
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/sootool

## What it does

Language models tend to hallucinate numbers around progressive tax brackets and rounding rules. This MCP server offloads mathematical operations to an engine that uses strings and Python `Decimal`, preventing precision loss from floating-point math.

Statutory rates and formulas live in YAML policy files tracking legislative effective dates. Passing an `as_of` date parameter tells the tool to apply the legal rules active on that date. For complex jobs, `core.batch` processes up to 500 operations in parallel, while `core.pipeline` links multi-step workflows. Every response includes a formula trace and a cryptographic receipt for verification.

The server requires Python 3.12 or newer and uses `uvx` for execution. Environments lacking Python 3.12 will fail to run it.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add sootool -- uvx sootool
```
uvx runs the command named after the package; if the README names another one, use uvx --from sootool <command>

### Codex

**Platform CLI**
```bash
codex mcp add sootool -- uvx sootool
```
uvx runs the command named after the package; if the README names another one, use uvx --from sootool <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "sootool": {
            "command": "uvx",
            "args": [
                "sootool"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from sootool <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "sootool": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "sootool"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from sootool <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add sootool uvx sootool
```
uvx runs the command named after the package; if the README names another one, use uvx --from sootool <command>

## When to use it
- compute Korean income tax using official bracket policies
- evaluate NPV or financial formulas with exact Decimal precision
- execute parallel calculations up to 500 items via core.batch
- chain multi-stage accounting workflows using core.pipeline

## Example prompts
- Calculate 2026 Korean income tax on a taxable base of 50000000
- Find the NPV for a discount rate of 0.08 and cash flows -1000, 300, 400, 500, 200
- Chain salary calculation steps using core.pipeline

## Similar
- [openaccountants](https://affpapa.org/en/nevibecode/mcp/info-ood9-openaccountants.md) — MCP server · 253 installs
- [tax-penalty-calc](https://affpapa.org/en/nevibecode/skills/tax-penalty-calc.md) — skill · 433 installs
- [Contazz AutoPilot](https://affpapa.org/en/nevibecode/mcp/contazz-autopilot.md) — MCP server · 139 installs
- [multi-entity](https://affpapa.org/en/nevibecode/skills/multi-entity.md) — skill · 462 installs
- [invoice-tax-checklist](https://affpapa.org/en/nevibecode/skills/invoice-tax-checklist.md) — skill · ★ 12746 repo stars
- [tax-prep](https://affpapa.org/en/nevibecode/skills/ilyautov-tax-prep.md) — skill · ★ 38 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
