world.byway/mcp

Official10 tools

by byway

Byway MCP: call Byway Engine and Byway Atlas, the discovery engine for the real world.

world.byway/mcp (Byway MCP) Model Context Protocol Server

Byway MCP (world.byway/mcp) is an MCP server that calls the Byway Engine and Byway Atlas. It supports the discovery engine for the real world by exposing tools (10 total) through the Model Context Protocol.

🛠️ Key Features

Integrates with Byway Engine
Integrates with Byway Atlas
Discovery engine for the real world
Tool count: 10

🚀 Use Cases

Real-world discovery workflows that require Byway Engine/Atlas data
Applications that need MCP tool access to the Byway discovery stack

⚡ Developer Benefits

Centralized MCP interface to Byway Engine and Byway Atlas
Tool-based access aligned with the Model Context Protocol

⚠️ Limitations

Available details are limited to description and tool count; specific tools, schemas, or supported operations are not provided.

Captured live from the server via tools/list.

search_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.

Parameters4

query	string	optional	Name text to match
state	string	optional	Two-letter US state code
country	string	optional	ISO-2 country (US, CA, FR, GB, IE, IS, NO, NZ); non-US searches regional routes
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "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"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_byway

Full detail for one scenic byway or regional route: designation, states or country, length, scenic lookouts on the route, and itineraries that ride it.

Parameters1

slug

string

required

Byway slug from search_byways

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Byway slug from search_byways"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_lookouts

Scenic lookouts (viewpoints) along a specific byway, or across a US state. Every lookout is a real, verified place — coverage is growing.

Parameters3

byway	string	optional	Byway slug
state	string	optional	Two-letter US state code
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "byway": {
      "type": "string",
      "description": "Byway slug"
    },
    "state": {
      "type": "string",
      "description": "Two-letter US state code"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_itinerary

A classic road-trip itinerary: waypoints, states, and the scenic byways along the route.

Parameters1

slug

string

required

Itinerary slug

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Itinerary slug"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_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.

Parameters7

kind	string	optional	Place type to filter on
state	string	optional	Two-letter US state code; requires kind
name	string	optional	Place name text
lat	number	optional	Latitude to search near
lon	number	optional	Longitude to search near
radiusMi	number	optional	Miles around lat/lon (default 30)
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "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"
      ],
      "description": "Place type to filter on"
    },
    "state": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Two-letter US state code; requires kind"
    },
    "name": {
      "type": "string",
      "minLength": 3,
      "maxLength": 200,
      "description": "Place name text"
    },
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude to search near"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude to search near"
    },
    "radiusMi": {
      "type": "number",
      "minimum": 0.0621371192237334,
      "maximum": 99.41939075797343,
      "description": "Miles around lat/lon (default 30)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_place

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.

Parameters3

url	string	optional	The place's byway.world /places URL
kind	string	optional	Place type
slug	string	optional	Place slug, ending in the row's 8-hex id

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The place's byway.world /places URL"
    },
    "kind": {
      "type": "string",
      "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"
      ],
      "description": "Place type"
    },
    "slug": {
      "type": "string",
      "description": "Place slug, ending in the row's 8-hex id"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

places_on_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.

Parameters4

byway	string	required	Byway slug from search_byways
kind	string	optional	Place type to filter on
bandMi	number	optional	Miles either side of the route (default 30)
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "byway": {
      "type": "string",
      "description": "Byway slug from search_byways"
    },
    "kind": {
      "type": "string",
      "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"
      ],
      "description": "Place type to filter on"
    },
    "bandMi": {
      "type": "number",
      "minimum": 0.0621371192237334,
      "maximum": 49.709695378986716,
      "description": "Miles either side of the route (default 30)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "byway"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

q	string	optional	City name text to match
state	string	optional	Two-letter US state code
limit	integer	optional	Rows to return (default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 2,
      "description": "City name text to match"
    },
    "state": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "Two-letter US state code"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "description": "Rows to return (default 10)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

plan_drive

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.

Parameters7

origin	string	required	Starting point (city or place name)
destination	string	required	Where the drive ends (city or place name)
budget_min	integer	optional	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.
depart_at	string	optional	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	array	optional	Taste categories to weight stops
pace	string	optional	leisurely \| balanced \| efficient
save	boolean	optional	Save the trip to the account

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Starting point (city or place name)"
    },
    "destination": {
      "type": "string",
      "description": "Where the drive ends (city or place name)"
    },
    "budget_min": {
      "type": "integer",
      "minimum": 30,
      "maximum": 960,
      "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."
    },
    "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"
    },
    "pace": {
      "type": "string",
      "description": "leisurely | balanced | efficient"
    },
    "save": {
      "type": "boolean",
      "description": "Save the trip to the account"
    }
  },
  "required": [
    "origin",
    "destination"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

places_along_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.

Parameters5

origin	string	required	Where the drive starts (city or place)
destination	string	required	Where it ends (city or place)
kind	string	optional	Place type to filter on
bandMi	number	optional	Miles either side of the route (default 30)
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "origin": {
      "type": "string",
      "description": "Where the drive starts (city or place)"
    },
    "destination": {
      "type": "string",
      "description": "Where it ends (city or place)"
    },
    "kind": {
      "type": "string",
      "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"
      ],
      "description": "Place type to filter on"
    },
    "bandMi": {
      "type": "number",
      "minimum": 0.0621371192237334,
      "maximum": 49.709695378986716,
      "description": "Miles either side of the route (default 30)"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "origin",
    "destination"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (10)

search_bywaysget_bywaysearch_lookoutsget_itinerarysearch_placesget_placeplaces_on_bywaysearch_destinations

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://www.byway.world/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.byway.world/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

world.byway/mcp (Byway MCP) Model Context Protocol Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_byways

get_byway

search_lookouts

get_itinerary

search_places

get_place

places_on_byway

search_destinations

plan_drive

places_along_route

Install

Remote endpoint

Related servers