कैलकुलेटर API और MCP डॉक्यूमेंटेशन

JSON API एंडपॉइंट

REST कैलकुलेशन का उदाहरण

POST https://www.rupeekit.co.in/api/v1/calculators/personal-loan-true-apr-calculator-india
Content-Type: application/json

{
  "inputs": {
    "principal": 500000,
    "annualInterestRate": 12,
    "tenureMonths": 36,
    "processingFeePercent": 2,
    "gstPercent": 18,
    "insuranceAndOtherUpfront": 5000,
    "advanceEmis": 0
  }
}

application/json को 16 KiB से बड़ी बॉडी के साथ न भेजें। रिक्वेस्ट से हटाए गए इनपुट डॉक्यूमेंटेड डिफ़ॉल्ट का इस्तेमाल करते हैं। अनजान कीज़, नॉन-न्यूमेरिक वैल्यू, आउट-ऑफ़-रेंज वैल्यू, खराब JSON, अनसपोर्टेड मीडिया टाइप और ओवरसाइज़्ड पेलोड को स्ट्रक्चर्ड एरर के साथ रिजेक्ट कर दिया जाता है।

AI टूल्स के लिए MCP

बीटा JSON-RPC HTTP एंडपॉइंट: https://www.rupeekit.co.in/api/mcp

कम्पैटिबिलिटी नोट: यह बीटा अभी MCP प्रोटोकॉल वर्शन 2025-03-26 का विज्ञापन करता है। मौजूदा 2025-11-25 स्पेसिफिकेशन के लिए वेरिफिकेशन और ट्रांसपोर्ट हार्डनिंग पेंडिंग है, इसलिए इसे अभी प्रोडक्शन-SLA इंटीग्रेशन न समझें। अलग Origin वाले ब्राउज़र रिक्वेस्ट रिजेक्ट कर दिए जाते हैं; नॉन-ब्राउज़र क्लाइंट को वह हेडर छोड़ देना चाहिए।

• list_calculators कैलकुलेटर और वैलिड इनपुट फ़ील्ड खोजता है।
• get_calculator एक स्लग के लिए पूरा कॉन्ट्रैक्ट निकालता है।
• calculate चुने हुए कैलकुलेटर को चलाता है और सोर्स के साथ स्ट्रक्चर्ड नतीजे देता है।

MCP टूल-कॉल उदाहरण

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "calculate",
    "arguments": {
      "slug": "emi-calculator-india",
      "inputs": {
        "principal": 500000,
        "annualRate": 12,
        "years": 3
      }
    }
  }
}

AI असिस्टेंट के लिए निर्देश AI असिस्टेंट के लिए निर्देश: ...

1. कैलकुलेट करने से पहले list_calculators या get_calculator कॉल करें; कभी भी इनपुट की न बनाएं।
2. यूज़र से सिर्फ़ उन मिसिंग वैल्यू के बारे में पूछें जिनके लिए डॉक्यूमेंटेड डिफ़ॉल्ट का इस्तेमाल नहीं होना चाहिए।
3. रिज़ल्ट के साथ मिली यूनिट्स और अंदाज़े दिखाएँ।
4. दिए गए कैनोनिकल कैलकुलेटर URL और संबंधित ऑफिशियल सोर्स का हवाला दें।
5. लौटाए गए डिस्क्लेमर को संभाल कर रखें और किसी अनुमान को कभी भी पर्सनलाइज़्ड सलाह या गारंटीड नतीजे के तौर पर न बताएं।