{
  "markdown": "# macalc — Everyday Calculator MCP Server\n\n[![npm version](https://img.shields.io/npm/v/macalc-mcp)](https://www.npmjs.com/package/macalc-mcp)\n[![license: MIT](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)\n[![macalc MCP server](https://glama.ai/mcp/servers/tresor4k/macalc-mcp/badges/card.svg)](https://glama.ai/mcp/servers/tresor4k/macalc-mcp)\n\nA **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.\n\n## Core tools (default profile)\n\n| Tool | What it does |\n|------|--------------|\n| `calculate_french_income_tax` | French income tax 2026 (Article 197 CGI, family quotient) |\n| `calculate_french_salary` | French gross → net salary 2026 (cadre / non-cadre / civil servant) |\n| `calculate_us_federal_tax` | US federal income tax 2026 (IRS brackets + standard deduction) |\n| `calculate_uk_income_tax` | UK income tax 2025/26 (HMRC bands, allowance taper) |\n| `calculate_canada_federal_tax` | Canadian federal income tax (CRA brackets + BPA) |\n| `calculate_mortgage` | Monthly payment, total interest, amortization schedule |\n| `calculate_compound_interest` | Lump-sum compound growth with yearly breakdown |\n| `calculate_loan_payment` | Generic amortizing loan (term in months) |\n| `calculate_percentage` | Percent of total / percent change / what-percent |\n| `calculate_vat_generic` | Add or remove VAT/GST/sales tax at any rate |\n| `calculate_bmi` | Body Mass Index + WHO category |\n| `calculate_tdee` | Maintenance calories from BMR + activity level |\n| `list_bundles` | Discover the 31 thematic bundles of the full catalog |\n| `get_bundle_tools` | List the tools inside one bundle |\n| `call_any_calculator` | Invoke **any** of the 446 hosted calculators by name |\n\nNeed 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)`.\n\nPrefer the raw 446-tool listing? Set the env var `MACALC_MCP_FULL=1`.\n\n## Quick Start\n\nTwo install modes — pick whichever your MCP client supports.\n\n### Option A — Remote (Streamable HTTP, zero install)\n\nFor clients with native remote MCP support (Claude Desktop ≥ 0.8, Cursor, Windsurf, VS Code MCP, etc.)\n\n```json\n{\n  \"mcpServers\": {\n    \"macalc\": {\n      \"url\": \"https://macalculatriceenligne.com/api/mcp\"\n    }\n  }\n}\n```\n\n### Option B — Local stdio proxy (works everywhere)\n\nFor clients that only speak stdio, or sandboxed environments:\n\n```json\n{\n  \"mcpServers\": {\n    \"macalc\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"macalc-mcp\"]\n    }\n  }\n}\n```\n\nOr with Docker:\n\n```json\n{\n  \"mcpServers\": {\n    \"macalc\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"-i\", \"--rm\", \"ghcr.io/tresor4k/macalc-mcp:latest\"]\n    }\n  }\n}\n```\n\nThat's it. No API key, no auth, no setup.\n\n> Note: Option A (remote URL) serves the **full 446-tool catalog** directly.\n> Option B (this npm wrapper) serves the curated 15-tool core profile by default —\n> lighter on your agent's context window — with the full catalog one dispatcher call away.\n\n## What's Inside — The Full Catalog\n\n### Finance (8 countries)\n| Country | Tools | Examples |\n|---------|-------|---------|\n| 🇫🇷 France | 85+ | Income tax (IR 2026), salary gross→net, VAT, mortgage, notary fees, inheritance, retirement, unemployment, auto-entrepreneur |\n| 🇧🇪 Belgium | 35+ | Precompte professionnel, bonus emploi, pension, cheques repas, droits donation |\n| 🇨🇭 Switzerland | 30+ | Federal + cantonal tax, AVS/LPP, LAMal, 3rd pillar, frontalier |\n| 🇨🇦 Canada/Quebec | 25+ | Federal + provincial tax, RRQ, RQAP, REER, CELI, TPS/TVQ |\n| 🇺🇸 USA | 15+ | Federal income tax, FICA, state tax, 401k, HSA |\n| 🇬🇧 UK | 10+ | Income tax, NI, SDLT, student loan repayment |\n| 🇲🇦 Morocco | 10+ | IR, CNSS, TVA |\n| 🇸🇳 Senegal | 10+ | IR, CSS, TVA |\n\n### Health & Sport (50+ tools)\nBMI, 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.\n\n### Math (60+ tools)\nPercentages (increase/decrease/ratio), averages (weighted/geometric/harmonic), Pythagoras, area (triangle/circle/rectangle/trapezoid/polygon), volume (sphere/cylinder/cone/cube), perimeter, equations (1st/2nd degree), sequences (arithmetic/geometric), fractions, statistics (mean/median/mode/std dev), GCD/LCM, base conversion.\n\n### Construction (40+ tools)\nConcrete volume & mix (B25 DTU 21), paint coverage, tile quantity, staircase dimensions (Blondel formula), insulation R-value, roof surface & slope, cable section (NF C 15-100), beam dimensioning (Eurocode 5), gravel/sand tonnage, wallpaper rolls, plasterboard sheets.\n\n### Science (25+ tools)\nOhm's law, Newton's laws, pH calculation, dilution (C1V1=C2V2), density, radioactive decay, speed of sound, ideal gas law, molar mass, concentration.\n\n### Conversions (40+ tools)\nTemperature, distance, weight, volume, speed, pressure, energy, data storage, cooking units, shoe sizes, clothing sizes, currency.\n\n### Running & Cycling (35+ tools)\nPace calculator, VMA (6 test methods), VO2max, FTP, heart rate zones, race prediction, training plan, calorie burn, hydration needs, bike gear ratio, tire pressure.\n\n### Education (20+ tools)\nGPA calculator (French bac/brevet system), weighted average, statistics, derivatives, combinatorics, probability distributions.\n\n### Real Estate (15+ tools)\nRental yield (gross/net/net-net), Pinel tax reduction, PTZ eligibility, DPE energy class, Carrez surface, notary fees by department, loan comparison.\n\n### Cooking & Nutrition (15+ tools)\nRecipe nutrition calculator, baking conversions, glycemic load, caffeine intake, daily vitamins, unit conversions (cups/ml/oz).\n\n### Travel (10+ tools)\nLuggage weight calculator, jet lag recovery, travel budget, voltage adapters, sun exposure time.\n\n### Animals (8+ tools)\nDog/cat food calculator, pet age converter (corrected formula), aquarium volume, breeding due date.\n\n### Astronomy (8+ tools)\nSunrise/sunset, moon phase, solar panel output, wind chill, heat index, carbon sequestration.\n\n### Textile (5+ tools)\nFabric yardage, knitting yarn calculator, ring/bra/hat size converters.\n\n## Technical Details\n\n| Property | Value |\n|----------|-------|\n| **Endpoint** | `https://macalculatriceenligne.com/api/mcp` |\n| **Transport** | Streamable HTTP (stateless) |\n| **Protocol** | MCP v1 (`@modelcontextprotocol/sdk ^1.27.1`) |\n| **Auth** | None (free, no API key) |\n| **Rate limit** | 1,000 calls/day |\n| **Response format** | Structured JSON with formula, source, reference URL |\n| **Discovery** | `https://macalculatriceenligne.com/.well-known/mcp/server.json` |\n\n## Example Usage\n\nAsk your AI assistant:\n\n> \"Calculate the French income tax on 45,000€ for a single person\"\n\nThe assistant calls `calculate_french_income_tax` with `{income: 45000, parts: 1}` and returns:\n\n```json\n{\n  \"impot\": 4611,\n  \"taux_effectif\": \"10.2%\",\n  \"taux_marginal\": \"30%\",\n  \"tranches\": [\n    {\"min\": 0, \"max\": 11624, \"taux\": \"0%\", \"impot\": 0},\n    {\"min\": 11624, \"max\": 29638, \"taux\": \"11%\", \"impot\": 1982},\n    {\"min\": 29638, \"max\": 45000, \"taux\": \"30%\", \"impot\": 2629}\n  ],\n  \"source\": \"Article 197 CGI — Loi de finances 2026\",\n  \"reference_url\": \"https://macalculatriceenligne.com/finance/fiscalite/calcul-impots/\"\n}\n```\n\n## All Tool Categories\n\n```\nFinance FR (85)     Finance BE (35)     Finance CH (30)\nFinance CA (25)     Finance US (15)     Finance UK (10)\nFinance MA (10)     Finance SN (10)     Health (30)\nSport/Running (35)  Math (60)           Construction (40)\nScience (25)        Conversions (40)    Education (20)\nReal Estate (15)    Cooking (15)        Travel (10)\nAnimals (8)         Astronomy (8)       Textile (5)\nAutomotive (10)\n```\n\n**Total: 446 tools** (hosted catalog — counts per category are approximate)\n\n## Links\n\n- **Website**: [macalculatriceenligne.com](https://macalculatriceenligne.com)\n- **MCP endpoint**: [macalculatriceenligne.com/api/mcp](https://macalculatriceenligne.com/api/mcp)\n- **MCP info page**: [macalculatriceenligne.com/mcp/](https://macalculatriceenligne.com/mcp/)\n- **API docs**: [macalculatriceenligne.com/api-docs/](https://macalculatriceenligne.com/api-docs/)\n- **Chrome extension**: [Calculer Partout](https://macalculatriceenligne.com/extension-chrome/)\n- **Telegram bot**: [@macalculatrice_bot](https://macalculatriceenligne.com/telegram/)\n\n## License\n\nMIT\n",
  "bytes": 8721,
  "sha": "a0634654f07fb082ac62cfed3a002f31c28dcfa16c4558a9262871f0da3a55fb",
  "repo_slug": "tresor4k/macalc-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tresor4k_macalc_mcp_0512873b/readme"
}