Servers Playground How we check Add a server Log in

livedot MCP

Working · 3.4 s

me.livedot/mcpv1.0.1 Domain verified

Find someone in a live running or cycling race, clubs and coaches near you, and race-day weather.

Entertainment & Games

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://livedot.me/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

add_tour_notes Destructive

Set or add to a Windline cycling tour's notes for riders (what to pack, how the tour runs, meeting points; markdown, up to 10,000 characters), shown on the tour's page. Never a finished tour. Show the user the notes and get a yes first.

notesstring, required

The notes for riders, in markdown (up to 10,000 characters).

event_idstring, required

The tour's id, from list_my_events.

modestring

replace (default) or append.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

livedot MCP MCP server | mcptry

Tools (20)

add_tour_notes

destructive

Argument	Type	Description
mode	string	replace (default) or append.
notes*	string	The notes for riders, in markdown (up to 10,000 characters).
event_id*	string	The tour's id, from list_my_events.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "event_id",
    "notes"
  ],
  "properties": {
    "mode": {
      "enum": [
        "replace",
        "append"
      ],
      "type": "string",
      "description": "replace (default) or append."
    },
    "notes": {
      "type": "string",
      "description": "The notes for riders, in markdown (up to 10,000 characters)."
    },
    "event_id": {
      "type": "string",
      "description": "The tour's id, from list_my_events."
    }
  },
  "additionalProperties": false
}

club_in_race

Shows how a club, team or coach's athletes are doing in a live race. Use it when the user asks about a club or team in a race ("How is the UCT team doing in the Comrades?") or a coach's athletes ("How are Coach Nadia's runners doing in the Comrades?"). Inputs: club (its name or page address, windline.tech/c/<club> or runfast.tech/c/<club>) or coach; event if named. Returns: each member's km, time against goal or finish time, and a map with just their dots; each person opens their live card. If several clubs or coaches match, or their people are live in several races, it lists them so the user can choose. Limits: only what the club's public live map shows: members who chose to be findable, never a private run, never a position near the start or finish. Read-only.

read-only

Argument	Type	Description
club	string	The club or team as the user said it ("UCT", "the UCT team", "Coast Riders"), or its page address (runfast.tech/c/uct).
coach	string	Instead of club: a coach as the user said it ("Coach Nadia", "Nadia Pillay"), or the coach id a picker gave ("runfast:coach-nadia-pillay").
event	string	The race, if named: "Comrades", "Coast Classic".
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "club": {
      "type": "string",
      "description": "The club or team as the user said it (\"UCT\", \"the UCT team\", \"Coast Riders\"), or its page address (runfast.tech/c/uct)."
    },
    "coach": {
      "type": "string",
      "description": "Instead of club: a coach as the user said it (\"Coach Nadia\", \"Nadia Pillay\"), or the coach id a picker gave (\"runfast:coach-nadia-pillay\")."
    },
    "event": {
      "type": "string",
      "description": "The race, if named: \"Comrades\", \"Coast Classic\"."
    },
    "units": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string",
      "description": "Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric."
    }
  },
  "additionalProperties": false
}

create_event

Create an event in the signed-in account from GPX files or links: a cycling ride, tour or race (Windline) or a run or running race (RunFast). Pass every GPX the user gave as files: several files make a multi-day tour by themselves (never ask for the type when it's obvious), ordered by the numbers in their names (1, 01, "day-2", "Stage 3"), else by the map (each day starts where the last ended); day names, km, climbing and a suggested name come from the files, and the days follow one another from start, at the same time, skipping rest_days. The first call (without confirm) only reads the files and returns the plan: show the user that summary (days, order, dates, km, private or for a group) in one message and get one yes, then call again with the same files and confirm: true. visibility: private is just for them (Windline My Rides with its own private link, or a RunFast private run: never published, never on a page); shared is for a group, published later with publish_event. A personal ride or run someone is planning for themselves is private. If the signed-in person runs any club or organiser page (list_my_events lists them) and hasn't said who it's for, ask one short question first: is this a private ride or run for you, or a group ride or run for <club name>? Then use post_club_ride for the club, or create_event with visibility private for themselves. Tour notes for riders the organiser pasted or attached (text, markdown, or a document's text) go in notes, up to 10,000 characters (Windline tours, beta). A route can also come from another app's tool as its points or an encoded polyline (for example a route or activity map from a fitness app): pass it as polyline or points. Never ask the user to export a GPX if you already have the route's points.

Argument	Type	Description
tz	string	IANA time zone; else worked out from where the route starts.
url	string	A Ride with GPS collection for a multi-day tour (one day per route), used with starts.
club

event_status

Shows how a live race on livedot is going. Use it when the user asks how a race is going or who is leading ("How's the Comrades going?", "Who's leading the Coast Classic?"). Inputs: event (the race's name). Returns: whether it's live, how long it has been under way, how many people are on the public map, how many have finished, and the leaders the public race map shows, with a live map. If several races match, it lists them so the user can choose. Limits: public races only; only what the public race map shows. Read-only.

read-only

Argument	Type	Description
club	string	A club or team, if the user asked about one in this race (as club_in_race).
coach	string	A coach, if the user asked about their athletes in this race (as club_in_race).
event*	string	The race's name, e.g. "Comrades", "Coast Classic demo".
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "event"
  ],
  "properties": {
    "club": {
      "type": "string",
      "description": "A club or team, if the user asked about one in this race (as club_in_race)."
    },
    "coach": {
      "type": "string",
      "description": "A coach, if the user asked about their athletes in this race (as club_in_race)."
    },
    "event": {
      "type": "string",
      "description": "The race's name, e.g. \"Comrades\", \"Coast Classic demo\"."
    },
    "units": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string",
      "description": "Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric."
    }
  },
  "additionalProperties": false
}

event_weather

What the weather will be like for a cycling or running event, for the people taking part: "What will the weather be like for the NYC Marathon?", "Weather for the Comrades demo?". Within 10 days of the start: the live forecast (Apple Weather) along the course at the times the riders or runners get to each stretch, with the Windline forecast engine's rating (Good, Fair, Tough) and why, the headwind and tailwind stretches, heat stress and rain. Further out: 10 years of weather on that date (Copernicus ERA5), clearly labelled as history, not a forecast. With a map of the course coloured by the wind or the heat, and a link to the event's livedot page. If several events match it lists them: ask which one. Only for named events and races. Not for the user's own route or GPX file; for those use plan_route.

read-only

Argument	Type	Description
year	integer	The edition's year, if the user named one.
event*	string	The event's name, e.g. "NYC Marathon", "Gravel Burn", "Comrades demo".
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "event"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "The edition's year, if the user named one."
    },
    "event": {
      "type": "string",
      "description": "The event's name, e.g. \"NYC Marathon\", \"Gravel Burn\", \"Comrades demo\"."
    },
    "units": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string",
      "description": "Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric."
    }
  },
  "additionalProperties": false
}

find_clubs

Find running and cycling clubs near a place, e.g. best running club to join in Fourways, beginner cycling group near Sandton. Lists approved clubs and organisers on Windline (cycling) and RunFast (running) nearest first, with their weekly sessions, whether beginners are welcome, whether anyone can join (Open to anyone) or it's members only, their pace groups, their next session with its weather, the club's own links page when it has one, and a Join link to the club's page. Set beginners for "beginner friendly", "new to running", "for beginners"; set open for "open to anyone", "anyone can join", "no membership", "don't need to be a member". Only clubs that have added their area show; never a person. Say what each club chose to share, and nothing more. For coaches or personal trainers, use find_coaches.

read-only

Argument	Type	Description
km	number	How far from the place, in km (1 to 100). Leave it out for 25 km.
open	boolean	true for only clubs open to anyone (no membership needed): "open to anyone", "anyone can join", "no membership".
place*	string	The suburb, town or city, as the user said it, e.g. "Fourways", "Durban North", "Cape Town".
sport	string	cycling or running, or one sport: road, gravel, mtb, road-run, trail-run, tours (multi-day tours). Leave it out for both.
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.

find_coaches

Find cycling and running coaches and training groups near a place, e.g. personal cycling trainer in Johannesburg, running coach near Sandton, coaches near Fourways. Use it for any coach, personal trainer, coaching or training group question (never find_clubs, which lists clubs). Lists coaches and training groups on Windline (cycling) and RunFast (running) nearest first, with what they coach (road, MTB, gravel, triathlon, beginners, racing, marathon, ultra), how (1-on-1, small group, online), their next group session with its weather, whether beginners are welcome, the qualifications they state in their own words (livedot doesn't check them), a Book / contact link (their own) and their page. Only coaches who listed themselves and added their area; never anyone else. Say what each coach chose to share, and nothing more.

read-only

Argument	Type	Description
km	number	How far from the place, in km (1 to 100). Leave it out for 25 km.
place*	string	The suburb, town or city, as the user said it, e.g. "Fourways", "Durban North", "Cape Town".
sport	string	cycling or running. Leave it out for both.
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.
format	string	one-to-one for a personal trainer or private coaching, group for a training group or small group, online for remote coaching.

find_events

Find public cycling and running events near a place and when: races, multi-day tours, club rides and club runs on Windline and RunFast, e.g. trail runs near Cape Town in November, cycle tours around Johannesburg. Each with its date, where it starts, the weather (the forecast within 10 days, typical weather beyond), its club or organiser and an I'm in link to its page. Only published public events of approved clubs and organisers.

read-only

Argument	Type	Description
km	number	How far from the place, in km (1 to 100). Leave it out for 50 km.
kind	string	Only races, only multi-day tours, or only club rides or runs.
when	string	When, as the user said it: "November", "this weekend", "next month", "2026-11-14", or "2026-11-01 to 2026-11-30". Leave it out for the next four months.
place*	string	The suburb, town or city, as the user said it, e.g. "Fourways", "Durban North", "Cape Town".
sport	string	cycling or running, or one sport: road, gravel, mtb, road-run, trail-run, tours (multi-day tours). Leave it out for both.
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.

Input schema (JSON)

find_person

Finds a person who is live on livedot right now (cycling on Windline, running on RunFast) and answers where they are. Use it when the user asks where someone is or how they're doing in a race ("Where's Megan in the Comrades?"), or gives a livedot handle (@megan, livedot.me/megan) or a follow link. Inputs: name_or_handle as the user wrote it; event if they named the race; surname, bib, club, place or wave to narrow. Returns: for one clear match, the live answer (position, time against goal, finish estimate, the weather there) with a live map; for several matches, the 5 most likely and the total, so the user can pick (then call where_is with the chosen person id, or call again with what they add). Limits: only people who chose to be findable on public races can be found by name; a ride or run of their own (Ride live, Run live) only by their handle or follow link, never showing where it starts or ends. Read-only.

read-only

Argument	Type	Description
bib	string	A bib number, if the user gave one.
club	string	A club, if the user gave one.
wave	string	A start wave or start time, if the user gave one.
event	string	The race, if named: "Comrades", "Coast Classic". Narrows the search to that race.
place	string	A home town or country, if the user gave one.
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.

fly_route

Fly over a race course inline: "Fly the Comrades", "Show me the course", "What does the NYC Marathon route look like?". Returns a flyover of the course on a map that plays in the chat, coloured by the weather along it (the live forecast within 10 days of the start, 10 years of weather on that date beyond it, as event_weather), with a "Fly it in 3D" link to the full Fly the route and the event's livedot page. If several events match it lists them: ask which one. For a route the user gave as a GPX file or link (their own route), use plan_route: it flies over that route too.

read-only

Argument	Type	Description
year	integer	The edition's year, if named.
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.
event_or_route*	string	The event or route, e.g. "Comrades", "NYC Marathon", "Gravel Burn".

Input schema (JSON)

{
  "type": "object",
  "required": [
    "event_or_route"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "The edition's year, if named."
    },
    "units": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string",
      "description": "Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric."
    },
    "event_or_route": {
      "type": "string",
      "description": "The event or route, e.g. \"Comrades\", \"NYC Marathon\", \"Gravel Burn\"."
    }
  },
  "additionalProperties": false
}

invite_members

Invite a club's members, or a tour's riders, by email, from a list the organiser gives (a CSV, a spreadsheet's text, or names and addresses typed in): for a club or organiser page the signed-in person runs (page on Windline, club on RunFast) or a published tour of theirs (event). Each person gets one email from livedot: "<club> added you as a member" (or "<organiser> added you to <tour>") with Confirm; nobody joins until they confirm, and nobody is invited twice. The first call (without confirm) only reads the list and returns who would be invited and who's skipped (listed twice, invited before, unsubscribed, no usable email): show the organiser that, get a yes, then call again with confirm: true. A day's limit: 500 for club admins and managers, 50 for a tour's organiser, 20 for an account under a week old; the preview says how many go today.

Argument	Type	Description
csv	string	The list as the organiser gave it: a CSV or spreadsheet's text (any delimiter, with or without a header row), up to 2,000 people.
club	string	RunFast: the club address they manage (runfast.tech/c/<address>).
page	string	Windline: the club page address they run (livedot.me/<address> or windline.tech/c/<address>).
event	string	A published Windline tour of theirs, by its id from list_my_events.
people	array	Or the people as a list: [{ name, email }].
confirm	boolean	true only after the organiser said yes to the preview this tool returned.

list_my_events

The signed-in organiser's own events on Windline (rides, tours, races) or RunFast (runs, races, and their clubs' runs): each with its id, status (draft or published), who it's for (private or shared), dates, distance, whether it's finished, and its dashboard, public or private links; and the club and organiser pages they run (pages on Windline, clubs on RunFast). Call it before making a new event, to know whether to ask who it's for; and to find an event id before changing one.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

plan_route

Weather and a flyover for a GPX file or route the user shares. If the user attached a GPX or route file, call plan_route and pass the file as gpx_file; if you can read the file's contents yourself, you may instead pass its text as gpx or its points as points. Never treat a file name as an event name. Also a Ride with GPS or GPX link, or another app's route points: the weather along it at the time they'd ride or run it, and a flyover of the route (a flyby, fly over my route) that plays in the chat, coloured by the weather: the forecast within 10 days, 10 years of weather on that date beyond it, rated by Windline's forecast engine, with the headwind and tailwind stretches, heat and rain. No account needed. For "What will the wind be like on this route on Saturday at 6?" or "Show me the weather for this GPX and a flyover". The route stays theirs: nothing is published. For a 3D flight and a route video, offer to save it as a private ride or run with create_event (visibility private). Several GPX files are one multi-day tour: pass them all as files (ordered by the numbers in their names, else by the map; one day after another from start), never one call per file. A route can also come from another app's tool as its points or an encoded polyline (for example a route or activity map from a fitness app): pass it as polyline or points. Never ask the user to export a GPX if you already have the route's points.

read-only

Argument	Type	Description
tz	string	The route's IANA time zone, if known (else worked out from where it starts).
gpx	string	The GPX file's text (up to 5 MB): if the user pasted it, or attached a file you can read yourself (for example with code).
url	string	A link to the route: a Ride with GPS route, ride or collection (a collection gives one day per route), or any public link to a GPX file. Not Strava.

post_club_ride

Post a DRAFT group ride (Windline) or club run (RunFast) on a club or organiser page the signed-in person runs, from a GPX route or link, once or weekly: always for the group, never private. Publish it with publish_event. Confirm the details with the user first. If the signed-in person runs any club or organiser page (list_my_events lists them) and hasn't said who it's for, ask one short question first: is this a private ride or run for you, or a group ride or run for <club name>? Then use post_club_ride for the club, or create_event with visibility private for themselves. A route can also come from another app's tool as its points or an encoded polyline (for example a route or activity map from a fitness app): pass it as polyline or points. Never ask the user to export a GPX if you already have the route's points.

Argument	Type	Description
tz	string	IANA time zone; else worked out from where the route starts.
gpx	string	The GPX file's text (up to 5 MB): if the user pasted it, or attached a file you can read yourself (for example with code).
url	string	A link to the route: a Ride with GPS route, ride or collection (a collection gives one day per route), or any public link to a GPX file. Not Strava.
name*	string	The ride's or run's name, e.g. "Saturday coffee ride".
page*	string	The club or organiser page address (livedot.me/<address>).
place	string

publish_event

Publish one of the signed-in organiser's draft events, so anyone with its link can see it (Windline: at tour., event. or ride.windline.tech/<address>). Private events can't be published. ALWAYS ask the user to confirm first, then call with confirm: true.

destructive

Argument	Type	Description
address	string	Windline: the public address, lowercase letters, numbers and hyphens, e.g. "cape-coast-2027".
confirm*	boolean	true only after the user said yes.
event_id*	string	The draft's id, from list_my_events or create_event.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "event_id",
    "confirm"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Windline: the public address, lowercase letters, numbers and hyphens, e.g. \"cape-coast-2027\"."
    },
    "confirm": {
      "type": "boolean",
      "description": "true only after the user said yes."
    },
    "event_id": {
      "type": "string",
      "description": "The draft's id, from list_my_events or create_event."
    }
  },
  "additionalProperties": false
}

tap_on_the_back

Sends a tap on the back: a short buzz on the person's phone, with the sender's name if signed in (or a first name they give). In the day after a finish it arrives as a congratulation. Use it only when the user explicitly asks to give someone a tap on the back; one tap per request. Inputs: person (an id from find_person), or a livedot handle or follow link; or tour (the tap goes to the tour's organiser on its days); or club with event (one tap to each member on the club's live map who accepts taps). Side effects: sends a notification to the person (or to each club member, and it reports how many). Limits: follows each person's own settings; if taps are off, they aren't live, or they only accept taps from people with their link, it sends nothing and says so. Returns the live map.

Argument	Type	Description
club	string	A club or team, by its name or page address, or the club id a club card gave ("runfast:demo"): one tap to each of its members on the map.
code	string	A follow link or its code (windline.tech/f/<code>, runfast.tech/f/<code>).
name	string	The first name the user wants on the tap ("Sam"), if they gave one. A signed-in user's tap shows their own public name instead.
tour	string	A Windline tour, by its name, address or organiser ("Alistair's Durban tour"): the tap goes to the tour's organiser, who reads them out at night.
coach	string	A coach, or the coach id a team card gave ("runfast:coach-nadia-pillay"): one tap to each of their athletes on the map.
event

tour_notes

Beta, cycling tours only: the organiser's own notes for riders on a Windline tour (what to pack, how the tour runs, meeting points), for questions like "What should I pack for the Durban tour?". Answer only from the notes: quote and summarise them as the organiser's words, never invent anything, and say so when they don't cover the question.

read-only

Argument	Type	Description
tour*	string	The tour's name, address or organiser.
question	string	The rider's question, if any.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "tour"
  ],
  "properties": {
    "tour": {
      "type": "string",
      "description": "The tour's name, address or organiser."
    },
    "question": {
      "type": "string",
      "description": "The rider's question, if any."
    }
  },
  "additionalProperties": false
}

tour_route

A Windline cycling tour's route, day by day: "What's the Durban Tour 2027 route?", "Give me the GPX files for Alistair's tour", "Where is Alistair's Durban tour?". On the tour's days its card offers a tap on the back for the organiser (tap_on_the_back with tour). To fly over day 3 of a tour ("Give me the flyover for day 3 of TSF 2026"), pass day: 3. Finds a published tour by its name, its address or its organiser's or club's name, and returns each day (from and to, distance, climbing, start time), a map of every day, and the weather (the live forecast within 10 days, 10 years of weather on the date beyond). Route files (GPX, Garmin .fit) only when the organiser lets riders download them; otherwise say "The organiser hasn't made the route files available." Never make up a file link. If several tours match, ask which.

read-only

Argument	Type	Description
day	integer	One day of the tour to fly over (1 for day 1), when the user asks for a day: the flyover of that day and its Fly it in 3D link.
tour*	string	The tour's name, address or organiser, e.g. "ProLend 2027 Durban Tour", "AllyCat".
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "tour"
  ],
  "properties": {
    "day": {
      "type": "integer",
      "minimum": 1,
      "description": "One day of the tour to fly over (1 for day 1), when the user asks for a day: the flyover of that day and its Fly it in 3D link."
    },
    "tour": {
      "type": "string",
      "description": "The tour's name, address or organiser, e.g. \"ProLend 2027 Durban Tour\", \"AllyCat\"."
    },
    "units": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string",
      "description": "Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric."
    }
  },
  "additionalProperties": false
}

update_event

Change one of the signed-in organiser's events: its name, description or notes, or start dates and times. Never a finished event (finished events stay as they were). Tell the user exactly what will change and get a yes first.

destructive

Argument	Type	Description
date	string	A one-off ride or run: its new date, YYYY-MM-DD.
days	array	Windline tours and races: [{ day: 2, date?: "YYYY-MM-DD", time?: "HH:MM" }].
name	string	A new name.
time	string	A ride or run: its new start time, HH:MM.
notes	string	RunFast runs only (tours: add_tour_notes).
place	string	RunFast: where it starts, in words.
event_id*	string	From list_my_events.
description	string	A new description for its public page.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "event_id"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "A one-off ride or run: its new date, YYYY-MM-DD."
    },
    "days": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "day": {
            "type": "integer"
          },
          "date": {
            "type": "string"
          },
          "time": {
            "type": "string"
          }
        }
      },
      "description": "Windline tours and races: [{ day: 2, date?: \"YYYY-MM-DD\", time?: \"HH:MM\" }]."
    },
    "name": {
      "type": "string",
      "description": "A new name."
    },
    "time": {
      "type": "string",
      "description": "A ride or run: its new start time, HH:MM."
    },
    "notes": {
      "type": "string",
      "description": "RunFast runs only (tours: add_tour_notes)."
    },
    "place": {
      "type": "string",
      "description": "RunFast: where it starts, in words."
    },
    "event_id": {
      "type": "string",
      "description": "From list_my_events."
    },
    "description": {
      "type": "string",
      "description": "A new description for its public page."
    }
  },
  "additionalProperties": false
}

where_is

Where someone is right now, in a live race or on a ride or run of their own (Ride live, Run live), and the weather they're in: km and mile on the course, time against their goal, pace, the finish time it points to, the temperature and wind there (headwind, tailwind or side-on) with the Windline forecast engine's rating, the wind and heat over the next few km, and a live map with a Follow live button. Use it with the person id find_person returned, or straight away with a livedot handle or follow link the user gave. It answers only what the public live page shows: if they're paused, stopped, near the start or finish, or not sharing, it says it can't share where they are; say so plainly.

read-only

Argument	Type	Description
code	string	A follow link or its code (windline.tech/f/<code>, runfast.tech/f/<code>). "demo" with app gives the demo.
units	string	Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric.
handle	string	A livedot handle ("megan") or link (livedot.me/megan).
person	string	A person id from find_person, e.g. "runfast:p:pdemo00megan" or "h:megan".

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "A follow link or its code (windline.tech/f/<code>, runfast.tech/f/<code>). \"demo\" with app gives the demo."
    },
    "units": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string",
      "description": "Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric."
    },
    "handle": {
      "type": "string",
      "description": "A livedot handle (\"megan\") or link (livedot.me/megan)."
    },
    "person": {
      "type": "string",
      "description": "A person id from find_person, e.g. \"runfast:p:pdemo00megan\" or \"h:megan\"."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "tz": {
      "type": "string",
      "description": "IANA time zone; else worked out from where the route starts."
    },
    "url": {
      "type": "string",
      "description": "A Ride with GPS collection for a multi-day tour (one day per route), used with starts."
    },
    "club": {
      "type": "string",
      "description": "RunFast: the club address (one they manage)."
    },
    "days": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "gpx": {
            "type": "string",
            "description": "The GPX file's text (up to 5 MB): if the user pasted it, or attached a file you can read yourself (for example with code)."
          },
          "url": {
            "type": "string",
            "description": "A link to the route: a Ride with GPS route, ride or collection (a collection gives one day per route), or any public link to a GPX file. Not Strava."
          },
          "label": {
            "type": "string",
            "description": "e.g. \"Day 1\", \"Stage 2\"."
          },
          "start": {
            "type": "string",
            "description": "Local start, \"YYYY-MM-DD HH:MM\" in the route's own time zone."
          },
          "points": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "description": "The route as its points: [[lat, lon], …], with elevation in metres as a third number if known. Up to 50,000. Use it for points another app's tool gave, or that you read from an attached file (GPX, FIT, TCX) with code."
          },
          "polyline": {
            "type": "string",
            "description": "The route as an encoded polyline (Google's format, precision 5 or 6), as another app's tool gives it (a route's or an activity's map)."
          }
        },
        "additionalProperties": false
      },
      "description": "One per day (a ride or a run: one). Or give url with a Ride with GPS collection and starts."
    },
    "name": {
      "type": "string",
      "description": "The event's name; with files, left out to use the suggested one."
    },
    "pace": {
      "type": "number",
      "description": "Riding km/h, or running seconds per km."
    },
    "page": {
      "type": "string",
      "description": "Windline: the club or organiser page address to show it on (one they run)."
    },
    "race": {
      "type": "boolean",
      "description": "RunFast: a race (once, with a gun time) rather than a run."
    },
    "type": {
      "enum": [
        "ride",
        "tour",
        "race",
        "run"
      ],
      "type": "string",
      "description": "ride, tour or race on Windline (cycling); run on RunFast (a running race: type run with race: true). Leave it out when it's obvious: several files make a tour, one file a ride (or a run on a RunFast account)."
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "gpx": {
            "type": "string",
            "description": "The GPX text."
          },
          "url": {
            "type": "string",
            "description": "A link to the GPX or route (Ride with GPS; not Strava)."
          },
          "name": {
            "type": "string",
            "description": "The file's name, e.g. \"day-2.gpx\"."
          },
          "points": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "description": "The day as its points, [[lat, lon], …]."
          },
          "file_id": {
            "type": "string",
            "description": "ChatGPT: the attached file's id."
          },
          "polyline": {
            "type": "string",
            "description": "The day as an encoded polyline (another app's route or activity map)."
          },
          "download_url": {
            "type": "string",
            "description": "ChatGPT: the attached file's download link."
          }
        },
        "description": "A GPX file (its text, or a link to it) or a route's polyline or points, and its name (the name helps order the days)."
      },
      "description": "Every GPX the user attached or linked, in the order they came: one per day of a tour, one for a ride or run."
    },
    "notes": {
      "type": "string",
      "description": "Tours: the organiser's notes for riders (what to pack, meeting points), as they pasted or attached them, markdown, up to 10,000 characters. RunFast: a short note (600 characters)."
    },
    "place": {
      "type": "string",
      "description": "RunFast: where it starts, in words."
    },
    "start": {
      "type": "string",
      "description": "With files: day 1's local start, \"YYYY-MM-DD HH:MM\" (the same time every day unless starts says otherwise). Ask if they didn't say."
    },
    "points": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "description": "The route as its points: [[lat, lon], …], with elevation in metres as a third number if known. Up to 50,000. Use it for points another app's tool gave, or that you read from an attached file (GPX, FIT, TCX) with code."
    },
    "starts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Each day's own local start, \"YYYY-MM-DD HH:MM\", when they differ (with url or files)."
    },
    "weekly": {
      "type": "object",
      "properties": {
        "days": {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        "time": {
          "type": "string"
        }
      },
      "description": "A weekly ride or run: { days: [0-6, Sunday is 0], time: \"HH:MM\" }."
    },
    "confirm": {
      "type": "boolean",
      "description": "With files: true only after the user said yes to the plan this tool returned."
    },
    "gpx_file": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string",
          "description": "The file's id."
        },
        "file_name": {
          "type": "string",
          "description": "Its name, if known (the route's name; never an event's)."
        },
        "mime_type": {
          "type": "string",
          "description": "Its type, if known."
        },
        "download_url": {
          "type": "string",
          "description": "The file's download link."
        }
      },
      "description": "The GPX or route file the user attached (ChatGPT passes it here)."
    },
    "polyline": {
      "type": "string",
      "description": "The route as an encoded polyline (Google's format, precision 5 or 6), as another app's tool gives it (a route's or an activity's map). One route: a ride, a run or a one-day race (with start)."
    },
    "gpx_files": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "download_url",
          "file_id"
        ],
        "properties": {
          "file_id": {
            "type": "string",
            "description": "The file's id."
          },
          "file_name": {
            "type": "string",
            "description": "Its name, if known (the route's name; never an event's)."
          },
          "mime_type": {
            "type": "string",
            "description": "Its type, if known."
          },
          "download_url": {
            "type": "string",
            "description": "The file's download link."
          }
        },
        "description": "One attached GPX or route file."
      },
      "description": "Several GPX or route files the user attached (ChatGPT passes them here): one per day of a tour, ordered by the numbers in their names, else by the map."
    },
    "rest_days": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "With files: dates with no riding, \"YYYY-MM-DD\", only if the user named rest days."
    },
    "visibility": {
      "enum": [
        "private",
        "shared"
      ],
      "type": "string",
      "description": "private: just for them (My Rides; a private run). shared: for a group, published later. Ask if they run a club and didn't say."
    },
    "description": {
      "type": "string",
      "description": "What the event is, for its public page."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "place"
  ],
  "properties": {
    "km": {
      "type": "number",
      "description": "How far from the place, in km (1 to 100). Leave it out for 50 km."
    },
    "kind": {
      "enum": [
        "race",
        "tour",
        "club ride",
        "club run"
      ],
      "type": "string",
      "description": "Only races, only multi-day tours, or only club rides or runs."
    },
    "when": {
      "type": "string",
      "description": "When, as the user said it: \"November\", \"this weekend\", \"next month\", \"2026-11-14\", or \"2026-11-01 to 2026-11-30\". Leave it out for the next four months."
    },
    "place": {
      "type": "string",
      "description": "The suburb, town or city, as the user said it, e.g. \"Fourways\", \"Durban North\", \"Cape Town\"."
    },
    "sport": {
      "enum": [
        "cycling",
        "running",
        "road",
        "gravel",
        "mtb",
        "road-run",
        "trail-run",
        "tours"
      ],
      "type": "string",
      "description": "cycling or running, or one sport: road, gravel, mtb, road-run, trail-run, tours (multi-day tours). Leave it out for both."
    },
    "units": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string",
      "description": "Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "csv": {
      "type": "string",
      "description": "The list as the organiser gave it: a CSV or spreadsheet's text (any delimiter, with or without a header row), up to 2,000 people."
    },
    "club": {
      "type": "string",
      "description": "RunFast: the club address they manage (runfast.tech/c/<address>)."
    },
    "page": {
      "type": "string",
      "description": "Windline: the club page address they run (livedot.me/<address> or windline.tech/c/<address>)."
    },
    "event": {
      "type": "string",
      "description": "A published Windline tour of theirs, by its id from list_my_events."
    },
    "people": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Their name."
          },
          "email": {
            "type": "string",
            "description": "Their email address."
          }
        }
      },
      "description": "Or the people as a list: [{ name, email }]."
    },
    "confirm": {
      "type": "boolean",
      "description": "true only after the organiser said yes to the preview this tool returned."
    },
    "csv_file": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string",
          "description": "The file's id."
        },
        "file_name": {
          "type": "string",
          "description": "Its name, if known (the route's name; never an event's)."
        },
        "mime_type": {
          "type": "string",
          "description": "Its type, if known."
        },
        "download_url": {
          "type": "string",
          "description": "The file's download link."
        }
      },
      "description": "The CSV or spreadsheet the organiser attached (ChatGPT passes it here); or pass its text as csv."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "start"
  ],
  "properties": {
    "tz": {
      "type": "string",
      "description": "The route's IANA time zone, if known (else worked out from where it starts)."
    },
    "gpx": {
      "type": "string",
      "description": "The GPX file's text (up to 5 MB): if the user pasted it, or attached a file you can read yourself (for example with code)."
    },
    "url": {
      "type": "string",
      "description": "A link to the route: a Ride with GPS route, ride or collection (a collection gives one day per route), or any public link to a GPX file. Not Strava."
    },
    "name": {
      "type": "string",
      "description": "What to call the plan, if the user named it."
    },
    "pace": {
      "type": "number",
      "description": "Riding speed in km/h (default 25), or running pace in minutes per km (default 6)."
    },
    "files": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "gpx": {
            "type": "string",
            "description": "The GPX text."
          },
          "url": {
            "type": "string",
            "description": "A link to the GPX or route (Ride with GPS; not Strava)."
          },
          "name": {
            "type": "string",
            "description": "The file's name, e.g. \"day-2.gpx\"."
          },
          "points": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "type": "number"
              }
            },
            "description": "The day as its points, [[lat, lon], …]."
          },
          "file_id": {
            "type": "string",
            "description": "ChatGPT: the attached file's id."
          },
          "polyline": {
            "type": "string",
            "description": "The day as an encoded polyline (another app's route or activity map)."
          },
          "download_url": {
            "type": "string",
            "description": "ChatGPT: the attached file's download link."
          }
        },
        "description": "A GPX file (its text, or a link to it) or a route's polyline or points, and its name (the name helps order the days)."
      },
      "description": "Several GPX files (a multi-day tour): ordered by the numbers in their names, else by the map; one day after another from start."
    },
    "sport": {
      "enum": [
        "ride",
        "run"
      ],
      "type": "string",
      "description": "ride (default) or run."
    },
    "start": {
      "type": "string",
      "description": "When they start, \"YYYY-MM-DD HH:MM\" local to the route. Ask if they didn't say."
    },
    "units": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string",
      "description": "Pass the asker's units: imperial for users in the US, UK road distances, Liberia or Myanmar, or when they ask in miles/°F; otherwise metric."
    },
    "points": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "description": "The route as its points: [[lat, lon], …], with elevation in metres as a third number if known. Up to 50,000. Use it for points another app's tool gave, or that you read from an attached file (GPX, FIT, TCX) with code."
    },
    "starts": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Each day's own local start, \"YYYY-MM-DD HH:MM\", when they differ."
    },
    "gpx_file": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string",
          "description": "The file's id."
        },
        "file_name": {
          "type": "string",
          "description": "Its name, if known (the route's name; never an event's)."
        },
        "mime_type": {
          "type": "string",
          "description": "Its type, if known."
        },
        "download_url": {
          "type": "string",
          "description": "The file's download link."
        }
      },
      "description": "The GPX or route file the user attached (ChatGPT passes it here)."
    },
    "polyline": {
      "type": "string",
      "description": "The route as an encoded polyline (Google's format, precision 5 or 6), as another app's tool gives it (a route's or an activity's map)."
    },
    "gpx_files": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "download_url",
          "file_id"
        ],
        "properties": {
          "file_id": {
            "type": "string",
            "description": "The file's id."
          },
          "file_name": {
            "type": "string",
            "description": "Its name, if known (the route's name; never an event's)."
          },
          "mime_type": {
            "type": "string",
            "description": "Its type, if known."
          },
          "download_url": {
            "type": "string",
            "description": "The file's download link."
          }
        },
        "description": "One attached GPX or route file."
      },
      "description": "Several GPX or route files the user attached (ChatGPT passes them here): one per day of a tour, ordered by the numbers in their names, else by the map."
    },
    "rest_days": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "With files: dates with no riding, \"YYYY-MM-DD\", only if the user named rest days."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "page",
    "name",
    "start"
  ],
  "properties": {
    "tz": {
      "type": "string",
      "description": "IANA time zone; else worked out from where the route starts."
    },
    "gpx": {
      "type": "string",
      "description": "The GPX file's text (up to 5 MB): if the user pasted it, or attached a file you can read yourself (for example with code)."
    },
    "url": {
      "type": "string",
      "description": "A link to the route: a Ride with GPS route, ride or collection (a collection gives one day per route), or any public link to a GPX file. Not Strava."
    },
    "name": {
      "type": "string",
      "description": "The ride's or run's name, e.g. \"Saturday coffee ride\"."
    },
    "page": {
      "type": "string",
      "description": "The club or organiser page address (livedot.me/<address>)."
    },
    "place": {
      "type": "string",
      "description": "RunFast: where it starts, in words."
    },
    "start": {
      "type": "string",
      "description": "A one-off: \"YYYY-MM-DD HH:MM\" local. Weekly: the first one."
    },
    "points": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "description": "The route as its points: [[lat, lon], …], with elevation in metres as a third number if known. Up to 50,000. Use it for points another app's tool gave, or that you read from an attached file (GPX, FIT, TCX) with code."
    },
    "weekly": {
      "type": "object",
      "properties": {
        "days": {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        "time": {
          "type": "string"
        }
      },
      "description": "Weekly: { days: [0-6, Sunday is 0], time: \"HH:MM\" }."
    },
    "gpx_file": {
      "type": "object",
      "required": [
        "download_url",
        "file_id"
      ],
      "properties": {
        "file_id": {
          "type": "string",
          "description": "The file's id."
        },
        "file_name": {
          "type": "string",
          "description": "Its name, if known (the route's name; never an event's)."
        },
        "mime_type": {
          "type": "string",
          "description": "Its type, if known."
        },
        "download_url": {
          "type": "string",
          "description": "The file's download link."
        }
      },
      "description": "The GPX or route file the user attached (ChatGPT passes it here)."
    },
    "polyline": {
      "type": "string",
      "description": "The route as an encoded polyline (Google's format, precision 5 or 6), as another app's tool gives it (a route's or an activity's map)."
    },
    "description": {
      "type": "string",
      "description": "What the ride or run is, for the club page."
    }
  },
  "additionalProperties": false
}