mcpField
C
Calcuris

Calcuris

Local
calcuris.comFinance0Updated 16w ago
RepositoryVisit website

About Calcuris

Calcuris is an MCP server for tax calculations across the US, Canada, Australia, and the UK. It computes locally from published tax data and returns source notes and calculator links, for people estimating taxes and take-home pay.

Key features

  1. 01US income and paycheck tax estimates
  2. 02US state property tax calculations
  3. 03Canadian federal and provincial tax
  4. 04Australian income tax and stamp duty
  5. 05UK dividend tax calculations
  6. 06Source notes and calculator references

Use cases

  1. 01Estimate US take-home pay by pay period
  2. 02Compare Canadian tax across provinces
  3. 03Calculate Australian stamp duty
  4. 04Estimate UK dividend tax

MCP support

Exposes tax calculation tools to MCP clients, including income, paycheck, property, stamp duty, and dividend tax calculations. Calculations run locally without API keys or network calls.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "tresor4k-calcuris": {
      "command": "npx",
      "args": [
        "-y",
        "calcuris-mcp"
      ]
    }
  }
}
Run commandnpx -y calcuris-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmcalcuris-mcp0.1.1

Tools

7

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
stateCodeenumNoOptional two-letter state code to also estimate state income tax. Omit to skip state estimation.AL | AK | AZ | AR | CA | CO | CT | DE | DC | FL | GA | HI | ID | IL | IN | IA | KS | KY | LA | ME | MD | MA | MI | MN | MS | MO | MT | NE | NV | NH | NJ | NM | NY | NC | ND | OH | OK | OR | PA | RI | SC | SD | TN | TX | UT | VT | VA | WA | WV | WI | WY
dependentsintegerNoNumber of qualifying children for the Child Tax Credit.
grossIncomenumberYesGross annual income in USD.
useItemizedbooleanNoUse itemized deductions instead of the standard deduction.
filingStatusenumYesIRS filing status: single, mfj (married filing jointly), hoh (head of household), mfs (married filing separately).single | mfj | hoh | mfs
itemizedAmountnumberNoTotal itemized deductions in USD (only used if useItemized is true and it exceeds the standard deduction).
preTaxContributionsnumberNoAnnual pre-tax 401(k)/traditional IRA contributions, reduces taxable income.

Details

From the project README

calcuris-mcp

npm version license

An MCP (Model Context Protocol) server that exposes the tax engines behind Calcuris — real 2026 US income tax & paycheck math, US state property tax, Canadian federal + provincial income tax, Australian income tax & stamp duty, and UK dividend tax. No API key, no network calls: every number is computed locally from data sourced from the IRS, Tax Foundation, CRA/Revenu Québec, the ATO and state revenue offices, and HMRC.

Quick Start

Run directly with npx — no install required.

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "calcuris": {
      "command": "npx",
      "args": ["-y", "calcuris-mcp"]
    }
  }
}
Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "calcuris": {
      "command": "npx",
      "args": ["-y", "calcuris-mcp"]
    }
  }
}

Tools

Every response includes a source note and a reference_url pointing to the live calculator on calcuris.com that uses the same engine.

ToolDescriptionExample callExample response (excerpt)
us_income_taxUS federal (2026 IRS brackets, post-OBBBA) + estimated state income tax, with a full progressive bracket breakdown.{ "grossIncome": 95000, "filingStatus": "single", "stateCode": "CA" }{ "federalTax": 12070, "stateTax": 4758.42, "totalTax": 16828.42, "marginalRate": 0.22, "takeHome": 78171.58 }
us_paycheckUS take-home pay per pay period: federal withholding, Social Security, Medicare (+ Additional Medicare), state tax, net pay.{ "payType": "salary", "annualSalary": 80000, "payFrequency": "biweekly", "filingStatus": "single", "stateCode": "TX" }{ "net": { "annual": 65110, "perPeriod": 2504.23 }, "federal": { "annual": 8770 }, "socialSecurity": { "annual": 4960 } }
us_property_taxAnnual/monthly property tax from a home value and either a custom rate or a state's real 2026 effective rate.{ "homeValue": 450000, "stateCode": "TX" }{ "annualTax": 6300, "monthlyTax": 525, "effectiveRatePct": 1.4 }
ca_income_taxCanadian federal + provincial/territorial income tax, CPP/QPP (+ CPP2/QPP2), EI/QPIP, and net take-home pay. Optional compareAllProvinces.{ "grossIncome": 75000, "provinceCode": "ON", "rrspContribution": 0 }{ "federalTax": 8468.74, "provincialTax": 3696.06, "netIncome": 57465.69 }
au_income_taxAustralian resident income tax (2025-26 ATO brackets) + Medicare levy, Medicare Levy Surcharge, LITO offset, HELP/HECS repayment.{ "taxableIncome": 95000, "privateHospitalCover": true, "hasHelpDebt": false }{ "incomeTax": 19288, "medicareLevy": 1900, "totalTax": 21188, "takeHome": 73812 }
au_stamp_dutyAustralian state/territory stamp duty, including first-home-buyer concessions and the foreign purchaser surcharge. Optional compareAllStates.{ "propertyValue": 750000, "stateCode": "NSW", "firstHomeBuyer": false, "foreignResident": false, "principalResidence": true }{ "baseDuty": 28162.5, "totalDuty": 28162.5, "effectiveRate": 3.755 }
uk_dividend_taxUK dividend tax with HMRC's stacking method (dividends sit on top of other income), tapered Personal Allowance, £500 dividend allowance, year-over-year comparison.{ "otherIncome": 40000, "dividends": 15000, "year": "2026/27" }{ "dividendTax": 2741.25, "totalTax": 8227.25, "extraVsPrior": 290 }

Each tool's inputSchema documents every field (types, enums, defaults) and is discoverable via tools/list — see the source in src/index.ts for the full parameter set.

Data sources & freshness

All engines target tax year 2026 (UK: 2026/27, with 2025/26 comparison built in). Rates and brackets are sourced from:

  • US — IRS Rev. Proc. 2025-32 (federal brackets, standard deduction, Child Tax Credit), SSA/IRS FICA wage base and rates, Tax Foundation (state income tax brackets and property tax effective rates), state revenue offices.
  • Canada — CRA (federal brackets, BPA, CPP/CPP2), Revenu Québec (QPP, QPIP, Quebec abatement), provincial finance ministries.
  • Australia — ATO (2025-26 individual tax rates, Medicare levy, LITO, HELP/HECS repayment thresholds), state and territory revenue offices (stamp duty schedules and first-home-buyer concessions).
  • UK — HMRC (Personal Allowance, dividend allowance, Income Tax bands and dividend rates for 2025/26 and 2026/27).

These are the same datasets that power the live calculators:

Disclaimer

Results are estimates for guidance only and do not constitute tax, legal, or financial advice. Tax situations vary by individual (local taxes, deductions, credits, and edge cases are not exhaustively modeled). Always confirm figures with a qualified tax professional or the relevant government authority before making financial decisions.

Development

npm install
npm run build   # compiles src/ → dist/ with tsc
npm test        # spawns the built server and runs the smoke test

License

MIT © 2026 tresor4k

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.