दस्तावेज़

एजेंटों के लिए MCP

BharatRouter एक नेटिव MCP server है — एजेंटों को इसका उपयोग करने के लिए किसी रैपर की आवश्यकता नहीं है। किसी भी MCP क्लाइंट (Claude Code, Claude Desktop, या आपका अपना) को स्ट्रीम करने योग्य HTTP पर BharatRouter key को बीयरर टोकन के रूप में कनेक्ट करें:

claude mcp add --transport http bharatrouter https://api.bharatrouter.com/mcp \
  --header "Authorization: Bearer br-..."

यह server स्टेटलेस है (केवल POST /mcp)। मशीन-रीडेबल डिस्कवरी:server card ·llms.txt ·openapi.json.

Tools

रीड tools (कोई भी key)

Tool	यह क्या करता है
`list_models`	INR प्राइसिंग, रेज़िडेंसी और लाइव हेल्थ के साथ कैटलॉग — एजेंट को कंस्ट्रेंट के आधार पर मॉडल चुनने देता है।
`chat`	वन-शॉट कंप्लीशन (नॉन-स्ट्रीमिंग); `optimize`, `provider`, `data_policy`, `upstream_key` को सपोर्ट करता है।
`health`	Gateway हेल्थ स्नैपशॉट।
`get_balance`	प्रीपेड बैलेंस, लो-बैलेंस थ्रेशोल्ड, 30-दिन का खर्च। (org key)
`list_keys`	सीमाओं, बजट और अंतिम-उपयोग के साथ Org API keys। (org key)
`list_byok_keys`	सहेजी गई BYOK keys और उपलब्ध providers। (org key)
`get_fallback_chains`	आपके org की सहेजी गई फेलओवर चेन। (org key)
`list_endpoints`	आपके रजिस्टर्ड BYOE endpoints (keys मास्क्ड)। (org key)
`test_endpoint`	किसी BYOE config को सहेजे बिना उसकी कंप्लायंस-टेस्ट करें। (org key)
`list_collections`	सार्वजनिक Collections रजिस्ट्री। (org key)
`get_collection_health`	किसी मॉनिटर्ड collection के लिए प्रति-स्टेप uptime/p95 latency। (org key)
`create_topup_link`	एक डैशबोर्ड लिंक लौटाता है — मानव भुगतान करता है; एजेंट कभी पैसा नहीं ले जाते। (org key)

मैनेजमेंट (केवल फुल-स्कोप org keys)

Tool	यह क्या करता है
`save_byok_key` / `remove_byok_key`	BYOK provider keys को मैनेज करें।
`set_fallback_chain` / `clear_fallback_chain`	किसी मॉडल की फेलओवर चेन को सहेजें या हटाएँ।
`register_endpoint` / `remove_endpoint`	किसी BYOE endpoint को रजिस्टर या हटाएँ (रजिस्टर कंप्लायंस टेस्ट चलाता है)।
`import_collection`	अपनी रूटिंग में कोई collection इंपोर्ट करें (उपयोग से पहले फोर्क करें)।
`set_monitoring` / `run_monitor_check`	मॉनिटरिंग चालू/बंद करें, या किसी collection के स्टेप्स को अभी कैनरी करें।
`set_monitor_alert` / `remove_monitor_alert`	`error_rate`/`latency_p95` पर कोई अलर्ट जोड़ें या हटाएँ।
`set_key_budget`	किसी key के मासिक ₹ बजट को अपडेट करें।

साथ ही create_ephemeral_key (नीचे), जो किसी भी DB-समर्थित org key के लिए उपलब्ध है। प्रत्येक राइट टूल को एक एक्सप्लिसिट user_confirmed: true आर्ग्यूमेंट की आवश्यकता होती है — अनुबंध यह है कि एजेंट org की स्थिति बदलने से पहले अपने मानव से पूछता है। भुगतान डिज़ाइन के अनुसार लिंक-ओनली हैं।

सब-एजेंटों के लिए एफ़िमेरल keys

create_ephemeral_key एक key बनाता है जो 1–168 घंटों (डिफ़ॉल्ट 24) में समाप्त हो जाती है, जिसमें प्रति दिन 1,000 अनुरोधों (डिफ़ॉल्ट 100) तक की दैनिक सीमा होती है। यह केवल इन्फरेंस के लिए है — यहchat और list_models को कॉल कर सकती है लेकिन किसी भी मैनेजमेंट टूल को नहीं — इसलिए एक ऑर्केस्ट्रेटर org key को उजागर किए बिना सब-एजेंटों या अविश्वसनीय कोड को क्रेडेंशियल्स दे सकता है। पूरा विवरण API keys और सीमाओं पर देखें।

एजेंटों को BharatRouter के माध्यम से रूट क्यों करें?

एक क्रेडेंशियल, कई मॉडल — Krutrim, Sarvam, और ग्लोबल ओपन व फ्रंटियर मॉडल एक key के पीछे, INR में मूल्य-निर्धारित।
रेज़िडेंसी जिसे एजेंट लागू कर सकता है — प्रति कॉलdata_policy: "india_only" पास करें; यह भारत छोड़ने के बजाय फेल-क्लोज़्ड हो जाता है।
खर्च नियंत्रण बिल्ट-इन — प्रति-key बजट और एफ़िमेरल सब-keys का मतलब है कि कोई एजेंट लूप चुपचाप org बैलेंस नहीं जला सकता।