Skip to main content
Glama
macalc

macalc

by tresor4k

macalc — Everyday Calculator MCP Server

npm version license: MIT macalc MCP server

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.

Related MCP server: Currency Converter MCP

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.)

{
  "mcpServers": {
    "macalc": {
      "url": "https://macalculatriceenligne.com/api/mcp"
    }
  }
}

Option B — Local stdio proxy (works everywhere)

For clients that only speak stdio, or sandboxed environments:

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

Or with Docker (tresor4k/macalc-mcp on Docker Hub):

{
  "mcpServers": {
    "macalc": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "tresor4k/macalc-mcp"]
    }
  }
}

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.

Math (60+ tools)

Percentages (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.

Construction (40+ tools)

Concrete 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.

Science (25+ tools)

Ohm's law, Newton's laws, pH calculation, dilution (C1V1=C2V2), density, radioactive decay, speed of sound, ideal gas law, molar mass, concentration.

Conversions (40+ tools)

Temperature, distance, weight, volume, speed, pressure, energy, data storage, cooking units, shoe sizes, clothing sizes, currency.

Running & Cycling (35+ tools)

Pace calculator, VMA (6 test methods), VO2max, FTP, heart rate zones, race prediction, training plan, calorie burn, hydration needs, bike gear ratio, tire pressure.

Education (20+ tools)

GPA calculator (French bac/brevet system), weighted average, statistics, derivatives, combinatorics, probability distributions.

Real Estate (15+ tools)

Rental yield (gross/net/net-net), Pinel tax reduction, PTZ eligibility, DPE energy class, Carrez surface, notary fees by department, loan comparison.

Cooking & Nutrition (15+ tools)

Recipe nutrition calculator, baking conversions, glycemic load, caffeine intake, daily vitamins, unit conversions (cups/ml/oz).

Travel (10+ tools)

Luggage weight calculator, jet lag recovery, travel budget, voltage adapters, sun exposure time.

Animals (8+ tools)

Dog/cat food calculator, pet age converter (corrected formula), aquarium volume, breeding due date.

Astronomy (8+ tools)

Sunrise/sunset, moon phase, solar panel output, wind chill, heat index, carbon sequestration.

Textile (5+ tools)

Fabric yardage, knitting yarn calculator, ring/bra/hat size converters.

Exemples d'outils

  • Impôt sur le revenu : page web du calculateur correspondant à l'outil calculate_french_income_tax (barème IR 2026, quotient familial).

  • Salaire brut en net : page web du calculateur correspondant à l'outil calculate_french_salary (cadre, non-cadre, fonction publique).

  • Mensualité de prêt immobilier : page web du calculateur correspondant à l'outil calculate_mortgage (mensualité, intérêts totaux, tableau d'amortissement).

Technical Details

Property

Value

Endpoint

https://macalculatriceenligne.com/api/mcp

Transport

Streamable HTTP (stateless)

Protocol

MCP v1 (@modelcontextprotocol/sdk ^1.27.1)

Auth

None (free, no API key)

Rate limit

1,000 calls/day

Response format

Structured JSON with formula, source, reference URL

Discovery

https://macalculatriceenligne.com/.well-known/mcp/server.json

Example Usage

Ask your AI assistant:

"Calculate the French income tax on 45,000€ for a single person"

The assistant calls calculate_french_income_tax with {income: 45000, parts: 1} and returns:

{
  "impot": 4611,
  "taux_effectif": "10.2%",
  "taux_marginal": "30%",
  "tranches": [
    {"min": 0, "max": 11624, "taux": "0%", "impot": 0},
    {"min": 11624, "max": 29638, "taux": "11%", "impot": 1982},
    {"min": 29638, "max": 45000, "taux": "30%", "impot": 2629}
  ],
  "source": "Article 197 CGI — Loi de finances 2026",
  "reference_url": "https://macalculatriceenligne.com/finance/fiscalite/calcul-impots/"
}

All Tool Categories

Finance FR (85)     Finance BE (35)     Finance CH (30)
Finance CA (25)     Finance US (15)     Finance UK (10)
Finance MA (10)     Finance SN (10)     Health (30)
Sport/Running (35)  Math (60)           Construction (40)
Science (25)        Conversions (40)    Education (20)
Real Estate (15)    Cooking (15)        Travel (10)
Animals (8)         Astronomy (8)       Textile (5)
Automotive (10)

Total: 446 tools (hosted catalog — counts per category are approximate)

License

MIT

Available Tools

15 tools
calculate_bmiA
Read-onlyIdempotent
Inspect

Calculate Body Mass Index and the corresponding WHO weight category for an adult. Inputs: weight_kg (kilograms) and height_cm (centimeters). Returns the BMI value and category. Read-only and deterministic. Screening indicator only — not a medical diagnosis; not valid for children or athletes with high muscle mass.

Inputs: height_cm (required), weight_kg (required).

calculate_canada_federal_taxA
Read-onlyIdempotent
Inspect

Calculate Canadian FEDERAL income tax using CRA brackets and the basic personal amount. Use for a federal-only estimate; provincial/territorial tax and CPP/EI are NOT included, so the real total tax is higher. Input: income_cad (annual income in CAD). Returns basic personal amount, taxable income, federal tax, effective and marginal rates. Read-only, deterministic, estimate only.

Inputs: income_cad (required).

calculate_compound_interestA
Read-onlyIdempotent
Inspect

Compute compound growth of a lump sum with A = P·(1+r/n)^(n·t). Use for savings, investment or retirement projections without periodic contributions. Inputs: principal (initial amount), annual_rate (annual rate in percent), years (duration), optional compounds_per_year (compounding frequency, default annual). Returns final amount, total interest earned and a yearly breakdown. Read-only, deterministic. For loans/repayments use calculate_loan_payment or calculate_mortgage instead.

Inputs: years (required), principal (required), annual_rate (required), compounds_per_year.

calculate_french_income_taxA
Read-onlyIdempotent
Inspect

Calculate French personal income tax (impôt sur le revenu) for the 2026 tax year using the official progressive brackets (Article 197 CGI) and the family-quotient system. Use when the user asks how much income tax they owe in France. Inputs: income (annual net taxable income in EUR) and optional parts (number of family-quotient shares, default 1 — e.g. 2 for a married couple, 2.5 with one child). Returns total tax, effective and marginal rates, and the per-bracket breakdown. Read-only and deterministic: same inputs always give the same result; no data is stored. Not tax advice. For payroll gross-to-net conversion use calculate_french_salary instead.

Inputs: income (required), parts.

calculate_french_salaryA
Read-onlyIdempotent
Inspect

Convert a French gross salary to net salary for 2026, applying the social-contribution rates of the selected employment status. Use when the user knows their gross pay and wants their take-home pay in France. Inputs: gross_monthly (gross monthly salary in EUR) and optional status ('cadre', 'non-cadre' or civil servant — see the enum). Returns monthly and annual net, total social contributions, and employer cost. Read-only, deterministic estimate based on standard rates; individual company agreements may differ. For income tax on that salary, use calculate_french_income_tax.

Inputs: gross_monthly (required), status.

calculate_loan_paymentA
Read-onlyIdempotent
Inspect

Calculate the fixed monthly payment of a generic amortizing loan when the term is expressed in months. Inputs: principal (amount borrowed), annual_rate (annual interest rate in percent), months (term in months). Returns monthly payment, total cost and total interest. Read-only and deterministic. Prefer calculate_mortgage if you want a term in years or an amortization schedule.

Inputs: months (required), principal (required), annual_rate (required).

calculate_mortgageA
Read-onlyIdempotent
Inspect

Calculate the fixed monthly payment, total interest and total cost of a mortgage or amortizing loan, with an optional month-by-month amortization schedule. Use for home-loan or any fixed-rate amortizing loan questions in any currency. Inputs: principal (amount borrowed), annual_rate (nominal annual interest rate in percent, e.g. 3.5), years (term in years), optional with_schedule (boolean — include the full amortization table). Read-only and deterministic. Does not include insurance, taxes or fees.

Inputs: years (required), principal (required), annual_rate (required), with_schedule.

calculate_percentageA
Read-onlyIdempotent
Inspect

Perform one of three percentage operations selected by operation: the value of a percent of a total, the percentage change between two values, or what percent one value is of another. Inputs: operation (see enum), a and b (the two operands — their meaning depends on the operation, as described in the parameter docs). Returns the numeric result with the applied formula. Read-only and deterministic.

Inputs: a (required), b (required), operation (required).

calculate_tdeeA
Read-onlyIdempotent
Inspect

Calculate Total Daily Energy Expenditure (maintenance calories) by multiplying a Basal Metabolic Rate by a standard activity factor. Inputs: bmr (basal metabolic rate in kcal — compute it first if unknown) and activity_level (see enum, from sedentary to very active). Returns TDEE in kcal/day. Read-only and deterministic. General guidance, not medical or dietary advice.

Inputs: bmr (required), activity_level (required).

calculate_uk_income_taxA
Read-onlyIdempotent
Inspect

Calculate UK income tax for the 2025/26 tax year using HMRC bands, including the personal-allowance taper above £100,000. Use for England/Wales/NI income tax questions (National Insurance is not included; Scottish bands are not modelled). Input: income (annual gross income in GBP). Returns personal allowance, taxable income, income tax, effective and marginal rates. Read-only, deterministic, estimate only.

Inputs: income (required).

calculate_us_federal_taxA
Read-onlyIdempotent
Inspect

Calculate US federal income tax for tax year 2026 using the IRS progressive brackets and the standard deduction for the chosen filing status. Use for a quick federal-only estimate; it does NOT include state income tax or FICA payroll taxes. Inputs: income (annual gross income in USD) and optional filing_status. Returns taxable income after standard deduction, federal tax, effective and marginal rates. Read-only and deterministic. Estimates only — not tax advice.

Inputs: income (required), filing_status.

calculate_vat_genericA
Read-onlyIdempotent
Inspect

Add or remove VAT/GST/sales tax at any custom rate, for any country. Inputs: amount, rate (tax rate in percent) and optional mode (whether amount is before-tax or after-tax — see enum). Returns amount before tax, amount after tax and the tax amount. Read-only and deterministic. Country-specific helpers (French/UK/Swiss VAT…) exist in the full catalog via get_bundle_tools('finance-universal').

Inputs: rate (required), amount (required), mode.

call_any_calculatorA
Read-onlyIdempotent
Inspect

Invoke ANY of the 446 calculators of the hosted macalc catalog by name — not just the core tools listed by this server. Workflow: 1) list_bundles to find the right domain, 2) get_bundle_tools(bundle_id) to get the exact tool name and its parameters, 3) call_any_calculator with that tool_name and its arguments object. The call is forwarded verbatim to the hosted macalc API (network request, no authentication, nothing stored beyond anonymous usage counters). Read-only and deterministic for a given catalog version. Returns the target calculator's JSON result ({result, formula, source, reference_url}) or a clear error if the tool name is unknown.

Inputs: tool_name (required), arguments.

get_bundle_toolsA
Read-onlyIdempotent
Inspect

Return the tool names and descriptions inside one thematic bundle of the full macalc catalog. Use after list_bundles to discover a specific calculator, then invoke it with call_any_calculator. Input: bundle_id (one of the enum values, e.g. 'finance-france', 'sante', 'math'). Read-only and deterministic.

Inputs: bundle_id (required).

list_bundlesA
Read-onlyIdempotent
Inspect

List the 31 thematic bundles that organize the full macalc catalog of 446 calculators (finance by country, real-estate, health, math, construction, conversions…). Use this FIRST when the user needs a calculator that is not among this server's core tools, then call get_bundle_tools to see the tools of the relevant bundle. Takes no meaningful parameters. Read-only, deterministic, returns the same catalog every time.

Inputs: _unused.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 15 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but `call_any_calculator` could cause ambiguity as it can invoke any of 446 calculators, potentially overlapping with dedicated tools. However, the workflow is well-documented to use dedicated tools first.

    Naming Consistency4/5

    The core calculators consistently use 'calculate_' prefix, while discovery tools use 'call_', 'get_', 'list_'. This slight inconsistency is acceptable given the different function groups.

    Tool Count5/5

    15 tools is well-scoped for a calculator server, covering common domains and providing a gateway to hundreds more without being overwhelming.

    Completeness5/5

    The tool set covers key financial, health, and math calculations, and the bundle discovery mechanism ensures no major gaps—users can access 446 additional calculators if needed.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      A Model Context Protocol server that provides basic calculator functionality for LLMs, enabling them to perform mathematical operations like addition, subtraction, multiplication, division, modulo, and square root.
      6
      235 npm
      15
      MIT
    • F
      license
      C
      quality
      D
      maintenance
      An MCP server providing real-time currency conversion and exchange rate data through the Frankfurter API, enabling users to convert currencies, fetch latest or historical rates, and list available currencies.
      4
      37
      -
    • A
      license
      B
      quality
      F
      maintenance
      Enables AI assistants to calculate French individual income tax and retrieve current tax brackets using official government data. Supports household composition calculations and provides up-to-date tax information for French residents.
      11
      14
      Apache 2.0
    • A
      license
      C
      quality
      D
      maintenance
      Enables financial research and analysis through AI agents that combine web search, content crawling, entity extraction, and deep research workflows. Supports extracting stock/fund entities with security codes and conducting structured financial investigations.
      9
      34 PyPI
      26
      Apache 2.0