@interstellar-tools/mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Contacts while installing and starting: nothing
Its tool definitions changed since version 1.4.1. If you approved the earlier ones, read them again.
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y @interstellar-tools/mcp@2.0.1
Installing a package runs its code. Use a sandbox for anything you have not read.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
gravitational_parameter M_kg, m_kg
Compute the standard gravitational parameter μ = G·(M + m) from masses. Use this to get μ for the other orbit tools.
circular_speed r_m, mu_m3_s2
Speed of a circular orbit at radius r: v = √(μ/r).
escape_speed r_m, mu_m3_s2
Escape speed at radius r: v = √(2μ/r).
vis_viva_speed r_m, a_m, mu_m3_s2
Orbital speed at radius r on an orbit with semi-major axis a: v = √(μ(2/r − 1/a)). Use a > 0 for elliptic orbits and a < 0 for hyperbolic orbits.
kepler_period a_m, mu_m3_s2
Orbital period of an elliptic orbit from Kepler’s third law: T = 2π√(a³/μ).
24 more tools
peri_apoapsis_radii a_m, e
Periapsis rp = a(1 − e) and apoapsis ra = a(1 + e). For hyperbolic orbits (a < 0, e > 1) ra is null.
sphere_of_influence_radius a_m, m_kg, M_kg
Laplace sphere-of-influence radius of a secondary body orbiting a primary: r_SOI = a·(m/M)^(2/5).
state_to_elements r_m, v_m_s, mu_m3_s2
Classical orbital elements (a, e, i, Ω, ω, ν) from a position and velocity in an inertial frame centred on the body. Works for ellipses and hyperbolas. For a circular orbit ω is 0 and ν is measured from the node; for an equatorial one Ω is 0. Returns the periapsis radius, the specific energy, and the period if the orbit is elliptic.
elements_to_state a_m, e, i, raan, argp, nu, mu_m3_s2
Position and velocity in an inertial frame centred on the body, from classical orbital elements. Use a > 0 with e < 1 for an ellipse and a < 0 with e > 1 for a hyperbola; parabolas (e = 1) are not supported.
hohmann_transfer r1_m, r2_m, mu_m3_s2
Two-impulse Hohmann transfer between coplanar circular orbits of radius r1 and r2 around the same body. Returns both burns, total Δv and transfer time.
rocket_delta_v isp_s, m0_kg, mf_kg
Tsiolkovsky rocket equation from specific impulse: Δv = g0·Isp·ln(m0/mf).
plane_change_delta_v v_m_s, delta_i
Δv for a pure inclination change at constant speed: Δv = 2v·sin(Δi/2). Δi must be within [0°, 180°].
solve_lambert r1_m, r2_m, dt_s, mu_m3_s2, prograde
Find the orbit from position r1 to position r2 in time dt (Lambert’s problem), single revolution, for ellipses and hyperbolas alike. Returns the velocities at both ends. Positions are in an inertial frame centred on the body. For the burns, subtract the velocity of the orbit you leave from v1, and v2 from the velocity of the orbit you join. Positions 0° or 180° apart are an error: the transfer plane is undefined. Feed v1 to state_to_elements for the transfer orbit.
hyperbolic_departure v_inf_m_s, rp_m, mu_m3_s2
The burn from a circular parking orbit of radius rp onto the hyperbola that leaves the body with excess speed v∞, made at periapsis. The same Δv captures an arriving v∞ into that circular orbit. Also returns C3 = v∞², the launch-energy figure, and the hyperbola’s eccentricity. For an interplanetary transfer, v∞ is the difference between the planet’s velocity and the transfer orbit’s (from solve_lambert).
solve_kepler M, e
Solve Kepler’s equation M = E − e·sin(E) for the eccentric anomaly E, given mean anomaly M and eccentricity e (elliptic orbits). Robust up to e → 1.
convert_anomaly from, to, angle, e
Convert between mean, eccentric and true anomaly for an elliptic orbit. Results are normalised to [0, 2π).
convert_time value, from, to
Convert a duration between time units, from attoseconds to gigayears.
convert_distance value, from, to
Convert a distance between units, from metres to gigaparsecs. Datasets give orbit.a in au and radius in km, while the orbit tools take metres: convert with this tool first.
great_circle_distance from_latitude, from_longitude, to_latitude, to_longitude, body, radius_m
Shortest distance between two points along the surface of a sphere, and the central angle between them, from their latitudes and longitudes. Uses the body’s mean radius; on an oblate body like Earth the error is up to about 0.5%.
horizon_distance height_m, body, radius_m
How far an observer at a height above a sphere can see: the straight-line distance to the horizon, and the distance along the surface to it. No atmospheric refraction.
geodetic_to_body_fixed latitude, longitude, height_m, body, equatorial_radius_m, polar_radius_m
Body-fixed Cartesian position [x, y, z] of a point given by geodetic latitude, longitude and height above an oblate ellipsoid. x points to latitude 0, longitude 0; z to the north pole. On Earth, use body "wgs84" for GPS coordinates.
body_fixed_to_geodetic r_m, body, equatorial_radius_m, polar_radius_m
Geodetic latitude, longitude and height above an oblate ellipsoid, from a body-fixed Cartesian position [x, y, z]. The inverse of geodetic_to_body_fixed. On Earth, use body "wgs84" for GPS coordinates.
project_point projection, latitude, longitude, body, radius_m, center_longitude, center_latitude, standard_parallel
Map coordinates x (east) and y (north), in metres on a sphere, of a latitude and longitude in one of seven projections. equirectangular: plain latitude–longitude grid, as most planetary maps use. mercator: keeps angles, for navigation and web maps; no poles. sinusoidal and mollweide: keep areas, whole-world maps. lambert_azimuthal_equal_area: keeps areas around a centre point. stereographic: keeps angles around a centre point, for polar maps. orthographic: the globe as seen from far away; only the near hemisphere.
satellite_position satellite, tle, omm, time
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.
look_angles satellite, tle, omm, observer, time, frequency_hz
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.
satellite_passes satellite, tle, omm, observer, from, to, min_elevation
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 14 days. Only whole passes are returned.
probe_position probe, time
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.
lagrange_points primary, primary_mu_m3_s2, secondary, secondary_mu_m3_s2, separation_m
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.
find_body query, dataset
Look up celestial bodies by name or id (case-insensitive substring) across the bundled datasets. Each body has a stable `id` and names the body, system or galaxy it is bound to in `parent`; `orbit` holds its elements around that parent. Values carry their own units ({ value, unit }); `orbit.a` is usually in au, `orbit.period` in days (always positive; `orbit.retrograde: true` marks a retrograde orbit), `radius` in km, `orbit.angle` in radians at J2000. Interstellar objects have open orbits instead: `orbit.e` above 1, a negative `orbit.a`, no `orbit.period`, the perihelion time in `orbit.periapsisTime` and the incoming speed in `orbit.excessSpeed`. The Sun, planets and larger moons carry `mu` (G·M in m³/s²), ready for the orbit tools; stars also carry `mass` in solar masses.Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=22.12.0 |
| Source | github.com/phun-ky/interstellar-tools |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-RWmmKZ6bJd1EbBM0mfPTYscyEMazjOWEIhhuoNsNGdNt/6o64b4TdnQ4ZIwoOHz9691EIr9rjjkRoKUb01QTKw== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 2.0.1 | 2026-11-16 | Starts with no setup | 29 |
| 1.4.1 | 2026-11-12 | Starts with no setup | 29 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40interstellar-tools/mcp)
New version out? Ask for a fresh report.