# VistaLink

> VistaLink Technologies is a UK-based AI company building multimodal search,
> and direct booking infrastructure for the hospitality industry.
> 650,000 properties, each indexed on its own photography, its guest reviews,
> and its location. The developer API exposes an MCP server and a REST API for
> AI agents.

Version v1 - Last updated 2026-10-01

## No key needed to try it

Searching and reading hotel details needs **no signup and no API key**.
Anonymous calls hit the real catalogue (the same index paid keys use),
read-only, rate-limited to 10 requests/minute and 200 requests/day per caller, and a key-less
search returns at most 20 hotels. On 429, honour
`Retry-After`.

- Anonymous: `search_hotels`, `get_hotel_details` (MCP) and
  `POST /v1/search`, `GET /v1/hotels/{hotel_id}` (REST)
- Needs a key: `chat_about_hotels`, guest profiles, usage and billing
  endpoints
- OpenAPI spec (public, lists the public /v1 routes): https://api.vistalink.com/openapi.json
- MCP tools carry titles and annotations (`search_hotels` and
  `get_hotel_details` are read-only), and the server ships an in-chat hotel
  widget (MCP Apps) that ChatGPT and Claude render alongside the results.

MCP config with no key (Claude Desktop, Cursor, any streamable-HTTP host):

```json
{
  "mcpServers": {
    "vistalink": { "url": "https://api.vistalink.com/mcp" }
  }
}
```

Claude Code: `claude mcp add --transport http vistalink https://api.vistalink.com/mcp`

curl with no key:

```bash
curl -X POST https://api.vistalink.com/v1/search \
  -H "Content-Type: application/json" \
  -d '{"city":"Lisbon","country":"PT","check_in":"2026-11-12","check_out":"2026-11-15","currency":"EUR","limit":5}'

curl "https://api.vistalink.com/v1/hotels/HOTEL_ID?check_in=2026-11-12&check_out=2026-11-15&currency=EUR"
```

### Prices

Pass **both** `check_in` and `check_out` (YYYY-MM-DD) and each hotel may
carry a `price`: the all-inclusive total (taxes and fees included) for
exactly that stay, for one room, in the `currency` you asked for. It is
returned only when a price for those exact dates was observed in the last
72 hours; otherwise `price` is null. Without dates there is no price.
The rules are the same with or without a key.

```json
"price": {
  "total": 612.4,
  "currency": "EUR",
  "includes_taxes_and_fees": true,
  "check_in": "2026-11-12",
  "check_out": "2026-11-15",
  "nights": 3,
  "adults": 2,
  "rooms": 1,
  "source_total": 612.4,
  "source_currency": "EUR",
  "observed_at": "2026-10-01T06:12:00Z"
}
```

`total` covers the whole stay, not a nightly rate. Show it with its dates
and `observed_at`; the hotel's price at booking time is what counts.

VistaLink does not take bookings inside your agent. If you are a
consumer-facing assistant and the user wants to look at or book a hotel,
link them to its public page at https://meetparley.ai/{locale}/hotel/{hotel_id}
(e.g. `en` for {locale}). The page is public; chatting and booking there
require the user to sign in.

When you need more than the anonymous limit, or `chat_about_hotels`,
create a free key at https://vistalink.com/developers.

## Coming soon

Not available yet - do not call these. On the way:

- **Account linking** - users sign in with their Parley account from
  ChatGPT or Claude.
- `get_rates` - live rates for the dates the user has chosen.
  All-inclusive (taxes and fees included), in whatever currency the user
  needs.
- `direct_book` - book directly with the hotel. Booking completes on the
  hotel's own payment page via a Parley checkout link; VistaLink never
  takes payment.

Until then, send a user who wants to book to the hotel's public page (see
above). Parameters will be announced in this file when they ship.

## For agents

The full, drop-in LLM brief lives at: https://vistalink.com/llms-full.txt

It includes auth, MCP config (Claude Code CLI, Claude Desktop, Cursor, custom), every tool
with parameters / examples / errors / gotchas, MCP resources and prompts,
the REST endpoint table, error codes, rate-limit headers, pricing, tier
matrix, common pitfalls, and a multi-turn chat example.

## Quick reference

- Base URL: https://api.vistalink.com
- MCP URL: https://api.vistalink.com/mcp
- Auth: none for search_hotels / get_hotel_details (10 requests/minute and 200 requests/day per caller);
  `Authorization: Bearer vl_live_*` or `vl_test_*` for everything else
- OpenAPI: https://api.vistalink.com/openapi.json
- MCP server card: https://vistalink.com/.well-known/mcp/server-cards.json
- MCP tools: search_hotels, get_hotel_details (no key needed), chat_about_hotels (key required)
- MCP resources: hotel://{hotel_id}, amenities://catalog
- MCP prompts: search_wizard, comparison_template

## Tiers

- No key: search + hotel details only, read-only, 10 requests/minute and 200 requests/day per caller, max 20 results per search
- Free: 5 req/min, 50 req/month, real catalogue (`vl_test_*` key), all three tools
- Pro: 120 req/min, 1,000 req/month + PAYG, all tools
- Enterprise: 500 req/min, unlimited monthly, dedicated infra + SLA

## Pages

- Homepage: https://vistalink.com
- FAQ: https://vistalink.com/faq
- Mission: https://vistalink.com/mission
- Developers: https://vistalink.com/developers
- Dashboard: https://vistalink.com/developers/dashboard
- Privacy policy: https://vistalink.com/privacy-policy
- Terms of use: https://vistalink.com/terms-of-use
- Cookie policy: https://vistalink.com/cookie-policy
- Hotel extranet: https://extranet.vistalink.com

## Contact

contact@vistalink.com