Declan142/calcnook-mcp-server

MCP server wrapping the calcnook financial engine. Gives any MCP-compatible AI agent (Claude Code, Cursor, Goose, Continue, etc.) native access to 17 calculation tools across compound interest, SIP/DCA, loans, retirement planning, BMI/BMR, Islamic finance, income tax (US/UK/CA/AU/India), VAT, End of Service Gratuity, and more.
Install
**Preferred — zero setup via uvx:**
**Or pip:**
Configure your AI agent
Claude Desktop / Claude Code
Add to claude_desktop_config.json (or your MCP settings):
Cursor
Goose / Continue
Use the same JSON block in the respective mcp_servers config section.
Tools
| Tool | What it does | Example query |
|------|-------------|---------------|
| calculate_compound_interest | Future value of a lump-sum at compound interest | "What will ₹1L grow to in 10 years at 7%?" |
| calculate_sip_dca | SIP (India) / DCA (global) with optional annual step-up | "SIP ₹5000/month for 15 years at 12%" |
| calculate_loan_payment | EMI / mortgage amortization with optional extra payment | "EMI for ₹30L home loan at 8.5% for 20 years" |
| calculate_retirement | Corpus needed, monthly SIP to reach corpus, safe withdrawal (4% rule) | "How much SIP to reach 2Cr in 20 years?" |
| calculate_bmi_bmr_tdee | BMI + WHO category, BMR (Mifflin-St Jeor), TDEE | "BMI for 70kg 175cm" |
| convert_currency | Convert between any currencies using caller-supplied rates | "Convert $1000 to INR at 83.5" |
| format_currency_amount | Format amount as currency string; INR supports lakh/crore | "Show 25000000 as crores" |
| calculate_zakat | Zakat al-Mal (2.5% wealth obligation): all asset categories, nisab check | "Zakat on $25k savings + $5k stocks" |
| calculate_islamic_financing | Murabaha, Ijarah, or Mudarabah financing calculator | "Murabaha for $100k house at 30% markup over 5 years" |
| calculate_hajj_savings | Monthly savings needed to fund Hajj by target year | "Save monthly for Hajj costing $8000 in 5 years" |
| screen_halal_stock | AAOIFI Sharia compliance screen (debt, cash, receivables, haram revenue ratios) | "Is this tech stock halal given these financials?" |
| calculate_income_tax | Federal/national income tax for US, UK, CA, AU, India (2026) | "India income tax on ₹12L new regime" |
| calculate_us_retirement_account | Traditional 401(k) contribution analysis or Roth IRA phase-out check | "Am I eligible for Roth IRA at $155k income?" |
| calculate_eosg | End of Service Gratuity for UAE or Saudi Arabia | "UAE gratuity for 7 years at AED 8000 basic salary" |