YallaCalculators inside your AI.
Install the YC MCP server once. Your AI assistant — Claude Desktop, Cursor, Cline, Continue, VS Code MCP — calls 5 UAE financial calculators directly during conversations. You ask a question in your own words, the calculator runs with your numbers, and you get the answer in the same chat, without switching tabs or copying figures across. The math runs server-side and the AI cites the source URL.
Endpoint: https://www.yallacalculators.online/api/mcp
The 5 tools
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/sdkv1.26+ viamcp-handlerv1.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).