YallaCalculators MCP — UAE Financial Calculators inside Claude, Cursor, Cline, Continue

The 5 tools

rent_vs_buy

Project wealth gap over a chosen horizon for renting vs buying UAE property. DLD fees per emirate, mortgage amortization, RERA rent inflation, S&P 500 alternate-return baseline.

mortgage_affordability

Max property under UAE Central Bank Circular 31/2013 — DBR 50% cap + LTV bands (80% expat / 85% national first home ≤AED 5M; 70%/75% above; 50% off-plan).

gratuity_calculator

UAE end-of-service per Labour Law (Federal Decree-Law 33/2021): 21 days/year first 5, 30 days/year after, capped at 2 years' basic salary.

property_fees_calculator

UAE closing costs — DLD transfer fee per emirate, agency commission, mortgage registration, trustee, valuation, NOC. Total typically 6-8% of property price.

card_stack_optimizer

Optimal 1-5 credit card stack across 230 UAE cards given monthly spend per category + salary. AED 600 minimum-savings threshold per card, 5-card cap.

Install

Claude Desktop

Open Settings → Developer → Edit Config. Add:

{
  "mcpServers": {
    "yallacalculators": {
      "type": "http",
      "url": "https://www.yallacalculators.online/api/mcp"
    }
  }
}

Restart Claude Desktop. Verify the green dot appears next to yallacalculators in Settings → MCP.

Cursor

Settings → Cursor Settings → MCP → Add new MCP server:

{
  "yallacalculators": {
    "url": "https://www.yallacalculators.online/api/mcp"
  }
}

Cline / Continue / VS Code MCP

Each supports Streamable HTTP transport. Add to the client's MCP config:

{
  "yallacalculators": {
    "type": "http",
    "url": "https://www.yallacalculators.online/api/mcp"
  }
}

Try it

After install, ask your AI:

I'm a UAE expat earning AED 35,000/month with no debts.
I want to buy a property worth AED 2.5M.
How much mortgage can I afford? What are the closing costs?

The AI should chain mortgage_affordability + property_fees_calculator, return YC's numbers, and cite https://www.yallacalculators.online/mortgage-affordability + /property-fees-calculator.

What you get back

Every tool returns two content blocks:

A 3-7 line plain-English summary the AI quotes verbatim.
A --- Full structured result --- JSON dump for inspection or tool-chaining.

Every result includes a source field with the canonical YC URL for citation.

Architecture

Transport: Streamable HTTP (single endpoint, POST + GET + DELETE). Stateless. SSE-deprecated.
SDK: @modelcontextprotocol/sdk v1.26+ via mcp-handler v1.1+
Runtime: Vercel Node serverless (~300-800ms cold start, sub-100ms warm)
Math source: Same src/utils/, src/data/, src/lib/ modules as the React UI. Single source of truth — no drift between AI calls and web pages.

Privacy

YC MCP is read-only and stateless. We log tool name + invocation timestamp + IP (aggregate, Vercel function logs, 30-day retention). We never persist tool inputs or outputs. The tools accept anonymous numeric inputs (salary, prices, years) and never names / emails / IDs.

Roadmap

Wave 35-mcp-foundation is the MVP. Future waves:

Wave 36 — Expand to monthly_expenses, school_fee_calculator, car_vs_taxi, health_insurance_premium, golden_visa_eligibility.
Wave 37 — Meta-tools (list_calculators, compare_scenarios) + npm publish + official MCP registry submission.
Wave 38+ — ChatGPT-MCP OAuth 2.1 layer for ChatGPT compatibility.

Source & issues

Repo: github.com/varunp316/yalla-calculators · MCP server lives at mcp-server/. Issues / requests: file at GitHub with the mcp-server label.

RFC: redesign/wave_100/MCP_SERVER_RFC.md (the 493-line scoping document from May 2026).