Skip to content

world.byway/mcp

by byway.world · remote · no sign-in to list tools · v1.8.0 · published by world.byway

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

Changes · 3

10 tools: 3 change things and 7 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http byway https://www.byway.world/api/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

10 tools

Changes things 3Claude Code: ask
  • places_along_routeAtlas inventory along a routed drive: every place of a kind within a band of the corridor between two points.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
    • destructiveHint: false
  • places_on_bywayAtlas 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 deto…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • plan_drivePlan a scenic drive with the Byway engine: real verified stops, honest timing, official scenic byways.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: false
    • openWorldHint: false
    • destructiveHint: false
Only reads 7Claude Code: allow
  • get_bywayFull detail for one scenic byway or regional route: designation, states or country, length, scenic lookouts on the route, and itineraries that ride it.No findings

    Why it is in this group

    • The name "get_byway" says "get": a word for reading.
    Description, as the server wrote it
    Full detail for one scenic byway or regional route: designation, states or country, length, scenic lookouts on the route, and itineraries that ride it.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • get_itineraryA classic road-trip itinerary: waypoints, states, and the scenic byways along the route.No findings

    Why it is in this group

    • The name "get_itinerary" says "get": a word for reading.
    Description, as the server wrote it
    A classic road-trip itinerary: waypoints, states, and the scenic byways along the route.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • get_placeEverything the Byway atlas holds on one place: its own description, the records it traces to (OpenStreetMap, Wikipedia, Wikidata), reconciled public records (GNIS, National Registe…No findings

    Why it is in this group

    • The name "get_place" says "get": a word for reading.
    Description, as the server wrote it
    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, the nearest verified lookouts, and for a place people walk to from the car (a waterfall, peak, cliff, arch, hot spring, lighthouse or trailhead) the walk in: time, path length one way and climb, with what the numbers come from. Takes the byway.world URL search_places returned, or the place's kind and slug.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • search_bywaysSearch scenic byways and signed routes — the US federal roster plus regional routes (Québec, France, Northern Ireland, Ireland, Iceland, Norway, New Zealand today; growing).No findings

    Why it is in this group

    • The name "search_byways" says "search": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • search_destinationsFind 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…No findings

    Why it is in this group

    • The name "search_destinations" says "search": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • search_lookoutsScenic lookouts (viewpoints) along a specific byway, or across a US state.No findings

    Why it is in this group

    • The name "search_lookouts" says "search": a word for reading.
    Description, as the server wrote it
    Scenic lookouts (viewpoints) along a specific byway, or across a US state. Every lookout is a real, verified place — coverage is growing. Where known, each carries the walk in from the car: time, path length one way and climb, or roadside (no walk).

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false
  • search_placesSearch the Byway atlas of typed places — waterfalls, hot springs, lighthouses, covered bridges, historic sites, beaches, peaks, rest areas, ghost towns, museums and attractions.No findings

    Why it is in this group

    • The name "search_places" says "search": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.8.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http byway https://www.byway.world/api/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__byway__search_byways",
      "mcp__byway__get_byway",
      "mcp__byway__search_lookouts",
      "mcp__byway__get_itinerary",
      "mcp__byway__search_places",
      "mcp__byway__get_place",
      "mcp__byway__search_destinations"
    ],
    "ask": [
      "mcp__byway__places_on_byway",
      "mcp__byway__plan_drive",
      "mcp__byway__places_along_route"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as byway. Review it before you use it.