analyze_activity_file

Analyze a GPS activity trace file (GPX, TCX, IGC, SBP or FIT, max 8 MiB) and return sport-specific metrics computed by the SportsTrackLive engine: distance, speeds, altitudes, and — depending on the sport — thermal detection with climb statistics, flight phases (glide/float/search) with glide polar and MacCready, wind estimation, lap detection around course marks, and splits. Stateless: nothing is stored, no account needed. HOW TO SEND THE FILE — pass exactly one of `file_url`, `upload_id` or `file_base64`. Take the first route below that works where you run and move on to the next whenever one is blocked; a blocked route is never a reason to stop or to ask the user to change settings. (1) The file already has a public https link: pass it as `file_url`. (2) You have a shell with outbound network access: `curl -s -X POST https://mcp.sportstracklive.com/upload --data-binary @/path/to/file` then pass the returned `upload_id`. A 403, a proxy error or a timeout here means your sandbox blocks the host — go to the next route. (3) The file is small: `file_base64`, keeping the base64 text under ~100 KB; gzip is inflated automatically, so `gzip -9 -c file | base64` fits traces 3–4× larger. (4) ALWAYS WORKS, including chat apps with no shell or a locked-down sandbox: call `create_upload_link`, give the user the link it returns, and once they have dropped the file there call this tool with the returned `upload_id`. Never retype or reconstruct file content by hand.

read-only

Argument	Type	Description
sport	any	Sport of the activity. Use "auto" (default) to let the server infer it from the file format and trace kinematics; the resolved sport is returned in `context_used.sport` and can be overridden on a second call.
detail	any	"standard" (default) returns every computed insight but strips the bulky point-level payloads (per-phase segment lists, wind timeline, pause/trim ranges) — a few KB instead of tens. "full" returns the raw engine output unabridged.
file_url	string \| null	Public https:// URL of the file (e.g. a cloud share or export link); the server downloads it (15 MiB cap). Provide exactly one of `file_url`, `upload_id` or `file_base64`.
filename*	string	File name including its extension — the extension selects the parser. Supported: .gpx, .tcx, .igc, .sbp, .fit
upload_id	string \| null	Id of a file already sent to the server, valid 15 minutes. Two ways to get one: (a) the `create_upload_link` tool — the user drops the file on the returned web page; works from any client, no shell needed; (b) with a shell that can reach the host: `curl -s -X POST https://mcp.sportstracklive.com/upload --data-binary @/path/to/file`. Pass the id here with the original filename.
file_base64	string \| null	The file content, base64-encoded — for small files only, since you emit every character yourself: keep the base64 text under ~100 KB. A gzip stream is detected and inflated server-side, so `gzip -9 -c file \| base64` is accepted as is and fits traces 3–4× larger. Past that, use `upload_id` (see `create_upload_link`).
measure_unit	any	Preferred units for the computed metrics ("metric" default, or "imperial").

Input schema (JSON)

{
  "type": "object",
  "$defs": {
    "SportKind": {
      "enum": [
        "auto",
        "paragliding",
        "hang_gliding",
        "glider",
        "balloon",
        "sailing",
        "windsurfing",
        "cycling",
        "mountain_biking",
        "running",
        "trail_running",
        "ski",
        "hiking",
        "motorsport",
        "other"
      ],
      "type": "string",
      "description": "Sport declared by the calling agent. `Auto` lets the server guess from\nthe file format and the trace kinematics; the resolved value is returned\nin `context_used` so the agent can correct it and call again."
    },
    "DetailLevel": {
      "enum": [
        "standard",
        "full"
      ],
      "type": "string"
    },
    "MeasureUnit": {
      "enum": [
        "metric",
        "imperial"
      ],
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "filename"
  ],
  "properties": {
    "sport": {
      "$ref": "#/$defs/SportKind",
      "default": "auto",
      "description": "Sport of the activity. Use \"auto\" (default) to let the server infer it\nfrom the file format and trace kinematics; the resolved sport is\nreturned in `context_used.sport` and can be overridden on a second call."
    },
    "detail": {
      "$ref": "#/$defs/DetailLevel",
      "description": "\"standard\" (default) returns every computed insight but strips the\nbulky point-level payloads (per-phase segment lists, wind timeline,\npause/trim ranges) — a few KB instead of tens. \"full\" returns the\nraw engine output unabridged."
    },
    "file_url": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Public https:// URL of the file (e.g. a cloud share or export link);\nthe server downloads it (15 MiB cap). Provide exactly one of\n`file_url`, `upload_id` or `file_base64`."
    },
    "filename": {
      "type": "string",
      "description": "File name including its extension — the extension selects the parser.\nSupported: .gpx, .tcx, .igc, .sbp, .fit"
    },
    "upload_id": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Id of a file already sent to the server, valid 15 minutes. Two ways\nto get one: (a) the `create_upload_link` tool — the user drops the\nfile on the returned web page; works from any client, no shell\nneeded; (b) with a shell that can reach the host:\n`curl -s -X POST https://mcp.sportstracklive.com/upload --data-binary @/path/to/file`.\nPass the id here with the original filename."
    },
    "file_base64": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "The file content, base64-encoded — for small files only, since you\nemit every character yourself: keep the base64 text under ~100 KB.\nA gzip stream is detected and inflated server-side, so\n`gzip -9 -c file | base64` is accepted as is and fits traces 3–4×\nlarger. Past that, use `upload_id` (see `create_upload_link`)."
    },
    "measure_unit": {
      "$ref": "#/$defs/MeasureUnit",
      "description": "Preferred units for the computed metrics (\"metric\" default, or\n\"imperial\")."
    }
  }
}

create_ephemeral_replay

Create an interactive 3D replay of the USER'S OWN trace file (GPX, TCX, IGC, SBP or FIT, max 8 MiB) on SportsTrackLive and return its link. The flight becomes a PRIVATE track owned by a temporary guest account — it appears in no listing or search — and the link stays valid 7 days, after which everything is purged. From the replay page the user can create an account to keep the flight permanently. Send the file through exactly one of `file_url` (public https link), `upload_id` or `file_base64` (small files; gzip accepted) — same routes as analyze_activity_file. If you cannot upload it yourself (no shell, or your sandbox answers 403 for mcp.sportstracklive.com), do not stop: call `create_upload_link`, have the user drop the file on the returned page, then pass its `upload_id` here. Pass pilot_name so the player credits the right person. Takes up to ~90 s (the full analysis pipeline runs).

Argument	Type	Description
sport	any	Sport of the activity — improves the analysis (thermals/phases for free flight). Defaults to auto-ish generic handling server-side.
file_url	string \| null
filename*	string	File name including its extension (.gpx, .tcx, .igc, .sbp, .fit).
language	string \| null	BCP-47-ish language for the guest account pages ("en" default, "fr"…).
upload_id	string \| null
pilot_name	string \| null	Name of the pilot/athlete, shown in the 3D player instead of an anonymous placeholder. Use the user's name if they shared it.

create_upload_link

Get a one-time web link the USER opens in their browser to send their trace file (GPX, TCX, IGC, SBP or FIT, max 8 MiB) to SportsTrackLive, plus the `upload_id` that analyze_activity_file, create_ephemeral_replay and import_activity then accept. Use it whenever you cannot transmit the file yourself: no shell, a sandbox that refuses mcp.sportstracklive.com (403), no public link, or a file too large for `file_base64`. Give the user the link as a clickable URL, ask them to drop the file there and to tell you when it is done, THEN call the file tool with the `upload_id`. The link and the file both expire after 15 minutes; the file is deleted afterwards and never listed anywhere.

No arguments.

Input schema (JSON)

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

get_live_activities

List public SportsTrackLive activities being recorded LIVE right now (paragliding flights, sailing races, rides, runs…), optionally filtered by sport and country. Each entry carries the athlete, sport, location, start time, latest recorded position/speed and a watch_url to follow the activity live in a browser.

read-only

Argument	Type	Description
limit	integer \| null	Max results, 1-50 (default 20).
sport	string \| null	Sport / category name filter, e.g. "paragliding", "sailing".
country	string \| null	Country filter: ISO 3166-1 alpha-2 code ("FR", "CH") or a country name.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint32",
      "maximum": 50,
      "minimum": 1,
      "description": "Max results, 1-50 (default 20)."
    },
    "sport": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 64,
      "description": "Sport / category name filter, e.g. \"paragliding\", \"sailing\"."
    },
    "country": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 64,
      "description": "Country filter: ISO 3166-1 alpha-2 code (\"FR\", \"CH\") or a country\nname."
    }
  }
}

get_track_replay_3d

Get the interactive 3D replay URL of an EXISTING PUBLIC SportsTrackLive track (Cesium terrain viewer with camera controls and timeline) plus its summary statistics. The URL must be opened in a web browser — share it with the user. NOT for a file the user just provided: for that, use create_ephemeral_replay, which builds a private replay of THEIR trace. Never substitute another athlete's track for the user's own file.

read-only

Argument	Type	Description
track_id*	integer	Numeric id of a public SportsTrackLive track.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "track_id"
  ],
  "properties": {
    "track_id": {
      "type": "integer",
      "format": "int64",
      "minimum": 1,
      "description": "Numeric id of a public SportsTrackLive track."
    }
  }
}

get_track_stats

Get the public statistics of a SportsTrackLive track by its numeric id: athlete, sport, location, date, duration, distance, speeds, altitudes and the track's web page URL. Only public tracks are returned; private tracks answer not_found.

read-only

Argument	Type	Description
track_id*	integer	Numeric id of a public SportsTrackLive track.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "track_id"
  ],
  "properties": {
    "track_id": {
      "type": "integer",
      "format": "int64",
      "minimum": 1,
      "description": "Numeric id of a public SportsTrackLive track."
    }
  }
}

import_activity

Import the user's trace file (GPX, TCX, IGC, SBP or FIT, max 8 MiB) into THEIR SportsTrackLive account permanently — full analysis, 3D replay, appears in their profile with their default privacy setting. REQUIRES the user to be connected via OAuth (this MCP server supports it; the client starts the flow). For a user without an account, use create_ephemeral_replay instead. Send the file through exactly one of `file_url` (public https link), `upload_id` or `file_base64` (small files; gzip accepted) — same routes as analyze_activity_file. If you cannot upload it yourself, call `create_upload_link`, have the user drop the file on the returned page, then pass its `upload_id` here.

Argument	Type	Description
sport	any	Sport of the activity — selects the analysis profile.
file_url	string \| null
filename*	string	File name including its extension (.gpx, .tcx, .igc, .sbp, .fit).
upload_id	string \| null
file_base64	string \| null	Same three sources as analyze_activity_file — provide exactly one.

Input schema (JSON)

{
  "type": "object",
  "$defs": {
    "SportKind": {
      "enum": [
        "auto",
        "paragliding",
        "hang_gliding",
        "glider",
        "balloon",
        "sailing",
        "windsurfing",
        "cycling",
        "mountain_biking",
        "running",
        "trail_running",
        "ski",
        "hiking",
        "motorsport",
        "other"
      ],
      "type": "string",
      "description": "Sport declared by the calling agent. `Auto` lets the server guess from\nthe file format and the trace kinematics; the resolved value is returned\nin `context_used` so the agent can correct it and call again."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "filename"
  ],
  "properties": {
    "sport": {
      "$ref": "#/$defs/SportKind",
      "default": "auto",
      "description": "Sport of the activity — selects the analysis profile."
    },
    "file_url": {
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "filename": {
      "type": "string",
      "description": "File name including its extension (.gpx, .tcx, .igc, .sbp, .fit)."
    },
    "upload_id": {
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "file_base64": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "Same three sources as analyze_activity_file — provide exactly one."
    }
  }
}

search_athletes

Search SportsTrackLive athletes by name (user name, first or last name). Returns id, user name, full name, country, number of public tracks and the public profile URL.

read-only

Argument	Type	Description
limit	integer \| null	Max results, 1-25 (default 10).
query*	string	Name to search for (user name, first name or last name), 2-64 chars.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint32",
      "maximum": 25,
      "minimum": 1,
      "description": "Max results, 1-25 (default 10)."
    },
    "query": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2,
      "description": "Name to search for (user name, first name or last name), 2-64 chars."
    }
  }
}

search_tracks

Search public SportsTrackLive tracks (finished, stored activities), newest first. Filter by free text (locality / take-off name or athlete user name), sport name, and an ISO date range. Returns per track the athlete, sport, location, date and web page URL; feed a track_id to get_track_stats for full statistics.

read-only

Argument	Type	Description
to	string \| null	Latest activity date, ISO `YYYY-MM-DD` (inclusive, UTC).
from	string \| null	Earliest activity date, ISO `YYYY-MM-DD` (inclusive, UTC).
limit	integer \| null	Max results, 1-25 (default 10).
query	string \| null	Free-text filter matched against the locality (take-off/venue) name and the athlete's user name.
sport	string \| null	Sport / category name, e.g. "paragliding", "cycling", "sailing".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "to": {
      "type": [
        "string",
        "null"
      ],
      "description": "Latest activity date, ISO `YYYY-MM-DD` (inclusive, UTC)."
    },
    "from": {
      "type": [
        "string",
        "null"
      ],
      "description": "Earliest activity date, ISO `YYYY-MM-DD` (inclusive, UTC)."
    },
    "limit": {
      "type": [
        "integer",
        "null"
      ],
      "format": "uint32",
      "maximum": 25,
      "minimum": 1,
      "description": "Max results, 1-25 (default 10)."
    },
    "query": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 64,
      "description": "Free-text filter matched against the locality (take-off/venue) name\nand the athlete's user name."
    },
    "sport": {
      "type": [
        "string",
        "null"
      ],
      "maxLength": 64,
      "description": "Sport / category name, e.g. \"paragliding\", \"cycling\", \"sailing\"."
    }
  }
}

SportsTrackLive

Try it

analyze_activity_file Read-only

SportsTrackLive

Try it

analyze_activity_file Read-only

Tools (9)