atlas

Free-text search over every route in the World Train Map atlas — matches route name, cities, train name, operator and countries, with optional category/country filters. Accent-insensitive; every word of the query must match. Returns compact per-route facts with id and worldtrainmap.com URL, sorted by renown with route-name matches first; with no query it lists the whole atlas by renown. Use get_route with a returned id for full detail, famous_routes for a ready-made top list, city_pair for A-to-B journey times.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text matched against name, cities, train, operator and countries — e.g. \"glacier\", \"Tokyo\", \"Amtrak\". Omit to browse all routes by renown."
    },
    "category": {
      "type": "string",
      "enum": [
        "high-speed",
        "classic",
        "night",
        "scenic",
        "heritage",
        "mountain",
        "luxury"
      ],
      "description": "Only routes in this category."
    },
    "country": {
      "type": "string",
      "description": "Only routes crossing this country — full name or 2-letter ISO code (\"Switzerland\" or \"CH\")."
    },
    "limit": {
      "type": "integer",
      "description": "Max routes returned. Default 10, max 50."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full record for one atlas route by exact id: distance, fastest time, top speed, operator, rolling stock, opening year, ridership, story, on-route sights, photo and page URL, plus country-hub links. An unknown id returns up to 5 close-match suggestions instead of failing. Use search_routes first when you only have a name or city.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Exact route id in kebab-case, e.g. \"glacier-express\" — take it from search_routes, famous_routes or routes_in_country results."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The world's most famous train journeys in World Train Map's renown order (rank 1 = most famous: Trans-Siberian, Glacier Express, Orient Express lineage, Shinkansen…), as compact facts with id and URL per route. Best first call for bucket-list and "greatest train trips" questions; use search_routes to find something specific, get_route for full detail on one route.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "How many top-ranked routes. Default 25, max 100."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Every atlas route crossing one country, sorted by renown, plus that country's worldtrainmap.com hub URL when it exists. An unrecognised country returns an error, not an empty list. Use for "trains in X" questions; use search_routes to combine a country with text or category filters, night_trains for sleepers only.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Country name or 2-letter ISO code, e.g. \"Japan\" or \"JP\". Accent-insensitive; unambiguous partial names resolve."
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sleeper routes from the atlas, sorted by renown — all of them by default, or only those starting or ending in a given city — with the per-city night-train guide URL when one exists. Use for overnight and sleeper questions; city_pair for concrete A-to-B times; search_routes for other route categories.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional city filter matched against route endpoints (accent-insensitive), e.g. \"Vienna\"."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Journey facts between two cities (European coverage): fastest and typical duration, whether direct trains run, fewest changes, operators and the guide URL — plus legendary atlas routes on that corridor. Direction-insensitive. Figures are sampled from public schedule data, not live times — treat as planning estimates. An uncovered pair returns an error with a search_routes tip.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Origin city, e.g. \"London\". City name only, no station needed; accent-insensitive."
    },
    "to": {
      "type": "string",
      "description": "Destination city, e.g. \"Paris\"."
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

One-call snapshot of what the World Train Map atlas covers: total route count, countries, combined length in km, the category list, number of city-pair guides, data snapshot date, and direct URLs to the main browse pages (world map, all routes, Europe/USA maps, night trains, scenic, by-country, city-to-city). Takes no parameters. Call it to learn what this server can answer, to cite dataset totals, or to link a browse page — it returns no individual routes; use search_routes or famous_routes for those.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}