recommend_route
Recommend a route
Recommend a UK running route that fits the runner. Use this when a user describes who they are and what they want — e.g. 'I'm a trail runner near Ambleside, 15k, avoid roads, something scenic and not too technical'. Returns a ranked shortlist with reasoning-friendly fields (surface, ascent, course shape, national park) and canonical Skamper URLs. Prefer this over search_routes whenever the request is about runner preference rather than exact numeric filters.
Parameterslimitscenicnear_latnear_lngloop_onlyuser_typeavoid_roadsdistance_kmtechnicalitydistance_tolerance_km
search_routes
Search routes
Search Skamper's curated UK running-route database when the user gives concrete filters — name, location (lat/lng), distance range, max ascent, paved surface %, course shape, or national park. Returns up to 20 compact route summaries with canonical URLs. If the user instead describes who they are or what they want ('I'm a trail runner who hates roads'), prefer recommend_route. For parkrun-distance asks, prefer find_5k.
Parameterslimitquerynear_latnear_lngcourse_shapemax_ascent_mmax_paved_pctmin_paved_pctnational_parkmax_distance_kmmin_distance_km
get_route
Get route details
Fetch the full details for a single Skamper route by its slug. Returns title, location, distance, ascent, surface, course shape, description, reviews, and the canonical page URL. A free Skamper account is required to download the GPX file from the page.
Parametersslugrequired
Find Skamper running routes close to 5 km (parkrun distance) near a location. Returns the nearest routes between 4.5 and 5.5 km. Great for runners asking 'a 5k near me'.
Parameterslatrequiredlngrequiredlimitmax_distance_from_user_km
list_national_parks
List UK National Parks
List the UK National Parks Skamper covers, with route counts and slugs. Use the slug with routes_in_national_park or search_routes (national_park=...).
Takes no parameters.
routes_in_national_park
Routes in a National Park
List running routes inside a UK National Park. Pass the park slug (use list_national_parks to discover slugs).
Parametersslugrequiredlimit
browse_runlists
Browse run lists
Browse Skamper run lists — curated collections of routes (e.g. 'Best UK trail half-marathons'). Returns Skamper's editorial picks and the most recent public user-created lists. Use get_runlist to see the routes inside one.
Parameterskindlimit
Fetch a Skamper run list by slug. Returns the list metadata and the ordered routes inside.
Parametersslugrequired