macalc
macalc is a free, read-only calculator MCP server exposing 15 curated everyday calculators plus discovery and dispatcher tools that reach the full hosted catalog of 446 calculators.
Tax & salary: French income tax (2026 brackets, family quotient), French gross→net salary (cadre/non-cadre/civil servant), US federal tax, UK income tax, Canadian federal tax.
Loans & finance: mortgage (with optional amortization schedule), generic amortizing loan, compound interest with yearly breakdown.
Everyday math: percentage of total / percent change / what-percent, add or remove VAT/GST at any rate.
Health: BMI with WHO category, TDEE from BMR and activity level.
Discovery:
list_bundleslists 31 thematic bundles (finance by country, health, math, construction, conversions, etc.) covering all 446 calculators.Bundle inspection:
get_bundle_tools(bundle_id)returns the tool names and descriptions inside one bundle.Dispatcher:
call_any_calculator(tool_name, arguments)invokes any hosted calculator by name (e.g. notary fees, concrete volume, VMA, pet food) and forwards the call verbatim to the macalc API.Characteristics: no API key or auth, all operations read-only, deterministic, idempotent, and non-destructive; stateless Streamable HTTP or local stdio proxy; 1,000 calls/day limit.
Provides a Telegram bot (@macalculatrice_bot) that allows users to perform various calculations (tax, mortgage, health, math, etc.) through the Telegram messaging platform.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
macalc — Everyday Calculator 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 |
| French income tax 2026 (Article 197 CGI, family quotient) |
| French gross → net salary 2026 (cadre / non-cadre / civil servant) |
| US federal income tax 2026 (IRS brackets + standard deduction) |
| UK income tax 2025/26 (HMRC bands, allowance taper) |
| Canadian federal income tax (CRA brackets + BPA) |
| Monthly payment, total interest, amortization schedule |
| Lump-sum compound growth with yearly breakdown |
| Generic amortizing loan (term in months) |
| Percent of total / percent change / what-percent |
| Add or remove VAT/GST/sales tax at any rate |
| Body Mass Index + WHO category |
| Maintenance calories from BMR + activity level |
| Discover the 31 thematic bundles of the full catalog |
| List the tools inside one bundle |
| 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 |
|
Transport | Streamable HTTP (stateless) |
Protocol | MCP v1 ( |
Auth | None (free, no API key) |
Rate limit | 1,000 calls/day |
Response format | Structured JSON with formula, source, reference URL |
Discovery |
|
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)
Links
Website: macalculatriceenligne.com
MCP endpoint: macalculatriceenligne.com/api/mcp
MCP info page: macalculatriceenligne.com/mcp/
API docs: macalculatriceenligne.com/api-docs/
Chrome extension: Calculer Partout
Telegram bot: @macalculatrice_bot
License
MIT
Available Tools
15 toolscalculate_bmiARead-onlyIdempotentInspect
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_taxARead-onlyIdempotentInspect
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_interestARead-onlyIdempotentInspect
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_taxARead-onlyIdempotentInspect
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_salaryARead-onlyIdempotentInspect
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_paymentARead-onlyIdempotentInspect
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_mortgageARead-onlyIdempotentInspect
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_percentageARead-onlyIdempotentInspect
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_tdeeARead-onlyIdempotentInspect
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_taxARead-onlyIdempotentInspect
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_taxARead-onlyIdempotentInspect
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_genericARead-onlyIdempotentInspect
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_calculatorARead-onlyIdempotentInspect
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_toolsARead-onlyIdempotentInspect
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_bundlesARead-onlyIdempotentInspect
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
Scored across 15 tools
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.
The core calculators consistently use 'calculate_' prefix, while discovery tools use 'call_', 'get_', 'list_'. This slight inconsistency is acceptable given the different function groups.
15 tools is well-scoped for a calculator server, covering common domains and providing a gateway to hundreds more without being overwhelming.
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
Related MCP Connectors
Free calculators as MCP tools: finance, taxes, health, units, dates. Search, fetch & compute.
55 stateless calculators for AI agents: loans and mortgage amortization, income and sales tax, retirement and FIRE, BMI and health, date and planning, and unit conversions, returned as clean JSON. Nothing is stored. Part of FreeDailyPro's 211+ MCP tools; trial key with 20,000 calls/month at freedailypro.com/developers.
500+ free tools over MCP: dev, text and security utilities, 230+ calculators. No sign-up.
SmartMoney77 MCP v0.6.0 — 14 public tools that turn financial questions into exact numbers and citable links. New: historical_investment_return and compare_investments, which compute "what if I had invested" results from real yearly price data. Also compound interest, FIRE number, credit-card payoff, emergency fund, inflation, latte factor, investment fees, cost of waiting, plus discovery/deep-link/share-pack tools for a catalog of calculators in 6 languages (he/en/ar/es/pt/in). Public, no login. Endpoint: https://smartmoney77.com/mcp
Related MCP Servers
- AlicenseBqualityCmaintenanceA 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.6235 npm15MIT
- FlicenseCqualityDmaintenanceAn 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.437-
- AlicenseBqualityFmaintenanceEnables 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.1114Apache 2.0
- AlicenseCqualityDmaintenanceEnables 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.934 PyPI26Apache 2.0