Skip to main content
Glama
finance-calc-mcp

finance-calc-mcp

finance-calc-mcp

Business, financial, and tax calculator — MCP server + CLI.

Single command install. No cloning required.


Install

# Run directly (no install needed)
uvx finance-calc-mcp calc "185000 * 0.21"

# Or install permanently
uv tool install finance-calc-mcp
# or: pip install finance-calc-mcp

Related MCP server: Arc & Ledger Tax Tools MCP server

Use as an MCP Server

Prerequisites

Install uv if you don't have it:

curl -LsSf https://astral.sh/uv/install.sh | sh

Restart your terminal after installing, then confirm uvx works:

uvx --version

Claude Desktop

Edit your Claude Desktop config:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS:

{
  "mcpServers": {
    "finance-calculator": {
      "command": "/bin/bash",
      "args": ["-lc", "uvx finance-calc-mcp"]
    }
  }
}

Claude Desktop on macOS is a GUI app that doesn't inherit your shell PATH. The /bin/bash -lc wrapper runs a login shell so uvx is found regardless of where uv was installed.

Windows:

{
  "mcpServers": {
    "finance-calculator": {
      "command": "uvx",
      "args": ["finance-calc-mcp"]
    }
  }
}

Restart Claude Desktop. The finance tools will appear automatically.

Claude Code (terminal)

claude mcp add finance-calculator -- uvx finance-calc-mcp

Other MCP Clients

Any MCP-compatible client can launch the server:

uvx finance-calc-mcp

With no arguments, it starts in MCP server mode (stdio transport).


MCP Tools

When connected as an MCP server, Claude gets these tools:

calculate

Evaluate a financial/business math expression. Supports +, -, *, /, **, %, parentheses, and functions: round(), abs(), max(), min(), sum(), sqrt(), log(), floor(), ceil(), pow().

Parameter

Type

Required

Description

expression

string

yes

Math expression to evaluate

gross_margin

Calculate gross margin, gross profit, and markup from revenue and COGS.

Parameter

Type

Required

Description

revenue

number

yes

Total revenue

cogs

number

yes

Cost of goods sold

us_income_tax_estimate

Estimate 2024 US federal income tax for individuals, with bracket-by-bracket detail.

Parameter

Type

Required

Description

taxable_income

number

yes

Taxable income in USD

filing_status

string

yes

single, married_jointly, married_separately, or head_of_household

self_employment_tax

Calculate self-employment (SE) tax and deductible half for Schedule SE. Covers Social Security, Medicare, and the additional Medicare surtax above $200k.

Parameter

Type

Required

Description

net_self_employment_income

number

yes

Net profit from self-employment

depreciation

Calculate a depreciation schedule (straight-line or double-declining balance).

Parameter

Type

Required

Description

asset_cost

number

yes

Asset purchase price

useful_life

number

yes

Useful life in years

salvage_value

number

no

Salvage/residual value (default 0)

method

string

no

straight_line (default) or double_declining

payroll_summary

Estimate employer payroll costs and employee net pay for a given gross salary. Covers FICA (Social Security + Medicare), FUTA, and SUTA.

Parameter

Type

Required

Description

gross_annual_salary

number

yes

Annual gross salary

state_suta_rate

number

no

State unemployment rate % (default 2.7)

loan_amortization

Generate a loan amortization summary: monthly payment, total interest paid, and optionally a full month-by-month schedule.

Parameter

Type

Required

Description

principal

number

yes

Loan principal

annual_rate_pct

number

yes

Annual interest rate as percent (e.g. 6.5)

term_years

number

yes

Loan term in years

show_schedule

boolean

no

Return full amortization table (default false)

percent_change

Calculate percent change between two values.

Parameter

Type

Required

Description

old_value

number

yes

Starting/original value

new_value

number

yes

Ending/new value

break_even

Calculate break-even units and revenue given fixed costs, price per unit, and variable cost per unit.

Parameter

Type

Required

Description

fixed_costs

number

yes

Total fixed costs

price_per_unit

number

yes

Selling price per unit

variable_cost_per_unit

number

yes

Variable cost per unit

currency_format

Format a number as a USD currency string.

Parameter

Type

Required

Description

amount

number

yes

Amount to format

decimals

integer

no

Decimal places (default 2)


CLI Usage

Every MCP tool is also available as a CLI command.

# Evaluate any expression
finance-calc-mcp calc "185000 * 0.21"
finance-calc-mcp calc "(850000 - 612000) / 850000 * 100"

# Gross margin
finance-calc-mcp margin 850000 612000

# 2024 US federal income tax estimate
finance-calc-mcp tax 185000 single
finance-calc-mcp tax 320000 married_jointly

# Self-employment tax
finance-calc-mcp se-tax 95000

# Loan amortization (add --schedule for full table)
finance-calc-mcp amortize 400000 6.5 30
finance-calc-mcp amortize 400000 6.5 30 --schedule

# Payroll (optional: state SUTA rate %)
finance-calc-mcp payroll 95000
finance-calc-mcp payroll 95000 3.4

# Depreciation (straight-line default, or double_declining)
finance-calc-mcp depreciation 50000 5
finance-calc-mcp depreciation 50000 5 5000 --method double_declining

# Break-even analysis
finance-calc-mcp break-even 120000 49.99 18.50

# Percent change
finance-calc-mcp pct-change 1200000 1485000

# Format as currency
finance-calc-mcp format 1234567.89

Example Output

$ finance-calc-mcp tax 185000 single

2024 Federal Income Tax Estimate (single)
Taxable Income:   $185,000.00
Federal Tax:      $37,442.50
Effective Rate:   20.24%

Bracket Detail:
  10%  $0.00 – $11,600.00:  $11,600.00 taxed → $1,160.00
  12%  $11,600.00 – $47,150.00:  $35,550.00 taxed → $4,266.00
  22%  $47,150.00 – $100,525.00:  $53,375.00 taxed → $11,742.50
  24%  $100,525.00 – $191,950.00:  $84,475.00 taxed → $20,274.00
$ finance-calc-mcp amortize 400000 6.5 30

Loan Amortization Summary
Principal:       $400,000.00
Rate:            6.500% APR
Term:            30 years (360 months)
Monthly Payment: $2,528.27
Total Paid:      $910,177.52
Total Interest:  $510,177.52
Interest/Dollar: 127.54%

License

MIT

Available Tools

10 tools
break_evenA
Read-onlyIdempotent

Calculate break-even units and revenue given fixed costs, price per unit, and variable cost per unit.

Inputs: fixed_costs (required), price_per_unit (required), variable_cost_per_unit (required).

calculateA
Read-onlyIdempotent

Evaluate a financial/business math expression. Supports +, -, *, /, **, %, parentheses, and common functions: round(), abs(), max(), min(), sum(), sqrt(). Examples: '125000 * 0.21', '(85000 - 12000) / 12', 'round(1234567.89, -3)'

Inputs: expression (required).

currency_formatA
Read-onlyIdempotent

Format a number as USD currency string (or other locale).

Inputs: amount (required), decimals.

depreciationA
Read-onlyIdempotent

Calculate straight-line or MACRS-style depreciation schedule.

Inputs: asset_cost (required), useful_life (required), method, salvage_value.

gross_marginA
Read-onlyIdempotent

Calculate gross margin, gross profit, and markup from revenue and COGS.

Inputs: cogs (required), revenue (required).

loan_amortizationA
Read-onlyIdempotent

Generate a loan amortization summary (monthly payment, total interest, full schedule).

Inputs: principal (required), term_years (required), annual_rate_pct (required), show_schedule.

payroll_summaryA
Read-onlyIdempotent

Estimate employer payroll costs and employee net pay for a given gross salary. Covers FICA (SS + Medicare), FUTA, and SUTA estimate.

Inputs: gross_annual_salary (required), state_suta_rate.

percent_changeB
Read-onlyIdempotent

Calculate percent change, markup, or margin between two values.

Inputs: new_value (required), old_value (required).

self_employment_taxA
Read-onlyIdempotent

Calculate self-employment (SE) tax and deductible half for Schedule SE.

Inputs: net_self_employment_income (required).

us_income_tax_estimateB
Read-onlyIdempotent

Estimate 2024 US federal income tax (individuals). Filing statuses: single, married_jointly, married_separately, head_of_household.

Inputs: filing_status (required), taxable_income (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation3/5

    Most tools target distinct financial calculations, but gross_margin and percent_change both compute margin/markup, creating ambiguity. The general calculate tool also overlaps with simple computations, though it's clearly a catch-all.

    Naming Consistency2/5

    Tool names follow no consistent verb_noun pattern; some are nouns (depreciation, loan_amortization), some are verb phrases (calculate), and some are compound terms (us_income_tax_estimate). While all use snake_case, the structural inconsistency makes it harder to predict tool names.

    Tool Count5/5

    10 tools is well-scoped for a finance calculator, covering a broad range of common financial calculations without excessive redundancy. Each tool has a clear domain purpose.

    Completeness4/5

    The toolset covers profitability, tax, depreciation, payroll, loans, break-even, percentage changes, and formatting. Minor gaps like NPV/IRR or compound interest exist, but core financial analysis needs are well covered.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      A public, no-auth remote MCP server that exposes Arc & Ledger's free tax calculators and intake funnel as tools inside AI assistants. Provides tools for IRS notice explanation, FBAR/FATCA, LLC vs S-Corp comparison, quarterly tax estimates, and more.
      -
    • A
      license
      A
      quality
      D
      maintenance
      A personal finance and business economics MCP server that provides math-backed answers to financial questions, including investment growth, loan amortization, debt payoff strategies, and tax estimation, all computed locally without API keys or network calls.
      11
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server exposing UK financial adviser calculations (tax, IHT, pensions, portfolios) to any MCP-capable client.
      6
      MIT