Lumaktaw sa nilalaman
HotelByte
MCP · Model Context Protocol

Isang MCP integration.
Lahat ng supplier.

Ang unified distribution interface para sa mga AI agent: search, live rates at two-phase na kumpirmadong booking — kasama ang mga quote na may sariling ebidensya at mga pricing rule na kayo ang nagko-configure.

Humiling ng accessGitHub

Ang bagong integration tax

Kanya-kanyang MCP na ang inilalabas ng mga hotel supplier. Bawat integration ay panibagong account, panibagong ID space, panibagong pricing black box — paulit-ulit na binubuo ng inyong agent ang parehong plumbing para sa bawat supplier, nang walang katapusan.

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

Isang beses lang mag-aggregate

Lahat ng supplier connector (Dida, Tourmind, Yalago, Hotelbeds, ...) ay nasa likod ng iisang MCP tool surface. Kapag naglabas bukas ang isang supplier ng sarili nitong MCP, dagdag na upstream lane lang ito para sa amin — hindi dagdag na integration para sa inyo.

your-agent → /mcp → lahat ng supplier

Tatlong paraan para makapasok

Parehong tool surface, parehong kontrata — piliin ang path na tugma sa kung saan tumatakbo ang inyong agent.

Local gateway

Mga makinang kontrolado ninyo (Claude Code / Cursor / Codex): nagpapatakbo ang hbcli ng local stdio gateway; nananatili ang key sa local credential store at walang anumang secret sa mga agent config.

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

Static key

Mga hosted platform at CI: gumawa ng long-idle na static key (nag-e-expire lang pagkatapos ng 30 idle na araw; ang absolute lifetime ay naka-cap sa 365 araw sa server) at ilagay ito diretso sa config.

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

OAuth 2.1 platform connectors

Claude web / ChatGPT connectors: standard na RFC 9728/8414 discovery, dynamic registration at PKCE. Naka-host sa amin ang consent page; ang token ay isang platform JWT.

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

Ikonekta ang inyong agent sa loob ng isang minuto

Nagsisimula ang bawat card sa iisang command — hbcli mcp setup <client> — na nagsusulat ng config (o nagpi-print ng inyong token at ng eksaktong mga field na ipe-paste) at nagve-verify ng koneksyon. Kailangan pa rin ng tahasang kumpirmasyon ang mga write tool.

Walang signup — subukan na ngayon

Gumagana na ngayon ang hbcli mcp setup <client> --demo — built-in na sa CLI ang shared sandbox identity, kaya walang account at walang credentials na kailangan. Maghanap ng totoong hotels sa loob ng ilang segundo; lumipat sa sarili ninyong tenant anumang oras na kailangan ninyo ng higit pa.

Gamitin ang sarili ninyong tenant

Mag-register sa portal, mag-issue ng API credentials, saka patakbuhin ang hbcli auth set-credentials && hbcli mcp setup — inyong supplier rules, inyong markup, inyong mga customer. Puwedeng hawakan ng iisang user ang dalawang identity.

Claude CodeCLI

Isang linya para sa remote HTTP; o ang local stdio gateway para hindi dumaan sa network ang inyong mga key.

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

Global sa ~/.cursor/mcp.json, o per-project sa .cursor/mcp.json.

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

Custom plugin (developer mode): MCP URL + API-key auth — piliin ang API key, hindi OAuth, kung hindi ay babagsak ang pag-create sa probe.

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 connectors — custom MCP server sa grok.com, para sa web at mobile.

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 — ang stdio gateway.

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

Ang agent-first IDE ng Google (2.0 sa I/O 2026) — native MCP, browser control, agent manager.

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

Ang autonomous agent desktop ng Cognition — dating Windsurf (Hunyo 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: i-paste ang endpoint URL, auth = Bearer. Ang mga directory-style na platform connector ay gumagamit ng OAuth 2.1 discovery flow sa itaas.

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

Workspace file na .vscode/mcp.json (stdio type).

hbcli mcp setup vscode
# writes .vscode/mcp.json in the current folder (servers key)
Kahit anong agent · sariling gawaJSON-RPC

Hindi kailangan ng SDK: ang MCP over streamable-http ay tatlong JSON-RPC call lang. Gumagana sa kahit anong language, framework o runtime — pati sa mga agent na kayo mismo ang gumawa. Ang mga opisyal na SDK (Python mcp, TypeScript @modelcontextprotocol/sdk) ay nakaturo sa parehong 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}]}}}

Bawat result ay nagbabalik ng { response, evidence } — itabi ang traceId para sa reconciliation. Kailangan muna ng order.book ang check_avail at confirm=true; ginagamit muli ng mga retry ang customerReferenceNo.

Pinagmulan ng token: hbcli mcp token (static key, nag-e-expire pagkatapos ng 30 idle na araw) o kahit anong ticket na inisyu ng portal. Huwag kailanman mag-paste ng supplier credentials dito — ang token ang inyong HotelByte identity.

Ang tool surface

Saklaw ng mga tool ang buong transaksyon. Umiiral lang ang mga write tool kapag in-enable ito ng deployment — at hindi kailanman tumatakbo nang walang tahasang kumpirmasyon.

hotel.listreadMaghanap ng hotels; ibinabalik ang sessionId na ginagamit sa buong flow
hotel.ratesreadMga room type at live rates, kasama ang refundability at cancellation fees
hotel.check_availreadPhase 1 ng dalawa: i-verify muli ang inventory at presyo bago mag-book
order.queryreadStatus ng order at paghahanap ng confirmation number
order.bookwrite · kumpirmasyonKailangan ng confirm=true; ang customerReferenceNo ang idempotency key
order.cancelwrite · kumpirmasyonKailangan ng confirm=true; puwedeng may bayad at hindi na maibabalik ang cancellation

Mga quote na may kasamang ebidensya

Bawat tool result ay nagbabalik ng { response, evidence }. Kapareho ng HTTP API ang response; ginagawang citable at traceable ng evidence envelope ang bawat quote — ibigay ang traceId sa support at mabubuo nilang muli ang mismong quote na iyon.

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

Mga booking na may mahigpit na confirmation boundary

  1. hotel.rates — ipakita sa user ang presyo, refundability at cancellation fees.
  2. hotel.check_avail — i-verify muli ang eksaktong rate; gumagalaw ang live prices.
  3. order.book na may confirm=true — pagkatapos lang pumayag ang user. Anumang kulang dito ay tinatanggihan ng server bago magsimula ang order flow.
  4. Ginagamit muli ng mga retry ang customerReferenceNo — idempotent ayon sa key; lumalabas ang mga duplicate bilang soft warning na kailangan ninyong kumpirmahin.

Subukan na ang sandbox

UAT · no SLA

Publicly reachable ang sandbox endpoint. Puwedeng mag-initialize dito ang kahit anong MCP client gamit ang valid na ticket:

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"}'

Pananaw ng procurement

Ano ang dapat suriin kapag nag-e-evaluate ng AI distribution interface

Vendor-neutral. Tatlong tanong ang naghihiwalay sa isang aggregation layer mula sa isa pang single-inventory na MCP — at kung paano ito mapapatunayan agad.

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.