SportsTrackLive

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. Provide the file ONE of three ways — never reconstruct file content inside the conversation: (1) LOCAL file + shell available: run `curl -s -X POST https://mcp.sportstracklive.com/upload --data-binary @/path/to/file` in ONE command, then pass the returned `upload_id`; (2) file already online: pass its public https link as `file_url`, the server downloads it; (3) `file_base64` only for small files (< ~100 KB).

{
  "type": "object",
  "properties": {
    "filename": {
      "description": "File name including its extension — the extension selects the parser.\nSupported: .gpx, .tcx, .igc, .sbp, .fit",
      "type": "string"
    },
    "file_base64": {
      "description": "The file content, base64-encoded. Maximum 8 MiB decoded. Provide\neither this or `file_url`. Prefer `file_url` for files over ~100 KB:\nit keeps the payload out of the conversation.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "file_url": {
      "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`.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "upload_id": {
      "description": "Id returned by POST https://mcp.sportstracklive.com/upload — the way\nto analyze a LOCAL file when a shell is available: run\n`curl -s -X POST https://mcp.sportstracklive.com/upload --data-binary @/path/to/file`\n(one command, the file content never enters the conversation), then\npass the returned upload_id here with the original filename.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "sport": {
      "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.",
      "$ref": "#/$defs/SportKind",
      "default": "auto"
    },
    "measure_unit": {
      "description": "Preferred units for the computed metrics (\"metric\" default, or\n\"imperial\").",
      "$ref": "#/$defs/MeasureUnit"
    },
    "detail": {
      "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.",
      "$ref": "#/$defs/DetailLevel"
    }
  },
  "required": [
    "filename"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "SportKind": {
      "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.",
      "type": "string",
      "enum": [
        "auto",
        "paragliding",
        "hang_gliding",
        "glider",
        "balloon",
        "sailing",
        "windsurfing",
        "cycling",
        "mountain_biking",
        "running",
        "trail_running",
        "ski",
        "hiking",
        "motorsport",
        "other"
      ]
    },
    "MeasureUnit": {
      "type": "string",
      "enum": [
        "metric",
        "imperial"
      ]
    },
    "DetailLevel": {
      "type": "string",
      "enum": [
        "standard",
        "full"
      ]
    }
  }
}

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. Provide the file exactly like analyze_activity_file (upload_id / file_url / file_base64); pass pilot_name so the player credits the right person. Takes up to ~90 s (the full analysis pipeline runs).

{
  "type": "object",
  "properties": {
    "filename": {
      "description": "File name including its extension (.gpx, .tcx, .igc, .sbp, .fit).",
      "type": "string"
    },
    "file_base64": {
      "description": "Same three sources as analyze_activity_file — provide exactly one.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "file_url": {
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "upload_id": {
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "sport": {
      "description": "Sport of the activity — improves the analysis (thermals/phases for\nfree flight). Defaults to auto-ish generic handling server-side.",
      "$ref": "#/$defs/SportKind",
      "default": "auto"
    },
    "pilot_name": {
      "description": "Name of the pilot/athlete, shown in the 3D player instead of an\nanonymous placeholder. Use the user's name if they shared it.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "language": {
      "description": "BCP-47-ish language for the guest account pages (\"en\" default, \"fr\"…).",
      "type": [
        "string",
        "null"
      ],
      "default": null
    }
  },
  "required": [
    "filename"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "SportKind": {
      "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.",
      "type": "string",
      "enum": [
        "auto",
        "paragliding",
        "hang_gliding",
        "glider",
        "balloon",
        "sailing",
        "windsurfing",
        "cycling",
        "mountain_biking",
        "running",
        "trail_running",
        "ski",
        "hiking",
        "motorsport",
        "other"
      ]
    }
  }
}

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.

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

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.

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

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.

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

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. Provide the file exactly like analyze_activity_file (upload_id / file_url / file_base64).

{
  "type": "object",
  "properties": {
    "filename": {
      "description": "File name including its extension (.gpx, .tcx, .igc, .sbp, .fit).",
      "type": "string"
    },
    "file_base64": {
      "description": "Same three sources as analyze_activity_file — provide exactly one.",
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "file_url": {
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "upload_id": {
      "type": [
        "string",
        "null"
      ],
      "default": null
    },
    "sport": {
      "description": "Sport of the activity — selects the analysis profile.",
      "$ref": "#/$defs/SportKind",
      "default": "auto"
    }
  },
  "required": [
    "filename"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "SportKind": {
      "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.",
      "type": "string",
      "enum": [
        "auto",
        "paragliding",
        "hang_gliding",
        "glider",
        "balloon",
        "sailing",
        "windsurfing",
        "cycling",
        "mountain_biking",
        "running",
        "trail_running",
        "ski",
        "hiking",
        "motorsport",
        "other"
      ]
    }
  }
}

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.

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

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.

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