npm - @interstellar-tools/mcp - Versions diffs - 1.2.1 → 1.3.0 - Mend

@interstellar-tools/mcp 1.2.1 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md +42 -26
package/dist/server.d.ts.map +1 -1
package/dist/server.js +3 -1
package/dist/server.js.map +1 -1
package/dist/tools/tracking.d.ts +3 -0
package/dist/tools/tracking.d.ts.map +1 -0
package/dist/tools/tracking.js +365 -0
package/dist/tools/tracking.js.map +1 -0
package/package.json +3 -2

package/README.md CHANGED Viewed

@@ -68,37 +68,48 @@ returned as `{ "rad": …, "deg": … }`.
 ## Tools
-| Tool                         | What it computes                                                |
-| ---------------------------- | --------------------------------------------------------------- |
-| `gravitational_parameter`    | μ = G·(M + m) from masses                                       |
-| `circular_speed`             | Circular orbit speed at radius r                                |
-| `escape_speed`               | Escape speed at radius r                                        |
-| `vis_viva_speed`             | Speed at radius r on an orbit with semi-major axis a            |
-| `kepler_period`              | Orbital period from semi-major axis                             |
-| `peri_apoapsis_radii`        | Periapsis and apoapsis radii from a and e                       |
-| `sphere_of_influence_radius` | Laplace sphere of influence                                     |
-| `state_to_elements`          | Orbital elements from a position and velocity                   |
-| `elements_to_state`          | Position and velocity from orbital elements                     |
-| `hohmann_transfer`           | Both burns, total Δv and transfer time                          |
-| `rocket_delta_v`             | Tsiolkovsky rocket equation from Isp and masses                 |
-| `plane_change_delta_v`       | Δv for a pure inclination change                                |
-| `solve_lambert`              | Velocities for a transfer between two positions in a given time |
-| `hyperbolic_departure`       | Δv, C3 and eccentricity to leave or be captured with a given v∞ |
-| `solve_kepler`               | Eccentric anomaly from mean anomaly and eccentricity            |
-| `convert_anomaly`            | Mean ↔ eccentric ↔ true anomaly (elliptic orbits)               |
-| `convert_time`               | Duration between units, attoseconds to gigayears                |
-| `convert_distance`           | Distance between units, metres to gigaparsecs                   |
-| `great_circle_distance`      | Distance and central angle between two points on a body         |
-| `horizon_distance`           | How far an observer at a height can see                         |
-| `geodetic_to_body_fixed`     | Body-fixed x, y, z from latitude, longitude and height          |
-| `body_fixed_to_geodetic`     | Latitude, longitude and height from body-fixed x, y, z          |
-| `project_point`              | Map x and y of a point in one of seven projections              |
-| `find_body`                  | Look up planets, moons, stars, comets, … by name or id          |
+| Tool                         | What it computes                                                    |
+| ---------------------------- | ------------------------------------------------------------------- |
+| `gravitational_parameter`    | μ = G·(M + m) from masses                                           |
+| `circular_speed`             | Circular orbit speed at radius r                                    |
+| `escape_speed`               | Escape speed at radius r                                            |
+| `vis_viva_speed`             | Speed at radius r on an orbit with semi-major axis a                |
+| `kepler_period`              | Orbital period from semi-major axis                                 |
+| `peri_apoapsis_radii`        | Periapsis and apoapsis radii from a and e                           |
+| `sphere_of_influence_radius` | Laplace sphere of influence                                         |
+| `state_to_elements`          | Orbital elements from a position and velocity                       |
+| `elements_to_state`          | Position and velocity from orbital elements                         |
+| `hohmann_transfer`           | Both burns, total Δv and transfer time                              |
+| `rocket_delta_v`             | Tsiolkovsky rocket equation from Isp and masses                     |
+| `plane_change_delta_v`       | Δv for a pure inclination change                                    |
+| `solve_lambert`              | Velocities for a transfer between two positions in a given time     |
+| `hyperbolic_departure`       | Δv, C3 and eccentricity to leave or be captured with a given v∞     |
+| `solve_kepler`               | Eccentric anomaly from mean anomaly and eccentricity                |
+| `convert_anomaly`            | Mean ↔ eccentric ↔ true anomaly (elliptic orbits)                   |
+| `convert_time`               | Duration between units, attoseconds to gigayears                    |
+| `convert_distance`           | Distance between units, metres to gigaparsecs                       |
+| `great_circle_distance`      | Distance and central angle between two points on a body             |
+| `horizon_distance`           | How far an observer at a height can see                             |
+| `geodetic_to_body_fixed`     | Body-fixed x, y, z from latitude, longitude and height              |
+| `body_fixed_to_geodetic`     | Latitude, longitude and height from body-fixed x, y, z              |
+| `project_point`              | Map x and y of a point in one of seven projections                  |
+| `satellite_position`         | Point below a satellite, its height and TEME state, from TLE or OMM |
+| `look_angles`                | Azimuth, elevation, range and Doppler shift from a ground observer  |
+| `satellite_passes`           | Rise, highest point and set over an observer, and visibility        |
+| `probe_position`             | Where a deep-space probe is, from the bundled ephemerides           |
+| `lagrange_points`            | L1 to L5 of two bodies, Trojan stability and the Hill sphere        |
+| `find_body`                  | Look up planets, moons, stars, comets, … by name or id              |
 The geodesy and map tools take the shape of the body as a `body` id from
 `find_body`, such as `"mars"`, or as radii in metres. For GPS coordinates on
 Earth, the ellipsoid tools also take `"wgs84"`.
+The satellite tools take orbital elements as a two-line element set (`tle`), an
+OMM record from CelesTrak (`omm`) or the id of a satellite in the bundled
+snapshot (`satellite`), and times as ISO 8601 UTC strings. The server fetches
+nothing: the assistant passes fresh elements in. Each result says how old the
+elements are, in `elements_age_d`; they go stale within days.
 All tools are pure and offline: no network access, no side effects.
 ## Resources
@@ -107,6 +118,11 @@ Each dataset in `@interstellar-tools/constants` is available as a JSON resource
 at `interstellar://datasets/{name}`, where `name` is one of `planets`, `moons`,
 `stars`, `comets`, `asteroids`, `asteroid-belts`, `galaxies` or `systems`.
+The snapshots in `@interstellar-tools/tracking` are resources too:
+`interstellar://tracking/satellites`, twelve satellites' OMM records dated 4
+November 2026, and `interstellar://tracking/probes`, eleven space probes and the
+span of their ephemerides.
 ## Programmatic use
 ```ts

package/dist/server.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;~~AAcpE~~,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,cAAc,EAAE,MAEpB,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,QAAO,~~SAoB~~/B,CAAC"}
1	+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAepE,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAEhD,kFAAkF;AAClF,eAAO,MAAM,cAAc,EAAE,MAEpB,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,QAAO,SAqB/B,CAAC"}

package/dist/server.js CHANGED Viewed

@@ -9,6 +9,7 @@ import { registerMapTools } from './tools/maps.js';
 import { registerOrbitTools } from './tools/orbits.js';
 import { registerStateVectorTools } from './tools/state-vectors.js';
 import { registerTimeTools } from './tools/time.js';
+import { registerTrackingTools } from './tools/tracking.js';
 export const SERVER_NAME = 'interstellar-tools';
 /** The published package version, read from `package.json` so it never drifts. */
 export const SERVER_VERSION = createRequire(import.meta.url)('../package.json').version;
@@ -26,7 +27,7 @@ export const SERVER_VERSION = createRequire(import.meta.url)('../package.json').
  */
 export const createServer = () => {
     const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, {
-        instructions: 'Deterministic orbital mechanics calculations. Every field with a unit ends with it: r_m is metres, mu_m3_s2 is m³/s², v_m_s is m/s, T_d is days. Dimensionless fields such as e have no suffix. Angles are given as { value, unit: "deg" | "rad" } and returned as { rad, deg }. Vectors are [x, y, z] arrays in an inertial frame centred on the body. Dataset distances are in au or km: use convert_distance before passing them to tools that take metres. Prefer these tools over mental arithmetic.'
+        instructions: 'Deterministic orbital mechanics calculations. Every field with a unit ends with it: r_m is metres, mu_m3_s2 is m³/s², v_m_s is m/s, T_d is days. Dimensionless fields such as e have no suffix. Angles are given as { value, unit: "deg" | "rad" } and returned as { rad, deg }. Vectors are [x, y, z] arrays in an inertial frame centred on the body. Dataset distances are in au or km: use convert_distance before passing them to tools that take metres. Satellite tools take orbital elements as a TLE, an OMM record or the id of a satellite in the bundled snapshot, and times as ISO 8601 UTC strings; elements go stale within days, so prefer fresh ones. Prefer these tools over mental arithmetic.'
     });
     registerOrbitTools(server);
     registerStateVectorTools(server);
@@ -36,6 +37,7 @@ export const createServer = () => {
     registerDistanceTools(server);
     registerGeodesyTools(server);
     registerMapTools(server);
+    registerTrackingTools(server);
     registerBodies(server);
     return server;
 };

package/dist/server.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;~~AAEpD~~,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEhD,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAW,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAClE,iBAAiB,CAClB,CAAC,OAAO,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAc,EAAE;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C;QACE,YAAY,EACV,~~2eAA2e~~;~~KAC9e~~,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
1	+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEhD,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAW,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAClE,iBAAiB,CAClB,CAAC,OAAO,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAc,EAAE;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C;QACE,YAAY,EACV,mrBAAmrB;KACtrB,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/tools/tracking.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const registerTrackingTools: (server: McpServer) => void;
+//# sourceMappingURL=tracking.d.ts.map

package/dist/tools/tracking.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/tools/tracking.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAyJzE,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,SAuWtD,CAAC"}

package/dist/tools/tracking.js ADDED Viewed

@@ -0,0 +1,365 @@
+import { AU_METERS, MOONS, PLANETS, SPEED_OF_LIGHT_M_PER_S, STARS } from '@interstellar-tools/constants';
+import { areTrojanPointsStable, convertDistanceUnit, hillSphereRadius, lagrangePoints, sunPosition } from '@interstellar-tools/equations';
+import { dopplerShift, earthShadow, isVisiblePass, lookAngles, parseOmm, parseTle, predictPasses, PROBES, propagate, SATELLITES, stateAt, subSatellitePoint } from '@interstellar-tools/tracking';
+import { z } from 'zod';
+import { angleOutput, angleOutputSchema, angleSchema, PURE_TOOL, result, toRadians, vectorOutputSchema } from './shared.js';
+const DAY_MS = 86_400_000;
+// The longest window satellite_passes searches: a few days of elements is
+// all that's accurate anyway
+const MAX_WINDOW_DAYS = 14;
+const SATELLITE_IDS = SATELLITES.map(({ id }) => id);
+const PROBE_IDS = PROBES.map(({ id }) => id);
+const elementsInput = {
+    satellite: z
+        .string()
+        .min(1)
+        .optional()
+        .describe(`Id of a satellite in the bundled snapshot, dated 2026-11-04: ${SATELLITE_IDS.join(', ')}. Snapshot elements go stale within days: prefer fresh elements from CelesTrak, passed as tle or omm.`),
+    tle: z
+        .tuple([z.string(), z.string()])
+        .optional()
+        .describe('A two-line element set: [line 1, line 2].'),
+    omm: z
+        .union([z.string(), z.record(z.string(), z.unknown())])
+        .optional()
+        .describe('One Orbit Mean-elements Message record, as CelesTrak returns it with FORMAT=json, or its JSON text.')
+};
+const observerSchema = z
+    .object({
+    latitude: angleSchema.describe('Geodetic latitude, north positive, e.g. { "value": -1.2864, "unit": "deg" }.'),
+    longitude: angleSchema.describe('Longitude, east positive, e.g. { "value": 36.8172, "unit": "deg" }.'),
+    height_m: z
+        .number()
+        .finite()
+        .default(0)
+        .describe('Height above the WGS 84 ellipsoid, in metres.')
+})
+    .describe('The observer on the ground.');
+const timeSchema = (what) => z
+    .string()
+    .min(1)
+    .describe(`${what}, an ISO 8601 time in UTC, e.g. "2026-11-05T15:49:00Z".`);
+const resolveElements = ({ satellite, tle, omm }) => {
+    const given = [satellite, tle, omm].filter((x) => x !== undefined).length;
+    if (given !== 1)
+        throw new Error('Give the elements exactly one way: satellite (a snapshot id), tle or omm.');
+    if (tle)
+        return parseTle(tle[0], tle[1]);
+    if (omm)
+        return parseOmm(omm);
+    const entry = SATELLITES.find(({ id }) => id === satellite.trim());
+    if (!entry)
+        throw new Error(`Unknown satellite: ${satellite}. The snapshot has ${SATELLITE_IDS.join(', ')}.`);
+    return parseOmm(entry.omm);
+};
+const parseTime = (name, text) => {
+    const date = new Date(text);
+    if (!Number.isFinite(date.getTime()))
+        throw new Error(`${name} must be an ISO 8601 time, like "2026-11-05T15:49:00Z". Received: ${text}`);
+    return date;
+};
+const toObserver = ({ latitude, longitude, height_m }) => ({
+    phi: toRadians(latitude),
+    lambda: toRadians(longitude),
+    h: height_m
+});
+// Days from the elements' epoch to a moment
+const ageDays = (elements, date) => (date.getTime() - elements.epoch.getTime()) / DAY_MS;
+const findBody = (id) => {
+    const needle = id.trim().toLowerCase();
+    const body = [...STARS, ...PLANETS, ...MOONS].find((entry) => entry.id === needle);
+    if (!body)
+        throw new Error(`Unknown body: ${id}. Use an id from find_body with a mu, such as "sun", "earth" or "moon".`);
+    if (body.mu === undefined)
+        throw new Error(`${body.id} has no mu in the datasets: give its mu instead.`);
+    return body;
+};
+// A body's μ, from its id or as given
+const resolveMu = (which, id, mu) => {
+    if ((id === undefined) === (mu === undefined))
+        throw new Error(`Give the ${which} body as an id or as its mu in m³/s², not both.`);
+    if (mu !== undefined)
+        return { mu };
+    const body = findBody(id);
+    return { mu: body.mu, body };
+};
+export const registerTrackingTools = (server) => {
+    server.registerTool('satellite_position', {
+        title: 'Satellite position',
+        description: 'Where a satellite is at a moment: the point on the ground below it, its height, its position and velocity in the TEME frame, and whether it is in Earth’s shadow. Propagates the elements with SGP4. Accurate to about a kilometre near the elements’ epoch, growing by a few kilometres a day: elements_age_d says how old they are.',
+        inputSchema: {
+            ...elementsInput,
+            time: timeSchema('The moment')
+        },
+        outputSchema: {
+            name: z.string().optional(),
+            epoch_utc: z.string(),
+            elements_age_d: z.number(),
+            latitude: angleOutputSchema,
+            longitude: angleOutputSchema,
+            height_m: z.number(),
+            speed_m_s: z.number(),
+            position_teme_m: vectorOutputSchema,
+            velocity_teme_m_s: vectorOutputSchema,
+            shadow: z.enum(['sunlit', 'penumbra', 'umbra'])
+        },
+        annotations: PURE_TOOL
+    }, ({ time, ...elementsGiven }) => {
+        const elements = resolveElements(elementsGiven);
+        const date = parseTime('time', time);
+        const { r, v } = propagate(elements, date);
+        const below = subSatellitePoint(elements, date);
+        return result({
+            ...(elements.name ? { name: elements.name } : {}),
+            epoch_utc: elements.epoch.toISOString(),
+            elements_age_d: ageDays(elements, date),
+            latitude: angleOutput(below.phi),
+            longitude: angleOutput(below.lambda),
+            height_m: below.h,
+            speed_m_s: Math.hypot(...v),
+            position_teme_m: r,
+            velocity_teme_m_s: v,
+            shadow: earthShadow(r, sunPosition(date).r)
+        });
+    });
+    server.registerTool('look_angles', {
+        title: 'Look angles to a satellite',
+        description: 'Where to point an antenna or a camera at a satellite from the ground at a moment: azimuth clockwise from north, elevation above the horizon, range, and range rate (negative while it approaches). Give frequency_hz for the Doppler shift of its signal. The elevation is geometric, without refraction.',
+        inputSchema: {
+            ...elementsInput,
+            observer: observerSchema,
+            time: timeSchema('The moment'),
+            frequency_hz: z
+                .number()
+                .positive()
+                .optional()
+                .describe('Transmitted frequency, in Hz, for the Doppler shift.')
+        },
+        outputSchema: {
+            azimuth: angleOutputSchema,
+            elevation: angleOutputSchema,
+            above_horizon: z.boolean(),
+            range_m: z.number(),
+            range_rate_m_s: z.number(),
+            doppler_shift_hz: z.number().optional(),
+            elements_age_d: z.number()
+        },
+        annotations: PURE_TOOL
+    }, ({ observer, time, frequency_hz, ...elementsGiven }) => {
+        const elements = resolveElements(elementsGiven);
+        const date = parseTime('time', time);
+        const angles = lookAngles(elements, toObserver(observer), date);
+        return result({
+            azimuth: angleOutput(angles.azimuth),
+            elevation: angleOutput(angles.elevation),
+            above_horizon: angles.elevation > 0,
+            range_m: angles.range,
+            range_rate_m_s: angles.rangeRate,
+            ...(frequency_hz === undefined
+                ? {}
+                : { doppler_shift_hz: dopplerShift(frequency_hz, angles.rangeRate) }),
+            elements_age_d: ageDays(elements, date)
+        });
+    });
+    server.registerTool('satellite_passes', {
+        title: 'Satellite passes',
+        description: `When a satellite passes over an observer between two times: rise, highest point and set, with azimuths, and whether each pass can be seen with the eye (the satellite sunlit while the Sun is below -6° for the observer). Searches at most ${MAX_WINDOW_DAYS} days. Only whole passes are returned.`,
+        inputSchema: {
+            ...elementsInput,
+            observer: observerSchema,
+            from: timeSchema('Start of the window'),
+            to: timeSchema('End of the window'),
+            min_elevation: angleSchema
+                .optional()
+                .describe('The elevation that counts as rising and setting: 0 by default, the horizon. 10° skips passes low behind trees and buildings.')
+        },
+        outputSchema: {
+            count: z.number(),
+            visible_count: z.number(),
+            elements_age_d: z.number(),
+            passes: z.array(z.object({
+                rise_utc: z.string(),
+                rise_azimuth: angleOutputSchema,
+                culmination_utc: z.string(),
+                culmination_azimuth: angleOutputSchema,
+                max_elevation: angleOutputSchema,
+                set_utc: z.string(),
+                set_azimuth: angleOutputSchema,
+                visible: z.boolean()
+            }))
+        },
+        annotations: PURE_TOOL
+    }, ({ observer, from, to, min_elevation, ...elementsGiven }) => {
+        const elements = resolveElements(elementsGiven);
+        const start = parseTime('from', from);
+        const end = parseTime('to', to);
+        const site = toObserver(observer);
+        if (end.getTime() - start.getTime() > MAX_WINDOW_DAYS * DAY_MS)
+            throw new Error(`The window must be at most ${MAX_WINDOW_DAYS} days: elements are only accurate for a few days around their epoch.`);
+        const passes = predictPasses(elements, site, start, end, {
+            ...(min_elevation ? { minElevation: toRadians(min_elevation) } : {})
+        }).map((pass) => ({
+            rise_utc: pass.rise.toISOString(),
+            rise_azimuth: angleOutput(pass.riseAzimuth),
+            culmination_utc: pass.culmination.toISOString(),
+            culmination_azimuth: angleOutput(pass.culminationAzimuth),
+            max_elevation: angleOutput(pass.maxElevation),
+            set_utc: pass.set.toISOString(),
+            set_azimuth: angleOutput(pass.setAzimuth),
+            visible: isVisiblePass(elements, site, pass)
+        }));
+        return result({
+            count: passes.length,
+            visible_count: passes.filter(({ visible }) => visible).length,
+            elements_age_d: ageDays(elements, start),
+            passes
+        });
+    });
+    server.registerTool('probe_position', {
+        title: 'Space probe position',
+        description: 'Where a deep-space probe is at a moment, from the bundled JPL Horizons ephemerides (1 November 2026 to 31 December 2027): its distance from the Sun, the light time, and its position and velocity from the Sun’s centre in the ICRF. Outside that span, fetch an ephemeris from JPL Horizons with horizons_id.',
+        inputSchema: {
+            probe: z
+                .enum(PROBE_IDS)
+                .describe('Id of the probe, e.g. "voyager-1" or "jwst".'),
+            time: timeSchema('The moment')
+        },
+        outputSchema: {
+            name: z.string(),
+            agencies: z.array(z.string()),
+            launch: z.string(),
+            status: z.enum(['active', 'ended']),
+            near: z.string(),
+            destination: z.string().optional(),
+            horizons_id: z.string(),
+            distance_au: z.number(),
+            distance_m: z.number(),
+            light_time_s: z.number(),
+            speed_m_s: z.number(),
+            position_m: vectorOutputSchema,
+            velocity_m_s: vectorOutputSchema
+        },
+        annotations: PURE_TOOL
+    }, ({ probe, time }) => {
+        const entry = PROBES.find(({ id }) => id === probe);
+        const { r, v } = stateAt(entry.ephemeris, parseTime('time', time));
+        const distance = Math.hypot(...r);
+        return result({
+            name: entry.name,
+            agencies: [...entry.agencies],
+            launch: entry.launch,
+            status: entry.status,
+            near: entry.near,
+            ...(entry.destination ? { destination: entry.destination } : {}),
+            horizons_id: entry.horizonsId,
+            distance_au: distance / AU_METERS,
+            distance_m: distance,
+            light_time_s: distance / SPEED_OF_LIGHT_M_PER_S,
+            speed_m_s: Math.hypot(...v),
+            position_m: r,
+            velocity_m_s: v
+        });
+    });
+    server.registerTool('lagrange_points', {
+        title: 'Lagrange points',
+        description: 'The five Lagrange points of two bodies circling each other, such as Sun-Earth (JWST at L2) or Sun-Jupiter (the Trojans at L4 and L5): positions in the frame turning with the bodies, from their barycentre, x from the larger body toward the smaller. Also whether L4 and L5 are stable, and the smaller body’s Hill sphere. Give each body as an id from find_body or as its mu.',
+        inputSchema: {
+            primary: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('The larger body’s id, e.g. "sun".'),
+            primary_mu_m3_s2: z
+                .number()
+                .positive()
+                .optional()
+                .describe('The larger body’s mu, in m³/s², instead of its id.'),
+            secondary: z
+                .string()
+                .min(1)
+                .optional()
+                .describe('The smaller body’s id, e.g. "earth".'),
+            secondary_mu_m3_s2: z
+                .number()
+                .positive()
+                .optional()
+                .describe('The smaller body’s mu, in m³/s², instead of its id.'),
+            separation_m: z
+                .number()
+                .positive()
+                .optional()
+                .describe('Distance between the bodies, in metres. Defaults to the smaller body’s semi-major axis, when the datasets give it around the larger.')
+        },
+        outputSchema: {
+            mass_ratio: z.number(),
+            separation_m: z.number(),
+            l1_m: vectorOutputSchema,
+            l2_m: vectorOutputSchema,
+            l3_m: vectorOutputSchema,
+            l4_m: vectorOutputSchema,
+            l5_m: vectorOutputSchema,
+            l1_from_secondary_m: z.number(),
+            l2_from_secondary_m: z.number(),
+            trojan_points_stable: z.boolean(),
+            hill_sphere_radius_m: z.number()
+        },
+        annotations: PURE_TOOL
+    }, ({ primary, primary_mu_m3_s2, secondary, secondary_mu_m3_s2, separation_m }) => {
+        const larger = resolveMu('larger', primary, primary_mu_m3_s2);
+        const smaller = resolveMu('smaller', secondary, secondary_mu_m3_s2);
+        const orbit = smaller.body && larger.body && smaller.body.parent === larger.body.id
+            ? smaller.body.orbit
+            : undefined;
+        const a = separation_m ??
+            (orbit ? convertDistanceUnit(orbit.a, 'm').value : undefined);
+        if (a === undefined)
+            throw new Error('Give separation_m: the datasets only give it for a body that orbits the other, such as earth around sun.');
+        const mu = smaller.mu / (larger.mu + smaller.mu);
+        const points = lagrangePoints(larger.mu, smaller.mu, a);
+        const at = (1 - mu) * a;
+        return result({
+            mass_ratio: mu,
+            separation_m: a,
+            l1_m: points.L1,
+            l2_m: points.L2,
+            l3_m: points.L3,
+            l4_m: points.L4,
+            l5_m: points.L5,
+            l1_from_secondary_m: at - points.L1[0],
+            l2_from_secondary_m: points.L2[0] - at,
+            trojan_points_stable: areTrojanPointsStable(larger.mu, smaller.mu),
+            hill_sphere_radius_m: hillSphereRadius(a, orbit?.e ?? 0, smaller.mu, larger.mu)
+        });
+    });
+    server.registerResource('satellites', 'interstellar://tracking/satellites', {
+        title: 'Satellite snapshot',
+        description: 'Orbital elements of twelve well-known satellites, as OMM records from CelesTrak dated 4 November 2026: for examples, not for tracking. Each has an id for the satellite field of the tracking tools.',
+        mimeType: 'application/json'
+    }, (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'application/json',
+                text: JSON.stringify(SATELLITES, null, 2)
+            }
+        ]
+    }));
+    server.registerResource('probes', 'interstellar://tracking/probes', {
+        title: 'Space probes',
+        description: 'Eleven notable space probes: agencies, launch dates, status, what each is near and heading for, and the span of its bundled ephemeris. probe_position gives their positions.',
+        mimeType: 'application/json'
+    }, (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: 'application/json',
+                text: JSON.stringify(PROBES.map(({ ephemeris, ...probe }) => ({
+                    ...probe,
+                    ephemeris_from_utc: ephemeris.samples[0].epoch.toISOString(),
+                    ephemeris_to_utc: ephemeris.samples[ephemeris.samples.length - 1].epoch.toISOString()
+                })), null, 2)
+            }
+        ]
+    }));
+};
+//# sourceMappingURL=tracking.js.map

package/dist/tools/tracking.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"tracking.js","sourceRoot":"","sources":["../../src/tools/tracking.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@interstellar-tools/mcp",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Model Context Protocol (MCP) server exposing interstellar-tools orbital mechanics, geodesy and map projection calculations and celestial body datasets to AI assistants.",
   "keywords": [
     "mcp",
@@ -56,9 +56,10 @@
   },
   "dependencies": {
     "@interstellar-tools/constants": "^1.1.1",
-    "@interstellar-tools/equations": "^1.8.0",
+    "@interstellar-tools/equations": "^1.13.0",
     "@interstellar-tools/maps": "^0.11.0",
     "@interstellar-tools/temporal": "^1.0.0",
+    "@interstellar-tools/tracking": "^0.9.0",
     "@interstellar-tools/types": "^1.0.0",
     "@modelcontextprotocol/sdk": "^1.32.2",
     "zod": "^4.6.7"