Satellite position
get_positionRead-onlyIdempotent
Where a satellite is now, or at a given time: the point on Earth straight below it (latDeg, lonDeg, not where it is in your sky), its altitude, and whether it is sunlit, with url (its page on seeksat.com). A location is optional: it only sets the time zone for local times and for reading a time with no offset (UTC without one). A time more than 30 days from the orbital elements' epoch is refused.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"satellite": "<satellite>"
},
"name": "get_position"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | observer latitude in decimal degrees, north positive (-90 to 90). Give it with lon, or give location instead. | |
| lon | No | observer longitude in decimal degrees, east positive and west negative (-180 to 180). | |
| time | No | when. Default: now. ISO 8601 with Z or an offset, e.g. "2026-11-14T21:00:00-06:00"; a time with no offset, e.g. "2026-11-14T21:00", is read in the observer's time zone, and the result echoes how it was read (interpretedAs). A local time the clocks skip at a daylight-saving change is moved forward, with a note. | |
| location | No | where the observer is, when lat and lon are not given (they win when both are): a Maidenhead grid square (EN52, EN52ve, EN52ve12), coordinates in any common form ("41.88, -87.63", "41.88N 87.63W", "41°52'48"N 87°37'48"W", a Google Maps link or geo: URI), all read locally, or a place name (city, address, landmark) looked up with OpenStreetMap. Prefer lat and lon, or a grid square, when you have them: a place name is a network lookup. Optional here. | |
| passTime | No | old name for time; still accepted. | |
| satellite | Yes | NORAD catalog number (as a number or a string) or a name, e.g. 25544, "25544" or "iss". |