How do I connect my AI agent to VistaLink?

Add the VistaLink MCP server to your agent's configuration with the URL https://api.vistalink.com/mcp and your Bearer token. Your agent discovers search_hotels, chat_about_hotels, get_hotel_details, and call_hotel tools automatically. Any MCP-compatible client works - Claude, Cursor, or custom agents.

What is the VistaLink MCP server?

VistaLink's MCP (Model Context Protocol) server provides AI agents with direct access to hotel search, natural language chat, detailed hotel profiles, and voice booking capabilities. It uses HTTP Streamable transport - no npm package required.

How much does the VistaLink API cost?

Free tier: 50 requests/month in test environment. Pro: pay-as-you-go starting at $0.005/call with 120 requests/minute. Enterprise: custom pricing with dedicated support.

Does VistaLink have a REST API?

Yes. All capabilities available via MCP are also exposed as REST endpoints at api.vistalink.com. 16 endpoints covering hotel search, chat, hotel details, voice calls, guest profiles, API key management, usage analytics, session history, and billing.

What hotel data does the VistaLink API return?

The API returns hotel profiles with photos, guest reviews, room types, amenities, pricing, star ratings, review scores, location data, and proximity to landmarks. 350,000+ properties are indexed across 14 visual dimensions with 18M+ reviews analyzed.

What is the Model Context Protocol (MCP)?

MCP is an open protocol for connecting AI agents to external tools and data sources. VistaLink's MCP server lets any compatible AI agent - Claude, Cursor, or custom agents - discover and call hotel search, chat, detail, and voice booking tools without REST boilerplate. Connect at api.vistalink.com/mcp with a Bearer token.

Can I use the VistaLink API to build a travel app?

Yes. The API is designed for developers building AI-powered travel products. Use search_hotels for structured queries, chat_about_hotels for natural language search with multi-turn sessions, get_hotel_details for full property profiles, and call_hotel for voice negotiation. The free tier lets you test with 50 requests/month before going to production.

Does the VistaLink API support voice booking?

Yes. The call_hotel tool triggers VistaLink's Caladan voice infrastructure to call a hotel, negotiate rates, or manage bookings on behalf of the user. It requires a hotel_id and phone_number from get_hotel_details. Voice booking is available on Pro tier and above.

DEVELOPER PLATFORM

BuildonOurInfrastructure.

Images, reviews, rooms, amenities, proximity to landmarks - every detail about every hotel, accessible to your AI agent through a single service. Go live in minutes.

Get API Key

tool_use

prompt

"Hotels close to Santa Maria delle Grazie in Milan with big windows and under €300"

{
  "name": "search_hotels",
  "input": {
    "location": "Santa Maria delle Grazie, Milan",
    "amenities": "large windows,natural light",
    "budget_max": 300,
    "currency": "EUR"
  }
}

QUICK START

Get Started in Minutes.

Three steps to give your AI agent hotel intelligence.

Get Your API Key

Request a developer account and receive your API key. Keys use the format vl_test_* (test) or vl_live_* (production).

Connect via MCP or REST

Add the VistaLink MCP server to your agent's config, or call the REST API directly at /v1/*.

Your Agent is Ready

Your AI agent can now search hotels, access photos, reviews, room types, amenities, and pricing - all autonomously.

{
  "mcpServers": {
    "vistalink": {
      "url": "https://api.vistalink.com/mcp",
      "headers": {
        "Authorization": "Bearer vl_test_..."
      }
    }
  }
}

AUTHENTICATION

Authentication and Rate Limits

Authenticate using a Bearer token in the Authorization header. API keys use the format vl_test_* (test) or vl_live_* (production).

vl_test_*

Test environment for prototyping. 50 requests per month.

vl_live_*

Production environment. Rate limits and usage tracking are active.

REST API

// REST API - Bearer token in Authorization header
curl -X POST https://api.vistalink.com/v1/search \
  -H "Authorization: Bearer vl_test_..." \
  -H "Content-Type: application/json" \
  -d '{ "city": "Paris" }'

Response Headers

Every API response includes rate limit and quota headers so your integration can adapt proactively.

Header	Description
X-RateLimit-Limit	Maximum requests allowed per minute
X-RateLimit-Remaining	Requests remaining in the current window
X-RateLimit-Reset	Unix timestamp when the rate limit window resets
X-Monthly-Quota-Limit	Monthly request quota for your tier
X-Monthly-Quota-Remaining	Requests remaining this billing period
X-Monthly-Quota-Reset	ISO 8601 date when the monthly quota resets

Latency & Timeouts

Set your client timeout based on the endpoint. Chat runs a multi-agent pipeline with LLM calls; search and hotel detail are direct database lookups.

Endpoint	Typical Latency	Recommended Timeout
POST /v1/chat	10 - 30 s	120 s
POST /v1/search	< 2 s	30 s
GET /v1/hotels/{id}	< 1 s	30 s
POST /v1/call	immediate (202)	10 s

Voice calls are asynchronous - /v1/call returns 202 immediately. Poll /v1/call/{id}/status for results.

Plans & Rate Limits

Start free, scale as you grow. Rate limits and pricing depend on your plan.

FREE

TEST

Monthly

50 req

Per minute

5 req

✓search_hotels
✓chat_about_hotels
✓get_hotel_details
✓MCP + REST access

Get Started

PRO

PRODUCTION

Pay-as-you-go

Per minute

120 req

Monthly

1,000 req

search_hotels	$0.01
get_hotel_details	$0.005
chat_about_hotels	$0.03
call_hotel	$0.50+

call_hotel: $0.50 flat up to 10 min + $0.05/min

✓All Free tools + call_hotel
✓Usage analytics
✓Priority support

Get Started

ENTERPRISE

PRODUCTION

Custom

Per minute

500 req

Monthly

Unlimited

✓All Pro features
✓Volume discounts
✓Custom call pricing
✓Dedicated support + SLA

Contact Sales

CAPABILITIES

Four Tools, Two Interfaces.

Search, chat, inspect, and call - all available via MCP or REST. Plus 2 MCP resources and 2 guided prompts.

01FAST PATH

search_hotels

Structured search by location, dates, budget, amenities, and vibe. No LLM required - results in milliseconds.

View Reference→

02MULTI-TURN

chat_about_hotels

Natural language hotel discovery. Matches on vibe, guest sentiment, and aesthetics with follow-up sessions.

View Reference→

03FULL PROFILE

get_hotel_details

Complete hotel data - photos, reviews, rooms, amenities, pricing, and proximity to points of interest.

View Reference→

04VOICE AI

call_hotel

AI agent calls hotels to negotiate rates, confirm bookings, or handle cancellations. Returns transcript and audio.

View Reference→

MCP PROTOCOL

How It Works.

The Model Context Protocol lets AI agents interact with VistaLink directly. Connect any MCP-compatible client - Claude, Cursor, custom agents - and tap into a proprietary engine that matches hotels by vibe, guest sentiment, and visual aesthetics.

Why MCP?

The Model Context Protocol is an open standard for agent-to-agent communication. Instead of building custom integrations for every AI platform, MCP provides a single interface that works everywhere. Your AI agent connects to the VistaLink MCP server and gets full access to hotel photos, guest reviews, room types, amenities, pricing, and location data - with tool discovery, structured inputs, and typed responses built in.

Discover

Your agent connects to the VistaLink MCP server and discovers available tools - search, chat, hotel details, and voice calls.

Invoke

When your agent needs hotel data, it calls the appropriate tool with structured input. The MCP protocol handles transport and serialization.

Receive

The MCP server processes the request and returns structured results directly to your agent. Type-safe, predictable, and ready to use.

Connection Config

Add the VistaLink MCP server to your client configuration. We use HTTP Streamable transport - no npm package required:

mcp_config.json

{
  "mcpServers": {
    "vistalink": {
      "url": "https://api.vistalink.com/mcp",
      "headers": {
        "Authorization": "Bearer vl_test_..."
      }
    }
  }
}

MCP Resources

Resources expose read-only data your agent can reference without making tool calls. They're ideal for context injection and grounding.

hotel://{hotel_id}

Full hotel profile as a URI template. Returns name, description, star rating, amenities, images, rooms, pricing, reviews, and location data. All prices in EUR.

amenities://catalog

Complete list of supported amenity codes with human-readable labels. Use this to validate amenity filters before searching.

MCP Prompts

Guided prompts that structure complex workflows. Your agent can invoke these to get step-by-step instructions for common tasks.

search_wizard

Generates a structured search plan from natural-language criteria. Accepts destination, dates, budget, guests, star rating, amenities, vibe, point of interest, and free-form preferences.

comparison_template

Given a list of hotel IDs, produces step-by-step instructions for your agent to fetch details and build a side-by-side comparison table.

Agent Integration Guide

Copy these instructions and paste them into your AI coding assistant (Claude, ChatGPT, Cursor, etc.) to integrate VistaLink in minutes.

vistalink-api-instructions.md

# VistaLink API - Integration Guide

VistaLink gives AI agents access to 350,000+ hotels with reviews, photos, pricing, amenities, and voice booking. Two ways to integrate: MCP (recommended for AI agents) or REST.

## Authentication

All requests require a Bearer token in the Authorization header:

```
Authorization: Bearer vl_live_YOUR_API_KEY
```

Key format: `vl_live_*` (production) or `vl_test_*` (test).

## MCP Configuration

Add to your MCP client config (Claude, Cursor, etc.):

```json
{
...

TOOL REFERENCE

Tool Reference.

Four tools that give your agent access to hotel data and voice calling - available via MCP or REST.

TOOLsearch_hotels

Search hotels by location, dates, budget, amenities, and vibe. Returns ranked results with images, guest reviews, room types, pricing, and proximity to landmarks.

Input Schema

Parameter	Type	Required	Description
city	string	optional	City name (e.g., "Paris", "Milan")
country	string	optional	ISO 3166-1 alpha-2 country code for disambiguation (e.g., "GB", "US", "FR"). Helps resolve ambiguous city names like London (GB vs US) or Paris (FR vs US).
latitude	float	optional	Search center latitude
longitude	float	optional	Search center longitude
radius_meters	integer	optional	Search radius in meters
check_in	string	optional	Check-in date (YYYY-MM-DD)
check_out	string	optional	Check-out date (YYYY-MM-DD)
guests	integer	optional	Number of guests
rooms	integer	optional	Number of rooms
budget_min	float	optional	Minimum budget per night
budget_max	float	optional	Maximum budget per night
currency	string	optional	Currency code (default: EUR). Prices will be converted to this currency when available.
amenities	string[]	optional	Amenity codes (e.g., ["wifi", "pool"])
vibe	string[]	optional	Vibe tags (e.g., ["romantic", "quiet"])
hotel_name	string	optional	Search by hotel name (partial match)
limit	integer	optional	Max results to return (default: 20, max: 50)
include_rates	boolean	optional	Fetch live room-level rates from booking sources (adds ~30-45s). Returns room names, sizes, amenities, and per-offer pricing.

Note: When using the MCP tool, pass amenities and vibe as comma-separated strings (e.g. "wifi,pool"). The REST API accepts JSON arrays.

Example

{
  "name": "search_hotels",
  "input": {
    "city": "Tokyo",
    "country": "JP",
    "check_in": "2026-04-15",
    "check_out": "2026-04-18",
    "guests": 2,
    "vibe": ["modern", "design-forward"]
  }
}

Response Fields (each hotel in the hotels array)

Field	Type	Nullable	Description
hotel_id	string	no	Unique hotel identifier (UUID)
name	string	no	Hotel display name
city	string	yes	City name
country	string	yes	Country name
address	string	yes	Full street address
star_rating	float	yes	Star rating (1-5, supports half stars)
review_score	float	yes	Guest review score (0-10 scale)
review_count	integer	yes	Total number of guest reviews
latitude	float	yes	GPS latitude (WGS84)
longitude	float	yes	GPS longitude (WGS84)
amenities	string[]	no	Hotel-level amenity codes (e.g., "wifi", "pool", "spa", "gym")
price	object	yes	Most recently scraped nightly rate (see Price Object below). Null if no rate data available.
images	object[]	no	Up to 10 curated images. Each has url (string) and label (string: exterior, room, lobby, dining, amenities).
review_highlight	string	yes	Short guest review snippet (max 100 chars) from a top-rated review
guest_insights	object	yes	Aggregated guest sentiment. highlights: string[], aspects: array of {type, summary, sentiment (0-1), quote}.
description	string	yes	Hotel description
hotel_type	string	yes	Property type (e.g., "hotel", "resort", "hostel", "apartment")
website_url	string	yes	Link to the hotel's own website
rates	object[]	yes	Room-level live rates (only when include_rates=true). Each has room_name, amenities, room_size_sqm, room_description, and offers array.

Price Object

Prices reflect the most recently scraped rates from booking sources. When the hotel's native currency differs from your requested currency parameter, the converted amount is included automatically.

Field	Type	Nullable	Description
nightly_rate	float	no	Nightly rate in the scraped currency
currency	string	no	ISO 4217 currency code of the scraped rate (e.g., EUR, JPY, USD)
as_of_checkin	string	yes	Check-in date (YYYY-MM-DD) the rate was scraped for
as_of_checkout	string	yes	Check-out date (YYYY-MM-DD) the rate was scraped for
user_currency	string	yes	Your requested currency code (only present when it differs from the scraped currency)
user_currency_rate	float	yes	Nightly rate converted to your requested currency (only present when user_currency is set)

TOOLchat_about_hotels

Describe what you want in natural language. The Engine matches on vibe, guest sentiment, and visual aesthetics - returning hotels that genuinely fit. Supports multi-turn sessions for follow-ups and comparisons.

Input Schema

Parameter	Type	Required	Description
message	string	required	The user's message or question about hotels (max 4000 chars)
session_id	string	optional	Existing session UUID to continue a conversation. Omit to start a new session.
currency	string	optional	Currency code for prices (default: EUR)
context	object	optional	Guest preferences object (e.g., travel_style, purpose, accessibility, loyalty_programs, dietary)

Example

{
  "name": "chat_about_hotels",
  "input": {
    "message": "Find me a romantic boutique hotel in Paris with a rooftop bar",
    "currency": "EUR"
  }
}

The response includes a session_id for multi-turn conversations, a natural language message, and a hotels array using the same schema as search_hotels - see the Response Fields table above. The usage object reports latency and cost per call.

TOOLget_hotel_details

Full hotel profile - description, full photo gallery (up to 50 images), guest reviews, room types with sizes and amenities, live pricing, and aggregated guest sentiment analysis.

Input Schema

Parameter	Type	Required	Description
hotel_id	string	required	The hotel's unique identifier from search results
currency	string	optional	Currency code for prices (default: EUR). If the scraped rate is in a different currency, a converted amount is included.

Example

{
  "name": "get_hotel_details",
  "input": {
    "hotel_id": "a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6",
    "currency": "EUR"
  }
}

Response Fields

Field	Type	Nullable	Description
hotel_id	string	no	Unique hotel identifier (UUID)
name	string	no	Hotel display name
description	string	yes	Full hotel description
city	string	yes	City name
country	string	yes	Country name
address	string	yes	Full street address (street, city, postcode, country)
star_rating	float	yes	Star rating (1-5, supports half stars)
review_score	float	yes	Guest review score (0-10 scale)
review_count	integer	yes	Total number of guest reviews
latitude	float	yes	GPS latitude (WGS84)
longitude	float	yes	GPS longitude (WGS84)
amenities	string[]	no	Hotel-level amenity codes
images	object[]	no	Up to 50 curated images. Each has url, category (exterior, room, lobby, dining, amenities), caption, width, height.
rooms	object[]	no	Room types. Each has room_id, name, description, size_sqm, max_occupancy, amenities[].
price	object	yes	Most recently scraped nightly rate (see Price Object). Null if no rate data available.
reviews	object[]	no	Top guest reviews (up to 10). Each has body (string) and rating (float, 0-10).
guest_insights	object	yes	Aggregated guest sentiment with highlights and aspect-level analysis.
website_url	string	yes	Link to the hotel's own website
phone_number	string	yes	Hotel phone number in E.164 format
hotel_type	string	yes	Property type (e.g., "hotel", "resort", "hostel", "apartment")

The price object uses the same format as search results - see the Price Object table under search_hotels.

VOICEcall_hotel

Voice AI agent that calls hotels to negotiate rates, confirm or cancel bookings. Returns a call ID - use the REST endpoints GET /v1/call/{id}/status and GET /v1/call/{id}/results to retrieve transcript, audio recording, and structured outcomes.

Input Schema

Parameter	Type	Required	Description
hotel_id	string	required	The hotel's unique identifier
phone_number	string	required	Phone number in E.164 format (e.g., "+39055123456")
hotel_name	string	required	Name of the hotel to call
scenario	string	optional	Call scenario (default: "hotel_negotiation")
guest_first_name	string	optional	Guest first name
guest_last_name	string	optional	Guest last name
guest_email	string	optional	Guest email address
check_in_date	string	optional	Check-in date (YYYY-MM-DD)
check_out_date	string	optional	Check-out date (YYYY-MM-DD)
number_of_rooms	integer	optional	Number of rooms to book
number_of_people	integer	optional	Number of guests
booking_price	float	optional	Current booking price to negotiate against
room_type	string	optional	Room type (e.g., double, suite)
currency	string	optional	Currency code (default: EUR)
language	string	optional	Language for the call (default: en)
confirmation_number	string	optional	Booking confirmation number (for confirm/cancel)
special_requests	string	optional	Special requests for the hotel
caller_instructions	string	optional	Free-form instructions for the AI caller

Scenarios

Set scenario to control the call type:

hotel_negotiationNegotiate rates below OTA prices

hotel_confirm_bookingConfirm an existing booking

hotel_cancel_bookingCancel a booking

restaurant_bookingBook a restaurant reservation

restaurant_cancel_bookingCancel a restaurant reservation

Example

{
  "name": "call_hotel",
  "input": {
    "hotel_id": "d9e8f7a6-5b4c-3d2e-1f0a-b9c8d7e6f5a4",
    "phone_number": "+39055123456",
    "hotel_name": "Hotel & Palazzo",
    "scenario": "hotel_negotiation",
    "check_in_date": "2026-04-15",
    "booking_price": 280,
    "currency": "EUR"
  }
}

REST ENDPOINTS

REST Endpoints.

Prefer REST over MCP? All capabilities are also available as standard HTTP endpoints. Authenticate with a Bearer token in the Authorization header.

Method	Endpoint	Description
POST	/v1/chat	AI-powered hotel conversation with session continuity
POST	/v1/search	Structured hotel search - fast path, no LLM
GET	/v1/hotels/{id}	Full hotel profile with images and rooms
POST	/v1/call	Initiate a voice call to a hotel (negotiate, confirm, cancel)
GET	/v1/call/{id}/status	Call status, transcript, and audio recording
GET	/v1/call/{id}/results	Structured call outcomes (negotiated price, booking status)
POST	/v1/guests	Create a guest profile for your users
GET	/v1/guests/{id}	Retrieve a guest profile
PATCH	/v1/guests/{id}	Update a guest profile
DELETE	/v1/guests/{id}	GDPR-compliant data deletion
POST	/v1/keys	Generate a new API key
GET	/v1/keys	List all API keys for your account
DELETE	/v1/keys/{prefix}	Revoke an API key by prefix
GET	/v1/usage	Aggregated usage summary for your account
GET	/v1/billing/invoices	Invoice history for your account
GET	/v1/sessions/{session_id}	Retrieve session metadata and history

Chat Endpoint

Send a natural language message and receive hotel recommendations with AI-generated responses. Sessions persist across requests.

// POST /v1/chat
{
  "message": "Find a romantic hotel in Rome near the Colosseum",
  "session_id": null,
  "guest_id": null,
  "currency": "EUR",
  "locale": "en"
}

Search Endpoint

Structured hotel search with filters. Fast path - no LLM involved, results in milliseconds.

// POST /v1/search
{
  "city": "Milan",
  "country": "IT",
  "check_in": "2026-06-01",
  "check_out": "2026-06-05",
  "budget_max": 200,
  "currency": "EUR",
  "amenities": ["wifi", "pool"],
  "include_rates": true,
  "limit": 10
}

Booking Tools

Coming Soon

Availability checking, reservation creation, and cancellation management are coming in Phase 2. These will be available as both MCP tools and REST endpoints.

check_availability

create_reservation

get_reservation

cancel_reservation

GET STARTED

Ready to Build?

Search hotels, chat in natural language, pull full profiles, and negotiate rates by phone - all from a single integration. MCP or REST, go live in minutes.

Get Started Contact Us