MCP Server
ourpr.
io.github.joeyaflores/ourpr-courses
What this MCP does
Provides measured running courses, route and terrain data, activity metrics, training history, workout detection, and planned training blocks.
Capabilities
Tools
18
tools
ourpr_detect_reps
Look for reps in one run
Whether one particular run was an interval session, and its reps.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['activity_id'], 'properties': {'activity_id': {'type': 'string', 'description': 'Run id from ourpr_list_runs.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['detection'], 'properties': {'detection': {'type': 'object', 'additionalProperties': {}}}, 'additionalProperties': False}
ourpr_get_course
Get one course
Read one published course: its place, distance, climb, how it was measured, and which streets carry it.
DELIBERATELY WITHOUT the elevation profile, the amenities and the centerline. Those are three more tools, because one course payload is about 83 KB and 91% of it is the profile.
Args:
- slug (string): From ourpr_list_courses. Example: 'boston-marathon'.
- response_format ('markdown' | 'json'): Default 'markdown'.
Returns:
{
"slug": string,
"name": string, // the event's own name, title sponsor included
"place": string | null,
"alternate_names": string[], // curated geographic aliases
"kind": string, "course_type": string,
"distance_mi": number, // the stated race distance
"measured_mi": number | null, // the centerline ourpr. measured
"next_race_date": string | null, "days_out": number | null,
"climb_ft": number | null, "descent_ft": number | null,
"min_ft": number | null, "max_ft": number | null, "steepest_pct": number | null,
"provenance": string | null, // one sentence on how it was built
"sources": [{ "label": string, "value": string }],
"recorded_on": string | null, // the watch that recorded the seed run
"main_ways": [{ "name": string, "mi": number, "share_pct": number }],
"through": string[], // named places the line passes through
"photo_count": number,
"counts": { "named_climbs_and_descents": number, "amenities": number,
"mile_markers": number, "profile_points": number },
"page_url": string, "gpx_url": string
}
`distance_mi` is what the race calls itself; `measured_mi` is what the centerline measures. They differ by a few hundredths and both are reported rather than reconciled.
Examples:
- "Tell me about the Boston Marathon course" -> slug="boston-marathon"
- "How much does San Diego climb?" -> slug="san-diego-marathon", read climb_ft
- Do not use when: you want the hill-by-hill shape. Use ourpr_get_course_terrain.
Error handling:
- Returns the slug list suggestion when the slug is unknown.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "The course's slug, exactly as ourpr_list_courses returns it. Example: 'boston-marathon'."}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': "Output format. 'markdown' reads well in a chat answer. 'json' carries every field for further computation."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug', 'name', 'place', 'alternate_names', 'kind', 'course_type', 'distance_mi', 'one_way_mi', 'next_race_date', 'days_out', 'climb_ft', 'descent_ft', 'min_ft', 'max_ft', 'steepest_pct', 'measured_mi', 'provenance', 'sources', 'recorded_on', 'main_ways', 'through', 'photo_count', 'counts', 'page_url', 'gpx_url'], 'properties': {'kind': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'place': {'type': ['string', 'null']}, 'counts': {'type': 'object', 'required': ['named_climbs_and_descents', 'amenities', 'mile_markers', 'profile_points'], 'properties': {'amenities': {'type': 'number'}, 'mile_markers': {'type': 'number'}, 'profile_points': {'type': 'number'}, 'named_climbs_and_descents': {'type': 'number'}}, 'additionalProperties': False}, 'max_ft': {'type': ['number', 'null']}, 'min_ft': {'type': ['number', 'null']}, 'gpx_url': {'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'required': ['label', 'value'], 'properties': {'label': {'type': 'string'}, 'value': {'type': 'string'}}, 'additionalProperties': False}}, 'through': {'type': 'array', 'items': {'type': 'string'}}, 'climb_ft': {'type': ['number', 'null']}, 'days_out': {'type': ['number', 'null']}, 'page_url': {'type': 'string'}, 'main_ways': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'mi', 'share_pct'], 'properties': {'mi': {'type': 'number'}, 'name': {'type': 'string'}, 'share_pct': {'type': 'number'}}, 'additionalProperties': False}}, 'descent_ft': {'type': ['number', 'null']}, 'one_way_mi': {'type': ['number', 'null']}, 'provenance': {'type': ['string', 'null']}, 'course_type': {'type': 'string'}, 'distance_mi': {'type': 'number'}, 'measured_mi': {'type': ['number', 'null']}, 'photo_count': {'type': 'number'}, 'recorded_on': {'type': ['string', 'null']}, 'steepest_pct': {'type': ['number', 'null']}, 'next_race_date': {'type': ['string', 'null']}, 'alternate_names': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': False}
ourpr_get_course_amenities
Get water and toilets on a course
Public drinking water and toilets on the line of one course, each placed at the mile it sits at.
READ THIS LIMIT BEFORE YOU ANSWER. These come from OpenStreetMap: public taps and toilets somebody mapped near the route. It is a FREQUENCY difference, not a category one — a race day sets up many more stops than an ordinary day has. A mapped tap can also be seasonal, shut off or gone. Never present this as an aid-station plan, and never imply the count is guaranteed.
It answers the training question instead: if I run this course on an ordinary day, where can I drink?
Args:
- slug (string): From ourpr_list_courses.
- response_format ('markdown' | 'json'): Default 'markdown'.
Returns:
{
"slug": string, "name": string, "distance_mi": number,
"source": string,
"is_race_aid_station_list": false,
"water_count": number, "toilet_count": number,
"longest_gap_without_water_mi": number | null,
"longest_gap_from_mi": number | null, "longest_gap_to_mi": number | null,
"amenities": [{ "kind": string, "mi": number, "lat": number, "lng": number }],
"page_url": string
}
The longest gap counts the start and the finish as ends, so a course with one water stop at mile 3 of 6 reports a 3 mile gap, not 0.
Examples:
- "Where can I refill on the Cowtown ultra?" -> slug="cowtown-ultra-marathon"
- "How far do I go without water on Boston?" -> read longest_gap_without_water_mi
- Do not use when: you want race-day aid stations. ourpr. does not hold those.
Error handling:
- A course with no mapped amenity returns empty arrays and zero counts. That means none is mapped, not that none exists.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "The course's slug."}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': "Output format. 'markdown' reads well in a chat answer. 'json' carries every field for further computation."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug', 'name', 'distance_mi', 'source', 'is_race_aid_station_list', 'water_count', 'toilet_count', 'longest_gap_without_water_mi', 'longest_gap_from_mi', 'longest_gap_to_mi', 'amenities', 'page_url'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'source': {'type': 'string'}, 'page_url': {'type': 'string'}, 'amenities': {'type': 'array', 'items': {'type': 'object', 'required': ['kind', 'mi', 'lat', 'lng'], 'properties': {'mi': {'type': 'number'}, 'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'kind': {'type': 'string'}}, 'additionalProperties': False}}, 'distance_mi': {'type': 'number'}, 'water_count': {'type': 'number'}, 'toilet_count': {'type': 'number'}, 'longest_gap_to_mi': {'type': ['number', 'null']}, 'longest_gap_from_mi': {'type': ['number', 'null']}, 'is_race_aid_station_list': {'type': 'boolean', 'description': 'Always false. These are public amenities, not race aid stations.'}, 'longest_gap_without_water_mi': {'type': ['number', 'null']}}, 'additionalProperties': False}
ourpr_get_course_route
Get a course's line
Where a course actually runs: its start, its finish, its bounding box, every mile marker, and the streets in the order you meet them.
The GPX file is free and needs no account. Hand `gpx_url` to a person who wants the course on a watch.
Args:
- slug (string): From ourpr_list_courses.
- include_polyline (boolean): Add the encoded centerline, about 9,800 characters. Default false.
- response_format ('markdown' | 'json'): Default 'markdown'.
Returns:
{
"slug": string, "name": string, "course_type": string, "distance_mi": number,
"start": { "lat": number, "lng": number } | null,
"finish": { "lat": number, "lng": number } | null,
"bbox": { "min_lat": number, "min_lng": number, "max_lat": number, "max_lng": number } | null,
"mile_markers": [{ "mile": number, "lat": number, "lng": number }],
"streets_in_order": [{ "name": string, "from_mi": number, "to_mi": number }],
"polyline": string | null,
"gpx_url": string, "page_url": string
}
On an out-and-back the start and the finish are the same point, by design.
Examples:
- "Send me the Boston course for my watch" -> read gpx_url
- "What streets does Dallas run down?" -> read streets_in_order
- "Where does Honolulu start?" -> read start
Error handling:
- Returns the slug list suggestion when the slug is unknown.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "The course's slug."}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': "Output format. 'markdown' reads well in a chat answer. 'json' carries every field for further computation."}, 'include_polyline': {'type': 'boolean', 'default': False, 'description': 'Add the encoded centerline. It runs to about 9,800 characters and only helps if you will decode it. Leave it off and hand over `gpx_url` instead.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug', 'name', 'course_type', 'distance_mi', 'start', 'finish', 'bbox', 'mile_markers', 'streets_in_order', 'polyline', 'gpx_url', 'page_url'], 'properties': {'bbox': {'anyOf': [{'type': 'object', 'required': ['min_lat', 'min_lng', 'max_lat', 'max_lng'], 'properties': {'max_lat': {'type': 'number'}, 'max_lng': {'type': 'number'}, 'min_lat': {'type': 'number'}, 'min_lng': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'start': {'anyOf': [{'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'finish': {'anyOf': [{'type': 'object', 'required': ['lat', 'lng'], 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'gpx_url': {'type': 'string'}, 'page_url': {'type': 'string'}, 'polyline': {'type': ['string', 'null']}, 'course_type': {'type': 'string'}, 'distance_mi': {'type': 'number'}, 'mile_markers': {'type': 'array', 'items': {'type': 'object', 'required': ['mile', 'lat', 'lng'], 'properties': {'lat': {'type': 'number'}, 'lng': {'type': 'number'}, 'mile': {'type': 'number'}}, 'additionalProperties': False}}, 'streets_in_order': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'from_mi', 'to_mi'], 'properties': {'name': {'type': 'string'}, 'to_mi': {'type': 'number'}, 'from_mi': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
ourpr_get_course_terrain
Get a course's hills
The elevation profile of one course, sampled, plus every climb and descent ourpr. named on it.
THIS IS THE TOOL FOR "what are the hills and where". Each named section carries the street it runs on, the miles it spans, its net rise or fall and its average grade.
The elevation comes from a public terrain model sampled along the measured centerline (elevation_source names it), not from a watch barometer. A barometer drifts; the model is checked against published race figures.
Args:
- slug (string): From ourpr_list_courses.
- points (number): Elevation samples to return, 2 to 200. Default 40. The stored profile holds up to 4,873.
- response_format ('markdown' | 'json'): Default 'markdown'.
Returns:
{
"slug": string, "name": string, "distance_mi": number,
"climb_ft": number | null, "descent_ft": number | null,
"min_ft": number | null, "max_ft": number | null,
"steepest_pct": number | null,
"climb_ft_per_mi": number | null,
"elevation_source": string,
"profile_points_stored": number,
"profile": [{ "mi": number, "ft": number }],
"named_sections": [{
"kind": "climb" | "descent", "name": string,
"from_mi": number, "to_mi": number,
"net_ft": number, "grade_pct": number
}],
"page_url": string
}
The sampled profile always keeps the first point, the last point, the highest and the lowest, so its extremes agree with min_ft and max_ft.
A course with no named sections returns an empty array. That means the seeder found no stretch that qualified, not that the course is flat: read climb_ft.
Examples:
- "What are the hills on Boston?" -> slug="boston-marathon"
- "Is Houston flat?" -> slug="houston-marathon", read climb_ft_per_mi
- "Give me the profile in detail" -> points=200
Error handling:
- Returns the slug list suggestion when the slug is unknown.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "The course's slug."}, 'points': {'type': 'integer', 'default': 40, 'maximum': 200, 'minimum': 2, 'description': 'How many elevation samples to return. The stored profile holds up to 4,873 points, which no agent should read whole. 40 describes the shape; 200 is close to the source.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': "Output format. 'markdown' reads well in a chat answer. 'json' carries every field for further computation."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug', 'name', 'distance_mi', 'climb_ft', 'descent_ft', 'min_ft', 'max_ft', 'steepest_pct', 'climb_ft_per_mi', 'elevation_source', 'profile_points_stored', 'profile', 'named_sections', 'page_url'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'max_ft': {'type': ['number', 'null']}, 'min_ft': {'type': ['number', 'null']}, 'profile': {'type': 'array', 'items': {'type': 'object', 'required': ['mi', 'ft'], 'properties': {'ft': {'type': 'number'}, 'mi': {'type': 'number'}}, 'additionalProperties': False}, 'description': 'Sampled elevation. The highest and lowest points are kept.'}, 'climb_ft': {'type': ['number', 'null']}, 'page_url': {'type': 'string'}, 'descent_ft': {'type': ['number', 'null']}, 'distance_mi': {'type': 'number'}, 'steepest_pct': {'type': ['number', 'null']}, 'named_sections': {'type': 'array', 'items': {'type': 'object', 'required': ['kind', 'name', 'from_mi', 'to_mi', 'net_ft', 'grade_pct'], 'properties': {'kind': {'type': 'string'}, 'name': {'type': 'string'}, 'to_mi': {'type': 'number'}, 'net_ft': {'type': 'number'}, 'from_mi': {'type': 'number'}, 'grade_pct': {'type': 'number'}}, 'additionalProperties': False}}, 'climb_ft_per_mi': {'type': ['number', 'null']}, 'elevation_source': {'type': 'string'}, 'profile_points_stored': {'type': 'number'}}, 'additionalProperties': False}
ourpr_get_run
Get one run in full
One activity in full: mile splits, heart rate, cadence, calories, device. Id comes from ourpr_list_runs. For the profile along the route, use ourpr_run_stream.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['activity_id'], 'properties': {'activity_id': {'type': 'string', 'description': 'Run id from ourpr_list_runs.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['run', 'splits'], 'properties': {'run': {'type': 'object', 'additionalProperties': {}}, 'splits': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}}, 'additionalProperties': False}
ourpr_get_trail_system
Get one trail system
Read one trail system: how many miles of path it holds, how many ways were mapped, where it sits, and where the measurement came from.
Args:
- slug (string): From ourpr_list_trail_systems. Example: 'trinity-trails'.
- response_format ('markdown' | 'json'): Default 'markdown'.
Returns:
{
"slug": string, "name": string, "region": string | null,
"total_mi": number, // every branch summed
"mapped_ways": number | null, // OpenStreetMap ways in the network
"source": string | null, // how the network and its coverage were built
"bbox": { "min_lat": number, "min_lng": number,
"max_lat": number, "max_lng": number } | null,
"page_url": string
}
`total_mi` counts the whole network. It is not a distance anyone runs in one go.
Examples:
- "How many miles of trail are in Fort Worth?" -> slug="trinity-trails"
- "Where does the network reach?" -> read bbox
Error handling:
- Returns the slug list suggestion when the slug is unknown.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': "The trail system's slug. Example: 'trinity-trails'."}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': "Output format. 'markdown' reads well in a chat answer. 'json' carries every field for further computation."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug', 'name', 'region', 'total_mi', 'mapped_ways', 'source', 'bbox', 'page_url'], 'properties': {'bbox': {'anyOf': [{'type': 'object', 'required': ['min_lat', 'min_lng', 'max_lat', 'max_lng'], 'properties': {'max_lat': {'type': 'number'}, 'max_lng': {'type': 'number'}, 'min_lat': {'type': 'number'}, 'min_lng': {'type': 'number'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'region': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'page_url': {'type': 'string'}, 'total_mi': {'type': 'number'}, 'mapped_ways': {'type': ['number', 'null']}}, 'additionalProperties': False}
ourpr_list_courses
List published running courses
List every running course published on ourpr., with its place, distance, climb and next race date.
Each course is a MEASURED centerline built from recorded runs, with elevation from a public terrain model: USGS 3DEP 10 m in the US, and the city's own 1 m model in Berlin. It is not a course map traced by hand.
START HERE. Every other course tool takes a slug, and this is where slugs come from.
Args:
- query (string, optional): Match the name and the place. Partial, case-insensitive.
- kind ('race' | 'trail' | 'route', optional): Keep one kind.
- course_type ('loop' | 'out-and-back' | 'point-to-point', optional): Keep one shape.
- min_distance_mi / max_distance_mi (number, optional): Bound the distance in miles.
- upcoming_only (boolean): Keep only courses whose race date has not passed. Default false.
- limit (number): 1 to 50. Default 20.
- offset (number): Skip this many. Default 0.
- response_format ('markdown' | 'json'): Default 'markdown'.
Returns:
{
"total": number, // matched the filters
"count": number, // in this answer
"offset": number,
"has_more": boolean,
"next_offset": number, // present when has_more
"published_total": number, // every published course
"courses": [{
"slug": string, // "boston-marathon"
"name": string, // the event's own name, title sponsor included
"place": string | null, // "Hopkinton → Boston, MA"
"kind": string,
"course_type": string,
"distance_mi": number,
"climb_ft": number | null,
"steepest_pct": number | null,
"next_race_date": string | null, // YYYY-MM-DD
"days_out": number | null, // null once the date has passed
"page_url": string
}]
}
The order is the race calendar: the soonest race first, then undated courses by distance.
Examples:
- "What marathons does ourpr. have?" -> min_distance_mi=26
- "Which race is next?" -> upcoming_only=true, limit=1
- "Anything in Fort Worth?" -> query="fort worth"
- Do not use when: you want the hills on one course. Use ourpr_get_course_terrain.
Error handling:
- Returns "No course matched" with the filters echoed when nothing matches.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'enum': ['race', 'trail', 'route'], 'type': 'string', 'description': "Keep only this kind. 'race' is a published event course, 'trail' is a trail segment, 'route' is an everyday loop."}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'The most courses to return.'}, 'query': {'type': 'string', 'maxLength': 120, 'description': "Match against the course name and its place. Case-insensitive, partial. Example: 'boston', 'fort worth', 'half'."}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'How many courses to skip. Use it with `next_offset`.'}, 'course_type': {'enum': ['loop', 'out-and-back', 'point-to-point'], 'type': 'string', 'description': 'Keep only this shape of course.'}, 'upcoming_only': {'type': 'boolean', 'default': False, 'description': 'Keep only courses whose next race date is today or later. A course with no date is dropped by this filter.'}, 'max_distance_mi': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': 'Keep only courses no longer than this, in miles.'}, 'min_distance_mi': {'type': 'number', 'maximum': 200, 'minimum': 0, 'description': 'Keep only courses at least this long, in miles.'}, 'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': "Output format. 'markdown' reads well in a chat answer. 'json' carries every field for further computation."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['total', 'count', 'offset', 'has_more', 'published_total', 'courses'], 'properties': {'count': {'type': 'number', 'description': 'Courses in this answer.'}, 'total': {'type': 'number', 'description': 'Courses that matched the filters.'}, 'offset': {'type': 'number'}, 'courses': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'place', 'kind', 'course_type', 'distance_mi', 'climb_ft', 'steepest_pct', 'next_race_date', 'days_out', 'page_url'], 'properties': {'kind': {'type': 'string'}, 'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'place': {'type': ['string', 'null']}, 'climb_ft': {'type': ['number', 'null']}, 'days_out': {'type': ['number', 'null']}, 'page_url': {'type': 'string'}, 'course_type': {'type': 'string'}, 'distance_mi': {'type': 'number'}, 'steepest_pct': {'type': ['number', 'null']}, 'next_race_date': {'type': ['string', 'null']}}, 'additionalProperties': False}}, 'has_more': {'type': 'boolean'}, 'next_offset': {'type': 'number'}, 'published_total': {'type': 'number', 'description': 'Every published course, before any filter.'}}, 'additionalProperties': False}
ourpr_list_plans
List planned runs in a date range
The runner's planned runs between two dates: day, name, miles, time, tag, the runner's note, whether a logged run fulfilled it, and whether ourpr. create wrote it. Read it before ourpr_plan_week so a new plan does not land on a day that already holds one.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'end_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Last day, YYYY-MM-DD. Default 13 days after the first.'}, 'start_date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'First day, YYYY-MM-DD. Default yesterday, so today is in the window in every time zone.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['plans', 'start_date', 'end_date', 'truncated'], 'properties': {'plans': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}, 'end_date': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'start_date': {'type': 'string'}}, 'additionalProperties': False}
ourpr_list_races
List the races in the history
Every race ourpr. finds in the history, newest first, tune-ups included: date, name, distance, time, pace and run id. Also the fastest result at 5K, 10K, half marathon and marathon among them.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 500, 'minimum': 1, 'description': 'Most rows to return.'}, 'distance': {'enum': ['5K', '10K', 'Half Marathon', 'Marathon', 'Ultra'], 'type': 'string', 'description': 'Only races at this distance.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['races', 'fastest', 'returned', 'total'], 'properties': {'races': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}, 'total': {'type': 'number'}, 'fastest': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}, 'returned': {'type': 'number'}}, 'additionalProperties': False}
ourpr_list_runs
List runs in a date range
Training history between two dates, newest first: date, name, type, miles, pace, time, elevation, average heart rate. Start here for totals, streaks, trends, or finding a run. For one run's splits, use ourpr_get_run with an id from here.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['start_date', 'end_date'], 'properties': {'limit': {'type': 'integer', 'default': 100, 'maximum': 500, 'minimum': 1, 'description': 'Most rows to return. The answer says what it left out.'}, 'end_date': {'type': 'string', 'description': 'Last day to include, YYYY-MM-DD. Example: 2026-06-30'}, 'start_date': {'type': 'string', 'description': 'First day to include, YYYY-MM-DD. Example: 2026-01-01'}, 'include_non_runs': {'type': 'boolean', 'default': False, 'description': 'Include rides, gym and other types. Runs only by default.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['runs', 'returned', 'total_in_window', 'truncated'], 'properties': {'runs': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}, 'returned': {'type': 'number'}, 'truncated': {'type': 'boolean'}, 'total_in_window': {'type': 'number'}}, 'additionalProperties': False}
ourpr_list_trail_systems
List trail systems
List every trail system ourpr. maps. A trail system is a whole network of connected paths, measured end to end, not a single route through it.
Args:
- response_format ('markdown' | 'json'): Default 'markdown'.
Returns:
{
"count": number,
"trail_systems": [{
"slug": string, // "trinity-trails"
"name": string,
"region": string | null, // "Fort Worth, TX"
"total_mi": number, // the whole network, all branches
"page_url": string
}]
}
Examples:
- "What trail networks does ourpr. map?" -> no arguments
- "How big is Trinity Trails?" -> read total_mi, or call ourpr_get_trail_system
- Do not use when: you want one measured route. Use ourpr_list_courses with kind='trail'.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'response_format': {'enum': ['markdown', 'json'], 'type': 'string', 'default': 'markdown', 'description': "Output format. 'markdown' reads well in a chat answer. 'json' carries every field for further computation."}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['count', 'trail_systems'], 'properties': {'count': {'type': 'number'}, 'trail_systems': {'type': 'array', 'items': {'type': 'object', 'required': ['slug', 'name', 'region', 'total_mi', 'page_url'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'region': {'type': ['string', 'null']}, 'page_url': {'type': 'string'}, 'total_mi': {'type': 'number'}}, 'additionalProperties': False}}}, 'additionalProperties': False}
ourpr_plan_week
Put runs on the runner's week
Write one planned run, or a week of them, onto days still ahead. Each lands on the runner's week as a plan they can see, edit and remove. Needs a token made with the write scope and ourpr. create. Never logs a run.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['plans'], 'properties': {'plans': {'type': 'array', 'items': {'type': 'object', 'required': ['date'], 'properties': {'tag': {'enum': ['easy', 'workout', 'race'], 'type': 'string', 'description': 'How hard: easy, workout or race.'}, 'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'YYYY-MM-DD, after today.'}, 'name': {'type': 'string', 'maxLength': 120, 'description': 'A short name for the run.'}, 'note': {'type': 'string', 'maxLength': 500, 'description': 'A line the runner will read.'}, 'miles': {'type': 'number', 'maximum': 200, 'minimum': 0.1, 'description': 'Planned distance.'}, 'is_long': {'type': 'boolean', 'description': "The week's long run."}, 'minutes': {'type': 'number', 'maximum': 1440, 'minimum': 1, 'description': 'Planned time.'}}, 'additionalProperties': False}, 'maxItems': 14, 'minItems': 1, 'description': 'One run, or up to fourteen.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['written'], 'properties': {'written': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}}, 'additionalProperties': False}
ourpr_rep_workouts
Find rep workouts across the history
Interval sessions found across the history, with reps and distances. Detection is conservative, so a session it misses is still in ourpr_list_runs.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 200, 'maximum': 1000, 'minimum': 10, 'description': 'How many recent activities to read.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['workouts', 'scanned'], 'properties': {'scanned': {'type': 'number'}, 'workouts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}}, 'additionalProperties': False}
ourpr_run_laps
Get a run's laps
The laps the watch recorded for one run — the runner's own button presses. Laps follow the workout; mile splits follow the mile.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['activity_id'], 'properties': {'activity_id': {'type': 'string', 'description': 'Run id from ourpr_list_runs.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['laps'], 'properties': {'laps': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}}, 'additionalProperties': False}
ourpr_run_stream
Get a run's elevation and sensor profile
A run's profile on a 10 m grid — elevation, heart rate, power, cadence — as min, average, max and coverage per channel, not every sample. No profile is a normal answer for an indoor run.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['activity_id'], 'properties': {'activity_id': {'type': 'string', 'description': 'Run id from ourpr_list_runs.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['grid_m', 'total_miles', 'samples', 'channels'], 'properties': {'grid_m': {'type': 'number'}, 'samples': {'type': 'number'}, 'channels': {'type': 'object', 'additionalProperties': {}}, 'total_miles': {'type': 'number'}}, 'additionalProperties': False}
ourpr_similar_terrain
Find runs over comparable ground
Stretches of past runs matching a distance and climb — what the runner has already done that resembles a race they are training for.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['miles', 'gain_ft'], 'properties': {'limit': {'type': 'integer', 'default': 8, 'maximum': 25, 'minimum': 1, 'description': 'How many to return.'}, 'miles': {'type': 'number', 'maximum': 200, 'minimum': 0.1, 'description': 'Target distance in miles.'}, 'gain_ft': {'type': 'number', 'maximum': 30000, 'minimum': 0, 'description': 'Target climb in feet.'}, 'tolerance_ft': {'type': 'number', 'default': 15, 'maximum': 200, 'minimum': 1, 'description': 'Climb tolerance, feet.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['matches', 'scanned'], 'properties': {'matches': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}, 'scanned': {'type': 'number'}}, 'additionalProperties': False}
ourpr_training_blocks
Get the goal race and training blocks
The goal race and its Block: race day, distance, goal time, which week of the Block today falls in, and miles for each week. Also the Blocks before past races, each with its result, weeks and peak week. A Block is the race-anchored Monday to Sunday weeks before a race.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'past': {'type': 'integer', 'default': 3, 'maximum': 30, 'minimum': 0, 'description': 'How many past Blocks to include, newest first.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['goal', 'past', 'total_races'], 'properties': {'goal': {'anyOf': [{'type': 'object', 'additionalProperties': {}}, {'type': 'null'}]}, 'past': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': {}}}, 'total_races': {'type': 'number'}}, 'additionalProperties': False}
History
Recent tool changes
Changed
ourpr_get_course_terrain
Sept. 30, 2026, 2:40 a.m.
Changed
ourpr_list_courses
Sept. 30, 2026, 2:40 a.m.
Added
ourpr_plan_week
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_list_plans
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_list_races
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_training_blocks
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_similar_terrain
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_detect_reps
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_rep_workouts
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_run_laps
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_run_stream
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_get_run
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_list_runs
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_get_trail_system
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_list_trail_systems
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_get_course_route
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_get_course_amenities
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_get_course_terrain
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_get_course
Sept. 28, 2026, 2:40 a.m.
Added
ourpr_list_courses
Sept. 28, 2026, 2:40 a.m.
Discover
Similar MCP servers
SupplyGraph.AI Data
io.github.SupplyGraphAI/daasmart
Provides China-focused location, surrounding-area, company, industry-chain, property, population, retail, and regional business i…
Microburbs Australian Property Data
au.com.microburbs/property-data
Provides Australian property, suburb, valuation, sales, rental, zoning, school, risk, geospatial, and census statistics.
AIOProductOS MCP
com.aioproductos/mcp
Combines customer records, support conversations, feedback, product analytics, roadmaps, tasks, experiments, releases, and retent…
Wakatime
io.github.pipeworx-io/wakatime
Provides WakaTime coding-activity data, including durations, projects, commits, goals, heartbeats, editor usage, leaders, and use…
Timeapi Io
io.github.pipeworx-io/timeapi-io
Provides timezone and date utilities, along with routed access to structured research and data sources.
UK Environmental Intelligence MCP Server from MCPBundles
com.mcpbundles/uk-environmental-intelligence
Provides UK environmental intelligence covering flood warnings, river and groundwater readings, bathing water quality, ecology ob…
roadflow
io.roadflow/roadflow
Creates and shares roadmap graphs, and manages structured model registers containing parameters, observations, formulas, dictiona…
Ca Dmv
io.github.pipeworx-io/ca-dmv
Provides California DMV data on vehicle and EV registrations, driver licenses, DMV offices, forms, and insurer NAIC codes.