सामग्री पर जाएँ
HotelByte
MCP · Model Context Protocol

एक MCP इंटीग्रेशन।
सभी सप्लायर।

AI एजेंट्स के लिए एकीकृत डिस्ट्रीब्यूशन इंटरफ़ेस: सर्च, लाइव रेट्स और दो-चरण वाली कन्फ़र्म्ड बुकिंग — ऐसे कोट्स के साथ जो अपना प्रमाण खुद साथ रखते हैं, और प्राइसिंग नियम जिन्हें आप कॉन्फ़िगर करते हैं।

एक्सेस का अनुरोध करेंGitHub

इंटीग्रेशन का नया टैक्स

हर होटल सप्लायर अपना अलग MCP ला रहा है।हर इंटीग्रेशन का मतलब है एक और अकाउंट, एक और ID स्पेस, एक और प्राइसिंग ब्लैक बॉक्स — आपका एजेंट हर सप्लायर के लिए वही प्लंबिंग बार-बार बनाता रहता है, जिसका कोई अंत नहीं।

supplier-MCP × N → N × (auth + ids + pricing + ops)
HotelByte

एक बार एग्रीगेट करें

सभी सप्लायर कनेक्टर (Dida, Tourmind, Yalago, Hotelbeds, ...) एक ही MCP टूल सरफ़ेस के पीछे काम करते हैं। कल कोई सप्लायर अपना MCP लाए, तो वह हमारे लिए बस एक और अपस्ट्रीम लेन होगा — आपके लिए एक और इंटीग्रेशन नहीं।

your-agent → /mcp → सभी सप्लायर

जुड़ने के तीन रास्ते

वही टूल सरफ़ेस, वही कॉन्ट्रैक्ट — वह रास्ता चुनें जो आपके एजेंट के चलने की जगह से मेल खाता हो।

लोकल गेटवे

आपके नियंत्रण वाली मशीनें (Claude Code / Cursor / Codex): hbcli एक लोकल stdio गेटवे चलाता है; key लोकल क्रेडेंशियल स्टोर में रहती है और एजेंट कॉन्फ़िग में कोई सीक्रेट नहीं होता।

{ "mcpServers": { "hotelbyte":
  { "command": "hbcli", "args": ["mcp", "serve"] } } }

स्टैटिक key

होस्टेड प्लैटफ़ॉर्म और CI: लंबी निष्क्रियता अवधि वाली स्टैटिक key बनाएँ (सिर्फ़ 30 दिन इस्तेमाल न होने पर एक्सपायर होती है; कुल अवधि सर्वर की ओर से 365 दिन तक सीमित) और उसे सीधे कॉन्फ़िग में डालें।

$ hbcli mcp token
{ "type": "http", "url": "https://…/mcp",
  "headers": { "Authorization": "Bearer <token>" } }

OAuth 2.1 प्लैटफ़ॉर्म कनेक्टर

Claude web / ChatGPT कनेक्टर: स्टैंडर्ड RFC 9728/8414 डिस्कवरी, डायनेमिक रजिस्ट्रेशन और PKCE। कंसेंट पेज हमारी ओर होस्ट होता है; टोकन एक प्लैटफ़ॉर्म JWT है।

GET /.well-known/oauth-protected-resource
→ 401 WWW-Authenticate: resource_metadata=…

एक मिनट में अपना एजेंट कनेक्ट करें

हर कार्ड एक ही कमांड से शुरू होता है — hbcli mcp setup <client> — जो कॉन्फ़िग लिख देता है (या आपका टोकन और पेस्ट करने के लिए सटीक फ़ील्ड्स दिखाता है) और कनेक्शन वेरिफ़ाई करता है। राइट टूल्स के लिए अब भी स्पष्ट पुष्टि ज़रूरी है।

बिना साइनअप — अभी आज़माएँ

hbcli mcp setup <client> --demo अभी काम करता है — साझा सैंडबॉक्स पहचान CLI में ही बनी हुई है, न अकाउंट चाहिए, न क्रेडेंशियल। सेकंडों में असली होटल सर्च करें; जब ज़्यादा चाहिए, अपने खुद के टेनेंट पर अपग्रेड करें।

अपना खुद का टेनेंट लाएँ

पोर्टल पर रजिस्टर करें, API क्रेडेंशियल जारी करें, फिर hbcli auth set-credentials && hbcli mcp setup चलाएँ — आपके सप्लायर नियम, आपका मार्कअप, आपके ग्राहक। एक यूज़र दोनों पहचानें साथ रख सकता है।

Claude CodeCLI

एक लाइन में रिमोट HTTP; या लोकल stdio गेटवे, ताकि keys नेटवर्क पर न जाएँ।

hbcli mcp setup claude-code
# runs: claude mcp add hotelbyte --scope user -- hbcli mcp serve
# (no claude on PATH? prints a paste-ready snippet instead)
CursorIDE

ग्लोबल ~/.cursor/mcp.json में, या हर प्रोजेक्ट के लिए .cursor/mcp.json में।

hbcli mcp setup cursor
# merges hotelbyte into ~/.cursor/mcp.json
# (your other MCP servers are preserved)
ChatGPTConnector

कस्टम प्लगइन (डेवलपर मोड): MCP URL + API key auth — OAuth नहीं, API key चुनें, वरना प्रोब पर ही क्रिएशन फ़ेल हो जाएगा।

hbcli mcp setup chatgpt
# prints your token + the exact form fields:
#   Server URL:     https://api-test.hotelbyte.com/mcp
#   Authentication: API key   ← NOT OAuth
#   Header: Authorization · Value: Bearer <token>
GrokConnector · xAI

Grok कनेक्टर — grok.com पर कस्टम MCP सर्वर, वेब और मोबाइल दोनों पर।

hbcli mcp setup grok
# writes [mcp_servers.hotelbyte] into ~/.grok/config.toml
# web/mobile connectors instead: grok.com/connectors → Custom
#   (hbcli mcp setup generic prints a token for it)
CodexCLI

~/.codex/config.toml — stdio गेटवे।

hbcli mcp setup codex
# appends [mcp_servers.hotelbyte] to ~/.codex/config.toml
AntigravityIDE · Google

Google का एजेंट-फ़र्स्ट IDE (I/O 2026 में 2.0) — नेटिव MCP, ब्राउज़र कंट्रोल, एजेंट मैनेजर।

hbcli mcp setup generic   # token + fields, then paste into mcp_config.json
{ "mcpServers": { "hotelbyte":
  { "command": "hbcli", "args": ["mcp", "serve"] } } }
# note: no "type" field in Antigravity configs
Devin DesktopAgent · Cognition

Cognition का ऑटोनॉमस एजेंट डेस्कटॉप — पहले Windsurf (जून 2026)।

hbcli mcp setup generic   # token + URL
# Devin → Settings → MCP Marketplace → Add Your Own → paste
# (needs the Manage MCP Servers permission)
Claude Desktop · WebConnectors

Settings → Extensions / Connectors → Add custom connector: एंडपॉइंट URL पेस्ट करें, auth = Bearer। डायरेक्टरी-स्टाइल प्लैटफ़ॉर्म कनेक्टर ऊपर बताए गए OAuth 2.1 डिस्कवरी फ़्लो का इस्तेमाल करते हैं।

hbcli mcp setup claude-connectors
# prints your token, then:
#   Add custom connector → paste URL → auth: Bearer <token>
# order.book / order.cancel always require confirm=true
VS Code · CopilotIDE

वर्कस्पेस फ़ाइल .vscode/mcp.json (stdio टाइप)।

hbcli mcp setup vscode
# writes .vscode/mcp.json in the current folder (servers key)
कोई भी एजेंट · खुद बनाया हुआJSON-RPC

किसी SDK की ज़रूरत नहीं: streamable-http पर MCP बस तीन JSON-RPC कॉल्स है। किसी भी भाषा, फ़्रेमवर्क या रनटाइम से काम करता है — आपके खुद बनाए एजेंट्स से भी। आधिकारिक SDK (Python mcp, TypeScript @modelcontextprotocol/sdk) उसी URL पर पॉइंट करते हैं।

POST https://api-test.hotelbyte.com/mcp
Authorization: Bearer <token> · Accept: application/json, text/event-stream

# 1) initialize — protocol version + client info
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
  "protocolVersion":"2025-06-18","capabilities":{},
  "clientInfo":{"name":"my-agent","version":"1.0"}}}

# 2) tools/list — discover the tools and their schemas
{"jsonrpc":"2.0","id":2,"method":"tools/list"}

# 3) tools/call — search hotels in Dubai for two adults
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{
  "name":"hotel.list","arguments":{
    "destinationName":"Dubai","checkIn":"2026-11-20","checkOut":"2026-11-22",
    "rooms":[{"adultCount":2}]}}}

हर रिज़ल्ट { response, evidence } लौटाता है — रिकॉन्सिलिएशन के लिए traceId संभालकर रखें। order.book के लिए पहले check_avail और confirm=true ज़रूरी है; रीट्राई में वही customerReferenceNo इस्तेमाल होता है।

टोकन का स्रोत: hbcli mcp token (स्टैटिक key, 30 दिन इस्तेमाल न होने पर एक्सपायर) या पोर्टल से जारी कोई भी टिकट। यहाँ कभी सप्लायर क्रेडेंशियल पेस्ट न करें — टोकन आपकी HotelByte पहचान है।

टूल सरफ़ेस

टूल्स पूरे ट्रांज़ैक्शन को कवर करते हैं। राइट टूल्स तभी मौजूद होते हैं जब कोई डिप्लॉयमेंट उन्हें सक्षम करे — और स्पष्ट पुष्टि के बिना कभी नहीं चलते।

hotel.listरीडहोटल सर्च करें; पूरे फ़्लो में इस्तेमाल होने वाला sessionId लौटाता है
hotel.ratesरीडरूम टाइप और लाइव रेट्स, रिफ़ंड नियमों और कैंसलेशन फ़ीस के साथ
hotel.check_availरीडदो में से पहला चरण: बुकिंग से पहले इन्वेंटरी और कीमत दोबारा वेरिफ़ाई करें
order.queryरीडऑर्डर स्टेटस और कन्फ़र्मेशन नंबर की जानकारी
order.bookराइट · पुष्टिconfirm=true ज़रूरी; customerReferenceNo ही idempotency key है
order.cancelराइट · पुष्टिconfirm=true ज़रूरी; कैंसलेशन पर शुल्क लग सकता है और इसे वापस नहीं लिया जा सकता

प्रमाण साथ रखने वाले कोट्स

हर टूल रिज़ल्ट { response, evidence } लौटाता है। response, HTTP API जैसा ही होता है; evidence एनवेलप हर कोट को उद्धृत करने योग्य और ट्रेस करने योग्य बनाता है — traceId सपोर्ट को दें, और वे ठीक उसी कोट को दोबारा बना सकते हैं।

{
  "response": { "list": [ … ] },
  "evidence": {
    "tool": "hotel.list",
    "traceId": "20261003…",
    "sessionId": "S-2026…",
    "currency": "USD"
  }
}

सख़्त कन्फ़र्मेशन सीमा वाली बुकिंग

  1. hotel.rates — यूज़र को कीमत, रिफ़ंड नियम और कैंसलेशन फ़ीस दिखाएँ।
  2. hotel.check_avail — सटीक रेट दोबारा वेरिफ़ाई करें; लाइव कीमतें बदल सकती हैं।
  3. confirm=true के साथ order.book — सिर्फ़ यूज़र की सहमति के बाद। इससे कम कुछ भी हो तो ऑर्डर फ़्लो शुरू होने से पहले ही सर्वर उसे अस्वीकार कर देता है।
  4. रीट्राई में वही customerReferenceNo इस्तेमाल होता है — key के आधार पर idempotent; डुप्लिकेट एक सॉफ़्ट चेतावनी के रूप में दिखते हैं, जिसकी आपको पुष्टि करनी होती है।

अभी सैंडबॉक्स आज़माएँ

UAT · no SLA

सैंडबॉक्स एंडपॉइंट सार्वजनिक रूप से उपलब्ध है। कोई भी MCP क्लाइंट वैध टिकट के साथ इस पर initialize कर सकता है:

curl -X POST https://api-test.hotelbyte.com/mcp \
  -H "Authorization: Bearer <ticket>" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

प्रोक्योरमेंट का नज़रिया

AI डिस्ट्रीब्यूशन इंटरफ़ेस का मूल्यांकन करते समय क्या जाँचें

वेंडर-न्यूट्रल। तीन सवाल जो एक एग्रीगेशन लेयर को किसी और सिंगल-इन्वेंटरी MCP से अलग करते हैं — और हर बात को मौके पर कैसे साबित करें।

What to check

Is this yet another single-inventory supplier MCP

What we do

No. We are the aggregation layer: every supplier connector sits behind one tool surface, and every new supplier MCP is just another upstream lane for us.

How to verify

Run hotel.list for one destinationName and check whether results span multiple suppliers with a true minimum price.

What to check

Can the agent accidentally fire a real booking

What we do

No. order.book requires confirm=true (after the user consents to the exact price, dates and cancellation policy); missing or false confirm is rejected server-side before the order flow starts.

How to verify

Call order.book without confirm and check for an explicit rejection and zero side effects.

What to check

How transparent is pricing

What we do

Every quote carries an evidence envelope (traceId / sessionId / currency / time) that is citable and traceable; cost and markup composition opens in tiers via configurable rules, not a black box.

How to verify

Take the traceId from a response and ask the vendor to reconstruct the full chain of that one quote.