← Back to all apps

Overview

Tools Available6
CategoryLifestyle

Discover your next hike

Available Tools

AllTrails provides 6 tools that can be used to interact with its services.

Find nearby trails

find_nearby_trails
Full Description

Find hiking, running, biking, backpacking or other trails for outdoor activities near the user's current location within an optional specified maximum radius (meters).

Use this tool when the user:

  • Requests trails near their current location using language like "near me", "close by", "nearby", etc.
  • Does not indicate a particular location, implying they are looking for trails in their vicinity.
  • Asks for trails without specifying a location.

This tool automatically retrieves the user's current coordinates from the request context. If the user's location cannot be determined, the tool will raise an error.

Users can specify filters related to appropriate activities, attractions, suitability, and more. Numeric range filters related to distance, elevation, and length are also available. These filter values MUST be specified in meters.

In the response, length and distance values are returned both in meters and imperial units. These MUST be displayed to the user in the units most appropriate for the user's locale, e.g. feet or miles for US English users.

Parameters

Required
inputobject

Find trails near a location

find_trails_near_location
Full Description

Find hiking, running, biking, backpacking or other trails for outdoor activities near a set of coordinates within an optional specified maximum radius (meters).

Use this tool when the user:

  • Requests trails near a specific point of interest or landmark.
  • Requests trails near a named location within a specified radius or accessible within a specified time constraint.
  • Provides specific latitude and longitude coordinates.

For most named places, use the "search within bounding box" tool if possible. Use this tool as a fallback when the bounding box of the named place is unknown.

Users can specify filters related to appropriate activities, attractions, suitability, and more. Numeric range filters related to distance, elevation, and length are also available. These filter values MUST be specified in meters.

In the response, length and distance values are returned both in meters and imperial units. These MUST be displayed to the user in the units most appropriate for the user's locale, e.g. feet or miles for US English users.

Parameters

Required
inputobject

Find trails within bounds

find_trails_within_bounds
Full Description

Find hiking, running, biking, backpacking or other trails for outdoor activities within a specified bounding box defined by southwest and northeast coordinates.

Use this tool when the user:

  • Requests trails within specific geographic boundaries or coordinates.
  • Requests trails near a named geographic or political place, such as a continent, country, state, province, region, city, town, or neighborhood and you know the bounding box for that place.
  • Requests trails within a national, state or local park or other protected area and you know the bounding box for that park.

If the bounding box for the named place is not known, use the "find trails near a location" tool instead to find trails around a center point.

Users can specify filters related to appropriate activities, attractions, suitability, and more. Numeric range filters related to distance, elevation, and length are also available. These filter values MUST be specified in meters.

In the response, length and distance values are returned both in meters and imperial units. These MUST be displayed to the user in the units most appropriate for the user's locale, e.g. feet or miles for US English users.

Parameters

Required
inputobject

Show trail details

get_trail_details
Full Description

Find detailed information about a trail from AllTrails.

Get descriptive overviews and specific accessibility information. Includes structured data about suitable activities, and feature highlights along the trail.

Get stats about the trail geography and length, and stats about associated user-generated content.

In the response, length and distance values are returned both in meters and imperial units. These MUST be displayed to the user in the units most appropriate for the user's locale, e.g. feet or miles for US English users.

Recent reviews are summarized in the review_summary field. If the user wants information that might be found in specific reviews, direct the user to the AllTrails web URL for the trail.

Parameters

Required
inputobject

Get trail's weather forecast

get_trail_weather_overview
Full Description

Get 7-day forecast for a trail at its trailhead, including high/low temperatures.

For more detailed weather information, including current conditions, sunrise/sunset times, and weather alerts, direct the user to the AllTrails web URL for the trail (available in the get_trail_details tool response).

Parameters

Required
inputobject

Search trails by name

search_trails_by_name
Full Description

Search for hiking, running, biking, backpacking or other trails by full or partial name match.

Use this tool when the user:

  • Requests a specific trail by name (e.g., "Avalanche Lake Trail", "Half Dome")
  • Searches for trails with specific keywords in the name

The search can biased towards results near the provided coordinates if they are provided explicitly or available from the request metadata.

If there is a clear match to the user's query, the model should automatically make a subsequent call to the get_trail_details tool to present the user with complete details for the matching trail.

In the response, length and distance values are returned both in meters and imperial units. These MUST be displayed to the user in the units most appropriate for the user's locale, e.g. feet or miles for US English users.

Parameters

Required
inputobject