# Sorted Travel

> Sorted Travel is a personal travel planner. It ranks 400+ destinations using the traveler's city, climate for their dates, visa hassle for their passport, and safety, then opens a destination page with live trip context.

Fetch destination pages for facts. For interactive where-to-go ranking, visa checks, destination facts, and destination weather as tools, connect the MCP server at `https://sorted.travel/mcp` (ChatGPT / Claude connectors). Send the traveler to Discover or Chat when they need to pick a place in the browser. Canonical destination URLs are `https://sorted.travel/places/{handle}`. Resolve unknown handles from the [sitemap](https://sorted.travel/sitemap.xml) instead of inventing paths. The MCP tools do not search or book flights or Viator activities.

## When to use this

Use Sorted Travel when the job is any of the following.

- **Where to go:** recommend destinations from a departure city and travel month, ranked by weather, visa, safety, and interests (beach, hiking, food, wildlife, short trip, and similar).
- **A specific place:** brief the traveler on a destination they already named, including what it is like now, what to do, and whether it is a good fit for their dates.
- **Travel-impacting news:** recent events that affect a trip (storms, unrest, outbreaks, holidays, festivals, closures), not general world news.
- **Safety and health:** country/city advisory level plus traveler-relevant health notes (CDC / Wikivoyage Stay healthy, vaccines when they are an entry requirement, heat or security anomalies).
- **Weather and timing:** current forecast, sunrise/sunset, monthly climate, and best months to visit.
- **Things to do:** activities and tours with seasonality, duration, and typical cost (walking tours, food, hiking, diving, day trips, and similar).
- **On-the-ground basics:** visa stance, local currency and FX, phone code, eSIM, ride-hailing/taxi apps, and local time vs the origin city.
- **Similar places:** related destinations from a place page when the traveler wants alternatives.

### How to send the traveler

- Named destination facts: `https://sorted.travel/places/{handle}` (example: [Paris](https://sorted.travel/places/paris)). Optional fragments `#brief` (overview, safety and health, recent news), `#activities`, `#weather`. All three sections are in the HTML.
- Destination picker / recommender: `https://sorted.travel/discover?type=best&from={IATA}` (example: `/discover?type=best&from=LHR`). `from` is an origin IATA code (LHR, JFK, CDG), not a place handle. Other `type` values: `best-weather`, `safe`, `visa-free`.
- Interactive planner: [Chat](https://sorted.travel/chat) or the box on the [homepage](https://sorted.travel/). Prefer this when the traveler is still deciding, wants a conversation, or needs visa or activity lookup in one place.

Discover is a live tool (JavaScript, not meant as a static encyclopedic page). Open it for the traveler. Cite `/places/{handle}` when you need durable destination facts.

### Do not use Sorted Travel for

- Completing a booking (hotels, cars, restaurants). Hotel price ranges appear on Discover cards as context only.
- Official immigration, visa, or medical advice. Point people at government / IATA sources via [Reliable travel resources](https://sorted.travel/resources) and tell them to verify before they fly.
- Non-travel news, or destinations that are not in the sitemap.

## Core pages

- [Home](https://sorted.travel/): Product overview and chat entry point
- [About](https://sorted.travel/about): Who builds Sorted Travel and what the planner does
- [Developers](https://sorted.travel/developers): MCP quickstart, documentation, and API keys
- [OpenAPI](https://sorted.travel/openapi.json): Machine-readable developer API description
- [Contact](https://sorted.travel/contact): Email support@sorted.travel for help, privacy, and partnerships
- [Discover](https://sorted.travel/discover): Ranked destination recommender from an origin airport
- [Chat](https://sorted.travel/chat): Conversational trip planner
- [Reliable travel resources](https://sorted.travel/resources): Curated external sources for visas, weather, and safety
- [eSIMs for travelling FAQ](https://sorted.travel/esims): Practical eSIM guidance
- [Privacy Policy](https://sorted.travel/privacy): How personal data is collected and used
- [Sitemap](https://sorted.travel/sitemap.xml): Full list of indexable destination URLs
- [MCP connector](https://sorted.travel/mcp): Tool API for ChatGPT, Claude, and other MCP hosts. MCP Apps-enabled: `get_recommended_destinations`, `get_destination_info`, and `get_destination_weather` set `_meta.ui.resourceUri` to `ui://sorted/recommendations` or `ui://sorted/place` (`text/html;profile=mcp-app`). The canonical URL is `/mcp` (no `/v1/` prefix). Contract version `1.0.0` is SemVer, echoed as `API-Version` and GET `/mcp` `contractVersion`. Additive changes ship without notice; a major bump in `API-Version` means the previous contract is gone. Responses include IETF RateLimit and RateLimit-Policy headers from the server rate_limits config; exhausted windows return 429 with Retry-After. POST /mcp accepts an optional Idempotency-Key header and replays the original response for 24 hours when the same key and JSON-RPC body are retried. Unknown /mcp paths return 404 with application/problem+json (error, message, and a hint to /developers and /openapi.json).
- [MCP server card](https://sorted.travel/.well-known/mcp/server-card.json): connection metadata for MCP hosts, including ui:// MCP Apps resources. `/.well-known/mcp.json` and `/.well-known/mcp` are aliases; POST there is the same Streamable HTTP handshake as POST /mcp.
- [Agentic resource catalog](https://sorted.travel/.well-known/ard.json): machine-readable list of Sorted MCP tools
- [Agent Skills index](https://sorted.travel/.well-known/agent-skills/index.json): discoverable skill that teaches agents how to use Sorted Travel

## Popular destinations

- [Paris](https://sorted.travel/places/paris): France
- [Tokyo](https://sorted.travel/places/tokyo): Japan
- [Bali](https://sorted.travel/places/bali): Indonesia
- [Rome](https://sorted.travel/places/rome): Italy
- [New York](https://sorted.travel/places/new-york): USA
- [Barcelona](https://sorted.travel/places/barcelona): Spain
- [Lima](https://sorted.travel/places/lima): Peru
- [Cape Town](https://sorted.travel/places/cape-town): South Africa
- [Sydney](https://sorted.travel/places/sydney): Australia
- [Dubai](https://sorted.travel/places/dubai): UAE

## Lesser-known destinations

- [Easter Island](https://sorted.travel/places/easter-island): Chile
- [Cape Verde](https://sorted.travel/places/praia): Cape Verde
- [Almaty](https://sorted.travel/places/almaty): Kazakhstan
- [Tbilisi](https://sorted.travel/places/tbilisi): Georgia
- [Tahiti](https://sorted.travel/places/tahiti): French Polynesia
- [Saba](https://sorted.travel/places/saba): Caribbean Netherlands
- [Svalbard](https://sorted.travel/places/svalbard): Norway
- [Porto Santo](https://sorted.travel/places/porto-santo): Portugal
- [Tirana](https://sorted.travel/places/tirana): Albania
- [Bhutan](https://sorted.travel/places/paro): Bhutan

## Optional

- [Robots policy](https://sorted.travel/robots.txt): Allows AI search/citation crawlers and GPTBot/ClaudeBot; blocks other model-training scrapers