MCP Server

mcp

world.byway/mcp
Maps & Location Travel & Hospitality Public & reachable MCP 2025-11-25

What this MCP does

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.
Read only
Input schema
{'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.
Read only
Input schema
{'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.
Read only
Input schema
{'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.
Read only
Input schema
{'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.
Read only
Input schema
{'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.
Input schema
{'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.
Read only
Input schema
{'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.
Read only
Input schema
{'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.
Read only
Input schema
{'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.
Read only
Input schema
{'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}
Added
places_along_route
Sept. 17, 2026, 12:55 p.m.
Added
plan_drive
Sept. 17, 2026, 12:55 p.m.
Added
search_destinations
Sept. 17, 2026, 12:55 p.m.
Added
places_on_byway
Sept. 17, 2026, 12:55 p.m.
Added
get_place
Sept. 17, 2026, 12:55 p.m.
Added
search_places
Sept. 17, 2026, 12:55 p.m.
Added
get_itinerary
Sept. 17, 2026, 12:55 p.m.
Added
search_lookouts
Sept. 17, 2026, 12:55 p.m.
Added
get_byway
Sept. 17, 2026, 12:55 p.m.
Added
search_byways
Sept. 17, 2026, 12:55 p.m.