Skip to content

SportsTrackLive for AI agents ​

SportsTrackLive exposes its live-tracking data and its sport-specific analysis engine to AI agents through an official MCP server (Model Context Protocol) — the open standard used by Claude, ChatGPT and other assistants to call external tools.

Ask your assistant to analyze a flight file, check who is flying live, or build a 3D replay of your own trace — no SportsTrackLive account required. Sign in only if you want the assistant to save an activity to your account.

Connect the server ​

Endpointhttps://mcp.sportstracklive.com/mcp
TransportStreamable HTTP (modern and legacy MCP protocol versions)
AuthenticationNone for everything except import_activity, which uses OAuth 2.1 (the client opens the SportsTrackLive sign-in page)
Registry entrycom.sportstracklive/mcp on the official MCP Registry

Claude Code

bash
claude mcp add --transport http sportstracklive https://mcp.sportstracklive.com/mcp

Claude.ai — Settings → Connectors → Add custom connector, with the endpoint URL above.

ChatGPT — Settings → Connectors → enable developer mode → Create, with the endpoint URL above. ChatGPT only sees the SportsTrackLive tools once the connector has been added to your account.

Other MCP clients — add a remote (Streamable HTTP) server with the endpoint URL above.

What the agent can do ​

ToolWhat it does
analyze_activity_fileAnalyze a GPS trace file (GPX, TCX, IGC, SBP, FIT — max 8 MiB) with the SportsTrackLive engine: distance, speeds, altitudes, and per-sport insights — thermal detection with climb statistics, flight phases (glide/float/search), glide polar and MacCready speed-to-fly, wind estimation, lap detection, splits. Stateless: nothing is stored.
create_ephemeral_replayTurn the user's trace file into an interactive 3D replay hosted on SportsTrackLive. The link stays private and valid 7 days; from the replay page the user can create an account to keep the flight.
import_activitySave the user's trace file to their SportsTrackLive account: full analysis, 3D replay, listed in their profile with their default privacy. Requires signing in (OAuth).
create_upload_linkGive the user a one-time web link to drop their file in the browser — for assistants that cannot send a file by themselves (see below).
get_live_activitiesWho is broadcasting live right now (position, altitude, speed, watch link).
get_track_statsFull statistics of a public track.
search_tracks / search_athletesSearch public tracks and athlete profiles.
get_track_replay_3d3D replay link of an existing public track.

Sending a file ​

Tool arguments travel through the model, so a file is never passed as an attachment. The file tools accept four routes; the assistant takes the first one that works where it runs:

  1. File already online — its public https link as file_url; the server downloads it.
  2. Shell with network access (e.g. Claude Code) — one command:
    bash
    curl -s -X POST https://mcp.sportstracklive.com/upload --data-binary @flight.igc
    then the returned upload_id goes to the tool.
  3. Small files — file_base64, up to ~100 KB of base64 text. Gzip is detected and inflated by the server, so gzip -9 -c flight.igc | base64 fits traces 3–4× larger.
  4. Upload link — works everywhere. The assistant calls create_upload_link and gives you a link. Open it, drop your file, tell the assistant it is done: it continues with the upload_id.

Route 4 is the one hosted chat apps need: their sandbox usually cannot reach external hosts (the upload command is refused), or they have no shell at all, and a full flight is too large to inline. If your assistant says it cannot send your file, ask it to use the SportsTrackLive upload link.

Example prompts ​

Analyze this IGC file from yesterday's paragliding flight: how many thermals, what average climb rate, and what wind estimate?

Who is flying live right now in the French Alps? Show me their current altitude and speed.

Take this FIT file from my sailing regatta and give me my lap times around the course marks.

Build a 3D replay of this GPX trace and give me the link.

Quotas & fair use ​

The anonymous tier is rate-limited per IP (file analyses, replay creations and reads each have their own budget). When a quota is exceeded the tool returns a structured error with a retry_after_s hint. Need more? Contact us.

REST API ​

Prefer plain HTTP? The public REST API is described by an OpenAPI specification: https://api.sportstracklive.com/api-docs/openapi.json — live activities, track data and statistics, search. See also the API reference for the track-upload and live-tracking endpoints.

Privacy ​

  • File analysis is stateless: the uploaded trace is processed in memory and uploads — direct or through an upload link — expire from the transient store after 15 minutes. An upload link only accepts a file while it is valid, and the file is never listed anywhere.
  • import_activity only runs after you signed in and approved the connection; the assistant never sees your password.
  • Ephemeral replays create a private track owned by a temporary guest account; everything is purged after 7 days unless the user claims the flight into a real account.
  • Privacy policy · Terms