{
  "markdown": "# calcuris-mcp\n\n![npm version](https://img.shields.io/npm/v/calcuris-mcp)\n![license](https://img.shields.io/npm/l/calcuris-mcp)\n\nAn MCP (Model Context Protocol) server that exposes the tax engines behind\n[Calcuris](https://calcuris.com) — real 2026 US income tax & paycheck math, US\nstate property tax, Canadian federal + provincial income tax, Australian\nincome tax & stamp duty, and UK dividend tax. No API key, no network calls:\nevery number is computed locally from data sourced from the IRS, Tax\nFoundation, CRA/Revenu Québec, the ATO and state revenue offices, and HMRC.\n\n## Quick Start\n\nRun directly with `npx` — no install required.\n\n### Claude Desktop / Claude Code\n\nAdd to your MCP config (`claude_desktop_config.json` or `.mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"calcuris\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"calcuris-mcp\"]\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"calcuris\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"calcuris-mcp\"]\n    }\n  }\n}\n```\n\n## Tools\n\nEvery response includes a `source` note and a `reference_url` pointing to the\nlive calculator on [calcuris.com](https://calcuris.com) that uses the same\nengine.\n\n| Tool | Description | Example call | Example response (excerpt) |\n|---|---|---|---|\n| `us_income_tax` | US 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 }` |\n| `us_paycheck` | US 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 } }` |\n| `us_property_tax` | Annual/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 }` |\n| `ca_income_tax` | Canadian 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 }` |\n| `au_income_tax` | Australian 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 }` |\n| `au_stamp_duty` | Australian 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 }` |\n| `uk_dividend_tax` | 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. | `{ \"otherIncome\": 40000, \"dividends\": 15000, \"year\": \"2026/27\" }` | `{ \"dividendTax\": 2741.25, \"totalTax\": 8227.25, \"extraVsPrior\": 290 }` |\n\nEach tool's `inputSchema` documents every field (types, enums, defaults) and\nis discoverable via `tools/list` — see the source in\n[`src/index.ts`](./src/index.ts) for the full parameter set.\n\n## Data sources & freshness\n\nAll engines target **tax year 2026** (UK: 2026/27, with 2025/26 comparison\nbuilt in). Rates and brackets are sourced from:\n\n- **US** — IRS Rev. Proc. 2025-32 (federal brackets, standard deduction,\n  Child Tax Credit), SSA/IRS FICA wage base and rates, Tax Foundation (state\n  income tax brackets and property tax effective rates), state revenue\n  offices.\n- **Canada** — CRA (federal brackets, BPA, CPP/CPP2), Revenu Québec (QPP,\n  QPIP, Quebec abatement), provincial finance ministries.\n- **Australia** — ATO (2025-26 individual tax rates, Medicare levy, LITO,\n  HELP/HECS repayment thresholds), state and territory revenue offices\n  (stamp duty schedules and first-home-buyer concessions).\n- **UK** — HMRC (Personal Allowance, dividend allowance, Income Tax bands and\n  dividend rates for 2025/26 and 2026/27).\n\nThese are the same datasets that power the live calculators:\n\n- [calcuris.com](https://calcuris.com)\n- [US income tax calculator](https://calcuris.com/us/income-tax-calculator/)\n- [US paycheck calculator](https://calcuris.com/us/paycheck-calculator/)\n- [Canada income tax calculator](https://calcuris.com/ca/income-tax-calculator/)\n- [Australia stamp duty calculator](https://calcuris.com/au/stamp-duty-calculator/)\n\n## Disclaimer\n\nResults are **estimates for guidance only** and do not constitute tax,\nlegal, or financial advice. Tax situations vary by individual (local taxes,\ndeductions, credits, and edge cases are not exhaustively modeled). Always\nconfirm figures with a qualified tax professional or the relevant government\nauthority before making financial decisions.\n\n## Development\n\n```bash\nnpm install\nnpm run build   # compiles src/ → dist/ with tsc\nnpm test        # spawns the built server and runs the smoke test\n```\n\n## License\n\nMIT © 2026 tresor4k\n",
  "bytes": 5603,
  "sha": "4d5b480645588694e2beaacb41356682f4bbb09a74f184c1066a3f65c9e836b7",
  "repo_slug": "tresor4k/calcuris-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tresor4k_calcuris_mcp_674c7bfa/readme"
}