Quick Start

Prerequisites

• An API key provided by Vio (contact your Vio representative)
• MCP Inspector installed (npx @modelcontextprotocol/inspector)

Connect with MCP Inspector

The fastest way to explore the API is with MCP Inspector, an interactive tool for testing MCP servers.

npx @modelcontextprotocol/inspector

1. Set transport to Streamable HTTP
2. Enter the endpoint URL:

   https://mcp.vio.com/mcp?api_key=YOUR_API_KEY

3. Click Connect

Transport: Streamable HTTP with JSON-RPC 2.0

Once connected, you can browse available tools, view their schemas, and call them interactively.

Try it out

After connecting, go to the Tools tab. You'll see two tools: search_hotels and get_hotels.

Search for hotels

Select search_hotels and fill in:

Parameter	Value
queries	["Amsterdam"]
nights	3
rooms	[{"adults": 2}]

Click Run. The response includes hotels with names, ratings, images, prices, and booking URLs from multiple providers.

Fetch hotel details

Copy a hotelId from the search results, then call get_hotels:

Parameter	Value
hotelIds	["<hotelId>"]
include	["review", "room", "faq", "insight"]

Client context

Pass user context via the _meta field on each tool call to enable localized results and geo-aware features:

Field	Purpose	Example
vio/locale	Language and region	en-US, de-DE
vio/userLocation	Country and coordinates	{country: "NL", latitude: 52.37, longitude: 4.90}

Next steps

• Integration Options - Choose the best integration pattern
• API Reference - Detailed tool documentation
• Examples - Working code implementations