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., "@calcuris-mcp calculate US federal tax for $95k single in CA"
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.
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.
Run directly with npx — no install required.
Add to your MCP config (claude_desktop_config.json or .mcp.json):
{
"mcpServers": {
"calcuris": {
"command": "npx",
"args": ["-y", "calcuris-mcp"]
}
}
}Add to .cursor/mcp.json:
{
"mcpServers": {
"calcuris": {
"command": "npx",
"args": ["-y", "calcuris-mcp"]
}
}
}Related MCP server: io.github.CSOAI-ORG/tax-calculator-ai-mcp
Every response includes a source note and a reference_url pointing to the
live calculator on calcuris.com that uses the same
engine.
Tool | Description | Example call | Example response (excerpt) |
| US federal (2026 IRS brackets, post-OBBBA) + estimated state income tax, with a full progressive bracket breakdown. |
|
|
| US take-home pay per pay period: federal withholding, Social Security, Medicare (+ Additional Medicare), state tax, net pay. |
|
|
| Annual/monthly property tax from a home value and either a custom rate or a state's real 2026 effective rate. |
|
|
| Canadian federal + provincial/territorial income tax, CPP/QPP (+ CPP2/QPP2), EI/QPIP, and net take-home pay. Optional |
|
|
| Australian resident income tax (2025-26 ATO brackets) + Medicare levy, Medicare Levy Surcharge, LITO offset, HELP/HECS repayment. |
|
|
| Australian state/territory stamp duty, including first-home-buyer concessions and the foreign purchaser surcharge. Optional |
|
|
| UK dividend tax with HMRC's stacking method (dividends sit on top of other income), tapered Personal Allowance, £500 dividend allowance, year-over-year comparison. |
|
|
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.
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:
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.
npm install
npm run build # compiles src/ → dist/ with tsc
npm test # spawns the built server and runs the smoke testMIT © 2026 tresor4k
Computes Australian resident income tax (2025-26 ATO brackets) plus Medicare levy, Medicare levy surcharge, LITO offset, and HELP/HECS repayment. Example: { taxableIncome: 95000, privateHospitalCover: true, hasHelpDebt: false }. Estimate for guidance — 2026 rates from official sources (IRS/Tax Foundation/CRA/ATO/state revenue offices/HMRC).
Inputs: taxableIncome (required), hasHelpDebt, privateHospitalCover.
Computes Australian state/territory stamp duty on a property purchase, including first-home-buyer concessions and the foreign purchaser surcharge where applicable. Example: { propertyValue: 750000, stateCode: "NSW", firstHomeBuyer: false, foreignResident: false, principalResidence: true }. Set compareAllStates: true to compare every state/territory for the same property value. Estimate for guidance — 2026 rates from official sources (IRS/Tax Foundation/CRA/ATO/state revenue offices/HMRC).
Inputs: stateCode (required), propertyValue (required), firstHomeBuyer, foreignResident, +2 more.
Computes Canadian federal + provincial/territorial income tax, CPP/QPP (+ CPP2/QPP2), EI/QPIP, and net take-home pay for a given province, 2026 rates. Example: { grossIncome: 75000, provinceCode: "ON" }. Set compareAllProvinces: true to get every province/territory side by side. Estimate for guidance — 2026 rates from official sources (IRS/Tax Foundation/CRA/ATO/state revenue offices/HMRC).
Inputs: grossIncome (required), provinceCode (required), rrspContribution, compareAllProvinces.
Computes UK dividend tax using HMRC's stacking method (dividends sit on top of other income), including the tapered Personal Allowance and the £500 dividend allowance, with a year-over-year comparison. Example: { otherIncome: 40000, dividends: 15000, year: "2026/27" }. Estimate for guidance — 2026 rates from official sources (IRS/Tax Foundation/CRA/ATO/state revenue offices/HMRC).
Inputs: year (required), dividends (required), otherIncome (required).
Computes US federal income tax (2026 IRS brackets, post-OBBBA) plus an estimated state income tax, with a full progressive bracket breakdown. Example: { grossIncome: 95000, filingStatus: "single", stateCode: "CA" }. Estimate for guidance — 2026 rates from official sources (IRS/Tax Foundation/CRA/ATO/state revenue offices/HMRC).
Inputs: grossIncome (required), filingStatus (required), stateCode, dependents, +3 more.
Computes US take-home pay per pay period: federal withholding, Social Security, Medicare (+ Additional Medicare), state tax, and net pay, for salaried or hourly workers. Example: { payType: "salary", annualSalary: 80000, payFrequency: "biweekly", filingStatus: "single", stateCode: "TX" }. Estimate for guidance — 2026 rates from official sources (IRS/Tax Foundation/CRA/ATO/state revenue offices/HMRC).
Inputs: payType (required), filingStatus (required), payFrequency (required), stateCode, +7 more.
Estimates annual/monthly US property tax from a home value and either a custom rate or a state's real 2026 effective property tax rate. Example: { homeValue: 350000, stateCode: "NJ" }. Estimate for guidance — 2026 rates from official sources (IRS/Tax Foundation/CRA/ATO/state revenue offices/HMRC).
Inputs: homeValue (required), ratePct, exemption, stateCode, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
Each tool targets a distinct combination of country and tax type (e.g., us_income_tax vs au_stamp_duty), with no overlap in functionality. Descriptions clearly differentiate them.
All tools follow a consistent pattern: two-letter country code (lowercase) followed by underscore and the specific tax type (e.g., us_income_tax, au_stamp_duty). This makes it easy to predict tool names.
With 7 tools covering major tax calculations for multiple countries, the count feels well-scoped and manageable. Each tool serves a clear purpose without bloat.
The set covers several tax types but has notable gaps: missing UK income tax, Canadian property tax, and Australian property tax (only stamp duty is present). Agents may need additional tools for complete tax workflows.
Real-time US and Canadian sales and use tax rates by address or geo coordinates.
Pro athlete tax calculators for MLB, NBA, NFL and NHL. Requires a Jock Taxes API key.
US mortgage calculator and amortization API with 50-state property tax, PMI, and affordability data.
Read-only payroll calculations and multi-country tax comparisons for eight countries.
