tresor4k/macalc-mcp

A **curated core of 15 well-scoped calculator tools** — income tax (France, US, UK, Canada), gross-to-net salary, mortgage, compound interest, loans, VAT, percentages, BMI, TDEE — with on-demand access to the **full macalc catalog of 446 calculators** (22 categories, 8 countries' tax systems) through a discovery + dispatcher workflow. Free, no API key required.
Core tools (default profile)
| Tool | What it does |
|------|--------------|
| calculate_french_income_tax | French income tax 2026 (Article 197 CGI, family quotient) |
| calculate_french_salary | French gross → net salary 2026 (cadre / non-cadre / civil servant) |
| calculate_us_federal_tax | US federal income tax 2026 (IRS brackets + standard deduction) |
| calculate_uk_income_tax | UK income tax 2025/26 (HMRC bands, allowance taper) |
| calculate_canada_federal_tax | Canadian federal income tax (CRA brackets + BPA) |
| calculate_mortgage | Monthly payment, total interest, amortization schedule |
| calculate_compound_interest | Lump-sum compound growth with yearly breakdown |
| calculate_loan_payment | Generic amortizing loan (term in months) |
| calculate_percentage | Percent of total / percent change / what-percent |
| calculate_vat_generic | Add or remove VAT/GST/sales tax at any rate |
| calculate_bmi | Body Mass Index + WHO category |
| calculate_tdee | Maintenance calories from BMR + activity level |
| list_bundles | Discover the 31 thematic bundles of the full catalog |
| get_bundle_tools | List the tools inside one bundle |
| call_any_calculator | Invoke **any** of the 446 hosted calculators by name |
Need something not in the core (notary fees, concrete volume, VMA, pet food…)? list_bundles → get_bundle_tools(bundle_id) → call_any_calculator(tool_name, arguments).
Prefer the raw 446-tool listing? Set the env var MACALC_MCP_FULL=1.
Quick Start
Two install modes — pick whichever your MCP client supports.
Option A — Remote (Streamable HTTP, zero install)
For clients with native remote MCP support (Claude Desktop ≥ 0.8, Cursor, Windsurf, VS Code MCP, etc.)
Option B — Local stdio proxy (works everywhere)
For clients that only speak stdio, or sandboxed environments:
Or with Docker (tresor4k/macalc-mcp on Docker Hub):
That's it. No API key, no auth, no setup.
> Note: Option A (remote URL) serves the **full 446-tool catalog** directly.
> Option B (this npm wrapper) serves the curated 15-tool core profile by default —
> lighter on your agent's context window — with the full catalog one dispatcher call away.
What's Inside — The Full Catalog
Finance (8 countries)
| Country | Tools | Examples |
|---------|-------|---------|
| 🇫🇷 France | 85+ | Income tax (IR 2026), salary gross→net, VAT, mortgage, notary fees, inheritance, retirement, unemployment, auto-entrepreneur |
| 🇧🇪 Belgium | 35+ | Precompte professionnel, bonus emploi, pension, cheques repas, droits donation |
| 🇨🇭 Switzerland | 30+ | Federal + cantonal tax, AVS/LPP, LAMal, 3rd pillar, frontalier |
| 🇨🇦 Canada/Quebec | 25+ | Federal + provincial tax, RRQ, RQAP, REER, CELI, TPS/TVQ |
| 🇺🇸 USA | 15+ | Federal income tax, FICA, state tax, 401k, HSA |
| 🇬🇧 UK | 10+ | Income tax, NI, SDLT, student loan repayment |
| 🇲🇦 Morocco | 10+ | IR, CNSS, TVA |
| 🇸🇳 Senegal | 10+ | IR, CSS, TVA |
Health & Sport (50+ tools)
BMI, BMR (Mifflin/Harris-Benedict), TDEE, heart rate zones (Karvonen), 1RM (Epley/Brzycki), VMA (Cooper/Luc-Léger), VO2max, race prediction (Riegel), marathon/half pace, due date (3 methods), ovulation calendar, body fat (Navy method), daily calories, macros, hydration.