Serveur MCP

mcp

world.byway/mcp
Cartes et localisation Voyage et hôtellerie Public et accessible MCP 2025-11-25

Ce que fait ce MCP

Searches scenic byways, destinations, places, and lookouts, retrieves route details, and can plan scenic drives with verified stops.

get_byway
Get byway details
Full detail for one scenic byway or regional route: designation, states or country, length, scenic lookouts on the route, and itineraries that ride it.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Byway slug from search_byways'}}, 'additionalProperties': False}
get_itinerary
Get road-trip itinerary
A classic road-trip itinerary: waypoints, states, and the scenic byways along the route.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'description': 'Itinerary slug'}}, 'additionalProperties': False}
get_place
Get place details
Everything the Byway atlas holds on one place: its own description, the records it traces to (OpenStreetMap, Wikipedia, Wikidata), reconciled public records (GNIS, National Register), the scenic byways that pass near it, and the nearest verified lookouts. Takes the byway.world URL search_places returned, or the place's kind and slug.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': "The place's byway.world /places URL"}, 'kind': {'enum': ['waterfall', 'hot-spring', 'lighthouse', 'covered-bridge', 'beach', 'historic-site', 'peak', 'rest-area', 'ghost-town', 'museum', 'attraction', 'park', 'nature-reserve', 'artwork', 'spring', 'garden', 'cliff', 'picnic-site', 'arch'], 'type': 'string', 'description': 'Place type'}, 'slug': {'type': 'string', 'description': "Place slug, ending in the row's 8-hex id"}}, 'additionalProperties': False}
places_along_route
Places along a route
Atlas inventory along a routed drive: every place of a kind within a band of the corridor between two points. This returns the raw record, not a plan — to plan a drive with stops chosen for the traveler, use plan_drive. One limit, stated: ghost-town rows live in a separate Wikidata corpus the corridor read cannot see. Asking for one here is refused rather than answered empty; reach them with search_places by state.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'kind': {'enum': ['waterfall', 'hot-spring', 'lighthouse', 'covered-bridge', 'beach', 'historic-site', 'peak', 'rest-area', 'ghost-town', 'museum', 'attraction', 'park', 'nature-reserve', 'artwork', 'spring', 'garden', 'cliff', 'picnic-site', 'arch'], 'type': 'string', 'description': 'Place type to filter on'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1}, 'bandMi': {'type': 'number', 'maximum': 49.709695378986716, 'minimum': 0.0621371192237334, 'description': 'Miles either side of the route (default 30)'}, 'origin': {'type': 'string', 'description': 'Where the drive starts (city or place)'}, 'destination': {'type': 'string', 'description': 'Where it ends (city or place)'}}, 'additionalProperties': False}
places_on_byway
Places on a byway
Atlas places along one scenic byway: every place of a kind within a band of the drawn route, nearest to the road first, each marked whether it sits on the byway itself or is a detour off it. Only routes with drawn geometry can answer. This is the atlas inventory beside a road, not an itinerary. One limit, stated: ghost-town rows live in a separate Wikidata corpus the corridor read cannot see. Asking for one here is refused rather than answered empty; reach them with search_places by state.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['byway'], 'properties': {'kind': {'enum': ['waterfall', 'hot-spring', 'lighthouse', 'covered-bridge', 'beach', 'historic-site', 'peak', 'rest-area', 'ghost-town', 'museum', 'attraction', 'park', 'nature-reserve', 'artwork', 'spring', 'garden', 'cliff', 'picnic-site', 'arch'], 'type': 'string', 'description': 'Place type to filter on'}, 'byway': {'type': 'string', 'description': 'Byway slug from search_byways'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1}, 'bandMi': {'type': 'number', 'maximum': 49.709695378986716, 'minimum': 0.0621371192237334, 'description': 'Miles either side of the route (default 30)'}}, 'additionalProperties': False}
plan_drive
Plan a byway
Plan a scenic drive with the Byway engine: real verified stops, honest timing, official scenic byways. Origin and destination are place names — the tool resolves each to the closest matching real place. budget_min is the whole time window (driving plus stops, default 240): a long drive needs a budget comfortably above its direct drive time or there is no slack to spend on stops. Requires a connected Byway account (OAuth sign-in). Set save=true to save the trip to your account.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['origin', 'destination'], 'properties': {'pace': {'type': 'string', 'description': 'leisurely | balanced | efficient'}, 'save': {'type': 'boolean', 'description': 'Save the trip to the account'}, 'origin': {'type': 'string', 'description': 'Starting point (city or place name)'}, 'depart_at': {'type': 'string', 'description': 'Departure time, ISO 8601 with offset (e.g. 2026-08-20T09:00:00-04:00). Defaults to now; must be within 14 days — hours and weather verdicts are real only inside the forecast horizon.'}, 'interests': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Taste categories to weight stops'}, 'budget_min': {'type': 'integer', 'maximum': 960, 'minimum': 30, 'description': 'Total minutes for the whole trip, driving plus stops (30-960, default 240). Set well above the direct drive time to make room for stops.'}, 'destination': {'type': 'string', 'description': 'Where the drive ends (city or place name)'}}, 'additionalProperties': False}
search_byways
Search scenic byways
Search scenic byways and signed routes — the US federal roster plus regional routes (Québec, France, Northern Ireland, Ireland, Iceland, Norway, New Zealand today; growing). Filter by name, US state, or ISO-2 country. US byways carry byway.world links.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1}, 'query': {'type': 'string', 'description': 'Name text to match'}, 'state': {'type': 'string', 'description': 'Two-letter US state code'}, 'country': {'type': 'string', 'description': 'ISO-2 country (US, CA, FR, GB, IE, IS, NO, NZ); non-US searches regional routes'}}, 'additionalProperties': False}
search_destinations
Search destinations
Find US destination cities by name or state, with the day trip around each one: the scenic byways, national parks, public land units and campgrounds Byway's registries place within 30 miles. Only cities with a proven weave are listed — every result links to its own byway.world destination page.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'minLength': 2, 'description': 'City name text to match'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Rows to return (default 10)'}, 'state': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'description': 'Two-letter US state code'}}, 'additionalProperties': False}
search_lookouts
Search scenic lookouts
Scenic lookouts (viewpoints) along a specific byway, or across a US state. Every lookout is a real, verified place — coverage is growing.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'byway': {'type': 'string', 'description': 'Byway slug'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1}, 'state': {'type': 'string', 'description': 'Two-letter US state code'}}, 'additionalProperties': False}
search_places
Search atlas places
Search the Byway atlas of typed places — waterfalls, hot springs, lighthouses, covered bridges, historic sites, beaches, peaks, rest areas, ghost towns, museums and attractions. Locate by US state (which also needs a kind), by a point and radius, or by name; a name given alongside a locator narrows it. Every result links to the byway.world page for that place, and every place traces to its OpenStreetMap or Wikidata record. One limit, stated: ghost-town rows live in a separate Wikidata corpus that the point and name searches cannot read, so they are absent from a kind-less search. Reach them with state + kind, or with get_place. Asking for one any other way is refused, never answered empty.
Lecture seule
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude to search near'}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude to search near'}, 'kind': {'enum': ['waterfall', 'hot-spring', 'lighthouse', 'covered-bridge', 'beach', 'historic-site', 'peak', 'rest-area', 'ghost-town', 'museum', 'attraction', 'park', 'nature-reserve', 'artwork', 'spring', 'garden', 'cliff', 'picnic-site', 'arch'], 'type': 'string', 'description': 'Place type to filter on'}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 3, 'description': 'Place name text'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1}, 'state': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Two-letter US state code; requires kind'}, 'radiusMi': {'type': 'number', 'maximum': 99.41939075797343, 'minimum': 0.0621371192237334, 'description': 'Miles around lat/lon (default 30)'}}, 'additionalProperties': False}
Ajouté
places_along_route
17 September 2026 12:55
Ajouté
plan_drive
17 September 2026 12:55
Ajouté
search_destinations
17 September 2026 12:55
Ajouté
places_on_byway
17 September 2026 12:55
Ajouté
get_place
17 September 2026 12:55
Ajouté
search_places
17 September 2026 12:55
Ajouté
get_itinerary
17 September 2026 12:55
Ajouté
search_lookouts
17 September 2026 12:55
Ajouté
get_byway
17 September 2026 12:55
Ajouté
search_byways
17 September 2026 12:55