Calculator API and MCP documentation

JSON API endpoints

REST calculation example

POST https://www.rupeekit.co.in/api/v1/calculators/emergency-fund-calculator-india
Content-Type: application/json

{
  "inputs": {
    "monthlyEssentialExpenses": 30000,
    "monthlyEmiCommitments": 10000,
    "currentEmergencySavings": 50000,
    "monthlySavingCapacity": 10000,
    "targetMonths": 6
  }
}

Inputs omitted from the request use the documented calculator defaults. Unknown keys, non-numeric values, and values outside documented minimum or maximum limits are rejected.

MCP for AI tools

Streamable HTTP endpoint: https://www.rupeekit.co.in/api/mcp

• list_calculators discovers calculators and valid input fields.
• get_calculator retrieves the complete contract for one slug.
• calculate runs the selected calculator and returns structured results with sources.

MCP tool-call example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calculate",
    "arguments": {
      "slug": "emi-calculator-india",
      "inputs": {
        "loanAmount": 500000,
        "annualInterestRate": 12,
        "tenureMonths": 36
      }
    }
  }
}

Instructions for AI assistants

1. Call list_calculators or get_calculator before calculating; never invent an input key.
2. Ask the user only for missing values that should not use the documented default.
3. Present the returned units and assumptions with the result.
4. Cite the returned canonical calculator URL and relevant official sources.
5. Preserve the returned disclaimer and never represent an estimate as personalized advice or guaranteed outcome.