दस्तऐवज

एजंटांसाठी 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 बॅलन्स जाळू शकत नाही.