Perigee

io.github.dlamarre-devPublished by GitHub account dlamarre-devv1.9.5Updated Oct 31, 2026

Positions, distances, mission facts and 3D views of objects orbiting the Earth, Moon, Mars and Sun.

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & AnalyticsMedia & Design

Overview

AI-generated overview

Perigee gives an assistant orbital positions, mission facts, sky events and live 3D views of satellites and spacecraft, for education.

What you can do
  • Look up objects and read their facts: planets, moons, missions, satellites, sites, stars, with sources and images
  • Compute positions, orbits, distances and distance series, with provenance and accuracy for each number
  • Predict satellite passes, ground tracks, shadow entry and exit, and close approaches between objects
  • Describe the sky from a place: what is up, tonight's highlights, conjunctions, Moon phases, eclipses and mission milestones
  • Count active satellites by owner, operator, constellation and orbit regime
  • Produce a 3D view link or embeddable iframe, describe it in words, and give student-level definitions of orbital terms
When to use it
Useful for teaching assistants and lesson material about space: answering where the ISS is, how far Mars is on a given date, when a satellite passes overhead, or what is visible tonight, and handing students a live 3D view with sourced, dated numbers.
Requirements
Either the hosted Streamable HTTP endpoint (no account) or the npm package perigee-mcp run locally over stdio with Node.js 20 or later. Optional environment variables PERIGEE_MCP_CACHE for the cache directory and PERIGEE_SITE for another deployment. Network access to fetch published data.
Before you install
Positions are for education only, not navigation, collision avoidance or conjunction assessment. The hosted endpoint applies a rate budget and keeps a short usage log of tool, object and outcome. Local runs download and cache datasets from the Perigee site; PERIGEE_SITE can redirect that source.

Installation

In SourceWeft

  1. Open Perigee in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.dlamarre-dev%2Fperigee/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "perigee": {
      "type": "http",
      "url": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
    }
  }
}

README

perigee-mcp

[npm version] [MCP Registry] [Perigee-mcp MCP connector – tool definition quality and endpoint health on Glama]

An MCP server for Perigee, the open-source 3D viewer of the artificial objects orbiting the Earth, the Moon and Mars and of the spacecraft crossing the solar system. It lets an AI assistant (a teaching assistant, for example) answer questions such as “how far is Mars from the Earth on 1 December 2026?”, “where is the ISS now?” or “what is Lucy's mission?”, and hand the student a live 3D view, with how each number was obtained, from which data, how fresh and how accurate.

Educational use only: not for navigation, collision avoidance or conjunction assessment.

Use it

Claude Desktop (claude_desktop_config.json) or any MCP client that starts servers over stdio:

json
{  "mcpServers": {    "perigee": { "command": "npx", "args": ["-y", "perigee-mcp"] }  }}

Claude Code: claude mcp add perigee -- npx -y perigee-mcp. Node.js 20 or later.

Hosted, nothing to install: the same tools at https://perigee-mcp.perigeeinfo.workers.dev/mcp (Streamable HTTP, no account, a budget of 60 units a minute per address, a tool call costing 1 to 4). Claude.ai: Settings → Connectors → Add custom connector with that URL; Claude Code: claude mcp add --transport http perigee https://perigee-mcp.perigeeinfo.workers.dev/mcp. Distance series are limited to 100 samples, pass searches to 3 days and event searches to 31 days there. The hosted endpoint keeps a short usage log (tool, object asked about, outcome; never your address or place coordinates; see the privacy page).

Tools

ToolWhat it returns
perigee_findIds of objects matching a name (English or French): planets, moons, missions, any active Earth satellite (name, NORAD or COSPAR id), sites, stars, comets, asteroids
perigee_objectFacts: agency, country, launch, status, mission goals, identifiers, official website, sources and verification date, image with credit and licence
perigee_statePosition and velocity at a date relative to a centre, distance, altitude, speed, light time, sunlight; the ground point below (country or sea on the Earth)
perigee_orbitPerigee and apogee altitudes, period, inclination, eccentricity; regime (LEO, MEO, GEO, HEO) for Earth satellites
perigee_passesWhen an Earth satellite passes over a place: rise, highest point and set with direction and elevation, naked-eye visibility, local times
perigee_skyThe sky from a place at a date: day, twilight or night, the Sun and its next rise and set, the Moon's phase, the planets and bright stars with direction, brightness and naked-eye visibility
perigee_eventsMoon phases (super and micro full Moons), eclipses (also as seen from a place), equinoxes, solstices, perihelion, planet oppositions, conjunctions and elongations, mission milestones
perigee_tonightWhat to see tonight from a place: the night's start and end, the Moon, the planets visible to the naked eye, the visible passes of the ISS, Tiangong and Hubble, close pairings and events, with short highlights
perigee_sky_conjunctionsClose pairings in the sky from a place: the Moon and planets with each other and with bright stars near the ecliptic, or a satellite passing near them
perigee_shadowWhether an object is in sunlight, penumbra or umbra of the body it orbits, and when it next enters or leaves the shadow
perigee_ground_trackThe path on the ground below an Earth satellite over one or two orbits: points and a GeoJSON line split at the antimeridian
perigee_close_approachThe closest distance between two objects in space over a period, timed precisely, with the relative speed of two satellites (education only, never collision avoidance)
perigee_statsCounts of active satellites by owner, operator, constellation, orbit regime, object type, launch year and altitude band
perigee_distanceDistance between two objects at a date (km, au) and light time
perigee_distance_seriesDistances over a period, with the closest and farthest samples
perigee_viewLink to the 3D view, and an <iframe> of the live view for a lesson page (the page can drive it and take PNG snapshots with the perigee:v1 messages); for a star, its 3D map with the Sun (star_map, compare)
perigee_describe_viewA Perigee link or embed in words: one-sentence alternative text and a description for lesson notes (view, object and reliability of its position, date, speed of time, frame, filters)
perigee_defineStudent-level definitions (EN/FR) of apogee, inclination, NORAD number, ephemeris window…
perigee_aboutData sources and fetch times, models and their typical accuracy, attribution

Every computed answer has a provenance list: the model (SGP4 from CelesTrak GP or supplemental GP elements, Hermite interpolation of JPL Horizons vectors, two-body extrapolation, VSOP87 for planets, analytical or mean-element moons), the data state (fresh, interpolated, stale, extrapolated, hidden, modelled, none), when the data were fetched, the age of the orbital elements, the ephemeris window, and a typical accuracy with its basis.

Data

Positions are computed on your machine with the same code as the web app, from the data Perigee publishes at https://perigee.info/data/ (CelesTrak elements refreshed every 4 hours, JPL Horizons ephemerides daily). Each dataset version is downloaded once and kept in a cache (%LOCALAPPDATA%\perigee-mcp, ~/Library/Caches/perigee-mcp or ~/.cache/perigee-mcp; PERIGEE_MCP_CACHE overrides it). The server never contacts CelesTrak or Horizons. PERIGEE_SITE points it to another Perigee deployment.

Credits: CelesTrak (T.S. Kelso) / 18th & 19th SDS via Space-Track, NASA/JPL-Caltech Horizons, astronomy-engine (MIT), satellite.js (MIT); catalogue images under the licence given with each. Code: MIT, https://github.com/dlamarre-dev/Perigee.

Source: mcp/README.md at commit f49f5ab

Tools

19

perigee_find

Find an object

Looks up objects by name or identifier (English or French, accents optional): planets, moons, missions beyond Earth orbit, featured science satellites, any active Earth satellite (by name, NORAD or COSPAR id), landing and launch sites, named stars. Returns ids for the other tools.

Parameterslimitqueryrequired

perigee_object

Object facts

Facts about an object: name, agency, country, launch date, status, mission goals and notes, identifiers (NORAD, COSPAR, Horizons), official website, sources and verification date, a catalogue image with credit and licence, and links to its view in Perigee. include_image also returns the image itself.

Parametersidrequiredlanginclude_image

perigee_state

Position and velocity

Position (km, ICRF/J2000 equatorial axes) and velocity (km/s) of an object at a date, relative to a centre (default: the body it orbits or stands on), with distance, altitude above the centre, speed, light time, whether it is in sunlight, and provenance. Around the Earth, the Moon or Mars it also gives the ground point below it (latitude, longitude; on the Earth the country or sea, e.g. "over Brazil", "over the Indian Ocean").

Parametersidrequireddatecentre

perigee_orbit

Orbit

Orbit of an object: perigee and apogee altitudes (periapsis/apoapsis), period, inclination, eccentricity, semi-major axis. Earth satellites: the mean elements of their published element set, with the orbit regime (LEO, MEO, GEO, HEO); other objects: instantaneous two-body elements around their centre at a date (default: the body they orbit; inclination on its equator, on the ecliptic around the Sun).

Parametersidrequireddatecentre

perigee_passes

Satellite passes over a place

When an Earth satellite (ISS = 25544, Tiangong = 48274, Hubble = 20580, or any NORAD number) passes over a place: rise, highest point and set times with direction (azimuth, compass point) and elevation, and whether it can be seen with the naked eye (sunlit satellite, dark sky) and when. Give the place's latitude and longitude (degrees, east positive) and, for local times, its IANA time zone. Up to 3 days ahead.

Parametersidrequireddayslangstartheight_mlatituderequiredlongituderequiredtime_zonemin_elevation

perigee_sky

The sky from a place

What is in the sky from a place at a date (default: now): day, twilight or night; the Sun with its next rise, set and twilights; the Moon with its phase, illuminated share, rise and set; each planet with its altitude, direction, brightness (magnitude), constellation and whether it can be seen with the naked eye; and the bright named stars above the horizon. For "what can I see tonight", give the evening time.

Parametersdatelangheight_mlatituderequiredlongituderequiredtime_zone

perigee_events

Astronomical and mission events

Events over a period (default: the next 30 days, at most 31): Moon phases (super and micro full Moons), lunar perigee and apogee, lunar and solar eclipses (with a place: how they look from there), equinoxes and solstices, the Earth's perihelion and aphelion, planet oppositions, conjunctions and greatest elongations, and the next key events of the missions (flybys, arrivals, launches) from Perigee's catalogue.

Parametersdayslangkindsstartlatitudelongitudetime_zone

perigee_tonight

Tonight from a place

What there is to see tonight from a place (the coming night, or the current one): the night's start and end, the Moon (phase, illuminated share, rise and set), the planets visible to the naked eye, the visible passes of the ISS, Tiangong and Hubble, the close pairings of the Moon and planets, and the sky's events of the night, with short highlights ready to read. Give the place's latitude and longitude and, for local times, its IANA time zone.

Parametersdatelangheight_mlatituderequiredlongituderequiredtime_zone

perigee_sky_conjunctions

Close pairings in the sky

Apparent close pairings seen from a place over a period (default 7 days, at most 7): the Moon and the planets with each other and with the bright stars near the ecliptic (Regulus, Spica, Antares, Aldebaran, Pollux…), at their closest, with where to look and whether the pair is visible (above the horizon, dark sky). With `satellite` (a NORAD number), that satellite passing near them during its passes over one day.

Parametersdayslangstartheight_mlatituderequiredlongituderequiredsatellitetime_zonemax_separation

perigee_shadow

Sunlight and shadow

Whether an object is in sunlight, in the penumbra or in the umbra of the body it orbits (Earth satellites: the Earth's shadow; lunar and Martian orbiters: the Moon's or Mars'), and when it next enters and leaves the shadow (default: over two orbits, at most 12 hours). Explains why a satellite crossing the night sky suddenly fades out.

Parametersidrequireddatelanghourscentretime_zone

perigee_ground_track

Ground track

The path on the ground below an Earth satellite over one or two orbits: a list of points (time, latitude, longitude, height) and a GeoJSON MultiLineString split at the antimeridian, ready for a map. Up to 360 points.

Parametersidrequiredlangstartorbitspoints

perigee_close_approach

Closest approach in space

The closest distance between two objects in space over a period (default 1 day, at most 1): when, how close (timed to a fraction of a second) and, for two Earth satellites, how fast they pass each other. For education only: public orbits are not precise enough for collision avoidance, and the answer says so.

Parameterstorequireddaysfromrequiredlangstarttime_zone

perigee_stats

Satellite statistics

Counts of the active satellites: total, by owner (country or organisation, e.g. US, PRC, CIS, ESA), by operator (SpaceX, OneWeb, Amazon Kuiper…), by CelesTrak group (constellations, navigation, weather…), by orbit regime (LEO, MEO, GEO, HEO), object type, launch year, recent launches and low-orbit altitude bands. owner, operator or group narrow a list to matching entries (code or name).

Parameterslanggrouplimitowneroperator

perigee_distance

Distance between two objects

Centre-to-centre distance between two objects at a date (km and astronomical units) and the light travel time, with the provenance of both positions. Example: from "earth" to "mars".

Parameterstorequireddatefromrequired

perigee_distance_series

Distance over a period

Distances between two objects sampled evenly over a period (for a table or a chart), with the closest and farthest samples. The step limits their precision: use more steps for a precise closest approach.

Parameterstorequiredendrequiredfromrequiredstartrequiredsteps

perigee_view

Link or embed a 3D view

Link to Perigee showing an object (optionally at a date, paused or accelerated, followed), and an iframe snippet for a lesson page: the live 3D view without bars or panels. The embedding page can then drive the view and take PNG snapshots with postMessage (protocol perigee:v1, documented in `embedApi`). For a star, star_map opens its 3D map with the Sun instead (every named star at its real distance, the Sun–star distance drawn; compare adds a second star), alone in the iframe.

Parametersidrequireddatelangratepanelfollowcomparestar_maptime_bar

perigee_describe_view

Describe a view

Turns a Perigee link or embed URL (from perigee_view or a shared link) into words: a one-sentence alternative text for the image or iframe, and a description for lesson notes (which view, the selected object, where it is and how reliable its position is, the date and speed of time, the frame, the filters and what is hidden). The camera framing is not in the link.

Parametersurlrequiredlangtime_zone

perigee_define

Define a term

Student-level definitions (secondary school) of the terms shown in Perigee: NORAD number, COSPAR id, apogee and perigee, inclination, orbital period, element epoch, ephemeris window, phase… Without a term, lists them all.

Parameterslangterm

perigee_about

Sources, models and accuracy

What every answer rests on: data sources and when they were fetched, the models and their typical accuracy, catalogue sizes, frame, attribution and the educational-use disclaimer.

Takes no parameters.

Version history

3
  1. v1.9.5LatestOct 31, 2026
  2. v1.9.3Oct 31, 2026
  3. v1.9.2Oct 30, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts