finance-calc-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@finance-calc-mcp what's the monthly payment for a $200k mortgage at 6% for 30 years?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpRelated 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 | shRestart your terminal after installing, then confirm uvx works:
uvx --versionClaude Desktop
Edit your Claude Desktop config:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%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 -lcwrapper runs a login shell souvxis found regardless of whereuvwas 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-mcpOther MCP Clients
Any MCP-compatible client can launch the server:
uvx finance-calc-mcpWith 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 |
| string | yes | Math expression to evaluate |
gross_margin
Calculate gross margin, gross profit, and markup from revenue and COGS.
Parameter | Type | Required | Description |
| number | yes | Total revenue |
| 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 |
| number | yes | Taxable income in USD |
| string | yes |
|
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 |
| number | yes | Net profit from self-employment |
depreciation
Calculate a depreciation schedule (straight-line or double-declining balance).
Parameter | Type | Required | Description |
| number | yes | Asset purchase price |
| number | yes | Useful life in years |
| number | no | Salvage/residual value (default 0) |
| string | no |
|
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 |
| number | yes | Annual gross salary |
| 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 |
| number | yes | Loan principal |
| number | yes | Annual interest rate as percent (e.g. 6.5) |
| number | yes | Loan term in years |
| boolean | no | Return full amortization table (default false) |
percent_change
Calculate percent change between two values.
Parameter | Type | Required | Description |
| number | yes | Starting/original 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 |
| number | yes | Total fixed costs |
| number | yes | Selling price per unit |
| number | yes | Variable cost per unit |
currency_format
Format a number as a USD currency string.
Parameter | Type | Required | Description |
| number | yes | Amount to format |
| 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.89Example 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 toolsbreak_evenARead-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).
calculateARead-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_formatARead-onlyIdempotent
Format a number as USD currency string (or other locale).
Inputs: amount (required), decimals.
depreciationARead-onlyIdempotent
Calculate straight-line or MACRS-style depreciation schedule.
Inputs: asset_cost (required), useful_life (required), method, salvage_value.
gross_marginARead-onlyIdempotent
Calculate gross margin, gross profit, and markup from revenue and COGS.
Inputs: cogs (required), revenue (required).
loan_amortizationARead-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_summaryARead-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_changeBRead-onlyIdempotent
Calculate percent change, markup, or margin between two values.
Inputs: new_value (required), old_value (required).
self_employment_taxARead-onlyIdempotent
Calculate self-employment (SE) tax and deductible half for Schedule SE.
Inputs: net_self_employment_income (required).
us_income_tax_estimateBRead-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
Scored across 10 tools
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.
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.
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.
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
MCP server for Financial Modeling Prep API with 250+ financial data tools
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
MCPCalc gives agents access to a comprehensive library of calculators spanning finance, math, health, construction, engineering, food, automotive, and more. It includes a full Computer Algebra System (CAS) and a grid-based Spreadsheet calculator.
44 calculators for AI agents: US tax, finance, business + an MCP engineering & security suite.
Related MCP Servers
- FlicenseAqualityDmaintenanceProvides precise decimal arithmetic and Excel-style rounding for accounting and tax calculations via MCP protocol.13 npm-
- FlicenseNot gradedqualityBmaintenanceA 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.-
- AlicenseAqualityDmaintenanceA 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.11MIT
- AlicenseAqualityDmaintenanceMCP server exposing UK financial adviser calculations (tax, IHT, pensions, portfolios) to any MCP-capable client.6MIT