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
| Endpoint | https://mcp.sportstracklive.com/mcp |
| Transport | Streamable HTTP (modern and legacy MCP protocol versions) |
| Authentication | None for everything except import_activity, which uses OAuth 2.1 (the client opens the SportsTrackLive sign-in page) |
| Registry entry | com.sportstracklive/mcp on the official MCP Registry |
Claude Code
claude mcp add --transport http sportstracklive https://mcp.sportstracklive.com/mcpClaude.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
| Tool | What it does |
|---|---|
analyze_activity_file | Analyze 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_replay | Turn 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_activity | Save 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_link | Give 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_activities | Who is broadcasting live right now (position, altitude, speed, watch link). |
get_track_stats | Full statistics of a public track. |
search_tracks / search_athletes | Search public tracks and athlete profiles. |
get_track_replay_3d | 3D 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:
- File already online — its public https link as
file_url; the server downloads it. - Shell with network access (e.g. Claude Code) — one command:bashthen the returned
curl -s -X POST https://mcp.sportstracklive.com/upload --data-binary @flight.igcupload_idgoes to the tool. - Small files —
file_base64, up to ~100 KB of base64 text. Gzip is detected and inflated by the server, sogzip -9 -c flight.igc | base64fits traces 3–4× larger. - Upload link — works everywhere. The assistant calls
create_upload_linkand gives you a link. Open it, drop your file, tell the assistant it is done: it continues with theupload_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_activityonly 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
