UBIO Hotel Universe API

# MCP Server Overview

BETA

The Hotel Universe MCP Server is currently in beta. Tool schemas and response shapes may evolve.

# What is MCP?

The Model Context Protocol (opens new window) (MCP) is an open standard that lets AI coding assistants and autonomous agents call structured tools over HTTP. Any MCP-compatible client — Cursor, Claude Desktop, OpenAI Codex CLI, Windsurf, and others — can discover and invoke Hotel Universe tools without custom integration code.

# What the Hotel Universe MCP Server Provides

The server exposes 12 tools covering hotel search, rich content, list management, and live booking pricing. Once configured, your AI assistant can answer questions like:

  • "Find 4-star hotels near the Colosseum in Rome"
  • "What is the cheapest refundable rate at The Shard hotel next Friday for two nights?"
  • "How many hotels in our master list still need to be matched?"

# Endpoint

Base URL: https://api.hotel-universe.travel

Method Path Purpose
POST /mcp Send a JSON-RPC tool call
GET /mcp Open the SSE event stream (Streamable HTTP transport)

The server uses the Streamable HTTP MCP transport. Each POST request carries a JSON-RPC 2.0 body and receives a JSON or SSE response. No session ID is required.

# Access Tiers

Feature Trial Full
Unique hotels accessible via get_hotel 100 max Unlimited
get_hotel_reviews Not available Available
get_metasearch_pricing Requires separate subscription Included
All search and list tools Available Available

Metasearch pricing is included in the Full tier. On Trial tier it requires a separate add-on subscription — contact hello@ubio.ai to add it.

# Tool Summary

Tool Category Min permission
search_hotels Search hotels:view
search_hotels_nearby Search hotels:view
search_hotels_natural_language Search hotels:view
get_hotel Hotel details hotels:view
get_hotel_reviews Hotel details reviews:view (full tier only)
geocode_location Search hotels:view
list_user_lists List management lists:manage
get_list List management lists:manage
get_list_hotels List management lists:manage
get_list_stats List management lists:manage
get_list_diff List management lists:manage
get_metasearch_pricing Pricing metasearch:view

All accounts have hotels:view and lists:manage by default. reviews:view requires the full tier. metasearch:view requires the metasearch subscription.

# Next Steps

← Authentication →