Servers Playground How we check Add a server Log in

Perigee

Working Security A

io.github.dlamarre-dev/perigeev1.9.2 GitHub verified

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

Research & Knowledge

Watch Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://perigee-mcp.perigeeinfo.workers.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

perigee_about Read-only

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.

This tool takes no arguments.

Perigee MCP server | mcptry

Tools (19)

perigee_about

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

perigee_close_approach

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.

read-only

Argument	Type	Description
to*	string	Second object id.
days	number	Length of the search in days (default 1).
from*	string	First object id.
lang	string	Language of names and texts (default en).
start	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
time_zone	string	IANA time zone for local times, e.g. "Europe/Paris".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Second object id."
    },
    "days": {
      "type": "number",
      "maximum": 1,
      "minimum": 0.01,
      "description": "Length of the search in days (default 1)."
    },
    "from": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "First object id."
    },
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "start": {
      "type": "string",
      "description": "ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now)."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA time zone for local times, e.g. \"Europe/Paris\"."
    }
  }
}

perigee_define

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.

read-only

Argument	Type	Description
lang	string	Language of names and texts (default en).
term	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "term": {
      "type": "string",
      "maxLength": 60
    }
  }
}

perigee_describe_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.

read-only

Argument	Type	Description
url*	string	A Perigee URL, e.g. https://perigee.info/?view=solar&sel=mars
lang	string	Language of names and texts (default en).
time_zone	string	IANA time zone for local times, e.g. "Europe/Paris".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "A Perigee URL, e.g. https://perigee.info/?view=solar&sel=mars"
    },
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA time zone for local times, e.g. \"Europe/Paris\"."
    }
  }
}

perigee_distance

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".

read-only

Argument	Type	Description
to*	string
date	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
from*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "date": {
      "type": "string",
      "description": "ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now)."
    },
    "from": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    }
  }
}

perigee_distance_series

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.

read-only

Argument	Type	Description
to*	string
end*	string	ISO 8601 UTC end.
from*	string
start*	string	ISO 8601 UTC start.
steps	integer	Number of intervals (default 50, at most 100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "from",
    "to",
    "start",
    "end"
  ],
  "properties": {
    "to": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "end": {
      "type": "string",
      "description": "ISO 8601 UTC end."
    },
    "from": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "start": {
      "type": "string",
      "description": "ISO 8601 UTC start."
    },
    "steps": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Number of intervals (default 50, at most 100)."
    }
  }
}

perigee_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.

read-only

Argument	Type	Description
days	number	Length of the period in days (default 30).
lang	string	Language of names and texts (default en).
kinds	array	Kinds of events to include (default: all).
start	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
latitude	number	Observer latitude, degrees (north positive).
longitude	number	Observer longitude, degrees (east positive).
time_zone	string	IANA time zone for local times, e.g. "Europe/Paris".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "days": {
      "type": "number",
      "maximum": 31,
      "minimum": 1,
      "description": "Length of the period in days (default 30)."
    },
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "kinds": {
      "type": "array",
      "items": {
        "enum": [
          "moon",
          "eclipse",
          "season",
          "planet",
          "mission"
        ],
        "type": "string"
      },
      "description": "Kinds of events to include (default: all)."
    },
    "start": {
      "type": "string",
      "description": "ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now)."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude, degrees (north positive)."
    },
    "longitude": {
      "type": "number",
      "maximum": 360,
      "minimum": -180,
      "description": "Observer longitude, degrees (east positive)."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA time zone for local times, e.g. \"Europe/Paris\"."
    }
  }
}

perigee_find

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.

read-only

Argument	Type	Description
limit	integer
query*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    }
  }
}

perigee_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.

read-only

Argument	Type	Description
id*	string
lang	string	Language of names and texts (default en).
start	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
orbits	number	Number of orbits (default 1).
points	integer	Number of points (default 180 per orbit).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "start": {
      "type": "string",
      "description": "ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now)."
    },
    "orbits": {
      "type": "number",
      "maximum": 2,
      "minimum": 0.1,
      "description": "Number of orbits (default 1)."
    },
    "points": {
      "type": "integer",
      "maximum": 360,
      "minimum": 10,
      "description": "Number of points (default 180 per orbit)."
    }
  }
}

perigee_object

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.

read-only

Argument	Type	Description
id*	string
lang	string	Language of names and texts (default en).
include_image	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "include_image": {
      "type": "boolean"
    }
  }
}

perigee_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).

read-only

Argument	Type	Description
id*	string
date	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
centre	string	Body the orbit is around, e.g. "sun" for a planet or a probe.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "date": {
      "type": "string",
      "description": "ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now)."
    },
    "centre": {
      "type": "string",
      "description": "Body the orbit is around, e.g. \"sun\" for a planet or a probe."
    }
  }
}

perigee_passes

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.

read-only

Argument	Type	Description
id*	string
days	number	Search length in days (default 3).
lang	string	Language of names and texts (default en).
start	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
height_m	number	Observer height above sea level, m.
latitude*	number	Observer latitude, degrees (north positive).
longitude*	number	Observer longitude, degrees (east positive).
time_zone	string

perigee_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.

read-only

Argument	Type	Description
id*	string
date	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
lang	string	Language of names and texts (default en).
hours	number	Length of the search in hours (default: two orbits).
centre	string	Body casting the shadow (default: the one the object orbits).
time_zone	string	IANA time zone for local times, e.g. "Europe/Paris".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "date": {
      "type": "string",
      "description": "ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now)."
    },
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "hours": {
      "type": "number",
      "maximum": 12,
      "minimum": 0.1,
      "description": "Length of the search in hours (default: two orbits)."
    },
    "centre": {
      "type": "string",
      "description": "Body casting the shadow (default: the one the object orbits)."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA time zone for local times, e.g. \"Europe/Paris\"."
    }
  }
}

perigee_sky

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.

read-only

Argument	Type	Description
date	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
lang	string	Language of names and texts (default en).
height_m	number	Observer height above sea level, m.
latitude*	number	Observer latitude, degrees (north positive).
longitude*	number	Observer longitude, degrees (east positive).
time_zone	string	IANA time zone for local times, e.g. "Europe/Paris".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now)."
    },
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "height_m": {
      "type": "number",
      "maximum": 9000,
      "minimum": -500,
      "description": "Observer height above sea level, m."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude, degrees (north positive)."
    },
    "longitude": {
      "type": "number",
      "maximum": 360,
      "minimum": -180,
      "description": "Observer longitude, degrees (east positive)."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA time zone for local times, e.g. \"Europe/Paris\"."
    }
  }
}

perigee_sky_conjunctions

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.

read-only

Argument	Type	Description
days	number	Length of the period in days (default 7; 1 with a satellite).
lang	string	Language of names and texts (default en).
start	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
height_m	number	Observer height above sea level, m.
latitude*	number	Observer latitude, degrees (north positive).
longitude*	number	Observer longitude, degrees (east positive).
satellite	string	An Earth satellite (NORAD number) to check against the Moon, planets and stars.

perigee_state

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").

read-only

Argument	Type	Description
id*	string
date	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
centre	string	Reference object id, e.g. "earth", "sun", "moon:moon", "mars".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "date": {
      "type": "string",
      "description": "ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now)."
    },
    "centre": {
      "type": "string",
      "description": "Reference object id, e.g. \"earth\", \"sun\", \"moon:moon\", \"mars\"."
    }
  }
}

perigee_stats

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).

read-only

Argument	Type	Description
lang	string	Language of names and texts (default en).
group	string
limit	integer	Largest entries listed per category (default 25).
owner	string
operator	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "group": {
      "type": "string",
      "maxLength": 60
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Largest entries listed per category (default 25)."
    },
    "owner": {
      "type": "string",
      "maxLength": 60
    },
    "operator": {
      "type": "string",
      "maxLength": 60
    }
  }
}

perigee_tonight

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.

read-only

Argument	Type	Description
date	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
lang	string	Language of names and texts (default en).
height_m	number	Observer height above sea level, m.
latitude*	number	Observer latitude, degrees (north positive).
longitude*	number	Observer longitude, degrees (east positive).
time_zone	string	IANA time zone for local times, e.g. "Europe/Paris".

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "latitude",
    "longitude"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now)."
    },
    "lang": {
      "enum": [
        "en",
        "fr"
      ],
      "type": "string",
      "description": "Language of names and texts (default en)."
    },
    "height_m": {
      "type": "number",
      "maximum": 9000,
      "minimum": -500,
      "description": "Observer height above sea level, m."
    },
    "latitude": {
      "type": "number",
      "maximum": 90,
      "minimum": -90,
      "description": "Observer latitude, degrees (north positive)."
    },
    "longitude": {
      "type": "number",
      "maximum": 360,
      "minimum": -180,
      "description": "Observer longitude, degrees (east positive)."
    },
    "time_zone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA time zone for local times, e.g. \"Europe/Paris\"."
    }
  }
}

perigee_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.

read-only

Argument	Type	Description
id*	string
date	string	ISO 8601 UTC instant, e.g. 2026-12-01T00:00:00Z (default: now).
lang	string	Language of names and texts (default en).
rate	number	Time multiplier: 1 real time, 0 paused.
panel	boolean	Keep the information panel in the embed.
follow	boolean	Follow the object (default true).
compare	string	With star_map: another star (star:<id>) drawn with its distance to compare.
star_map	boolean

Perigee

Try it

perigee_about Read-only

Perigee

Try it

perigee_about Read-only

Install

Tools (19)

Security checkA100/100