mcpbeat Sign in

Perigee MCP Server

by dlamarre-dev Your server? Claim it
answering

Perigee is answering right now. Last checked 12 min ago. 1 134 installs a week from npm. It exposes 19 tools. Last commit 3 Nov 2026.

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

Installs per day peak 562 · avg 76 · +131% w/w
a month agotoday
Uptime history 8 days of history
8 days agonow
100.0%
Uptime 24h
91 of 91 checks
19
Tools
read from the server
240 ms
Response time
average over 24h
1 134
Installs / week
npm and PyPI

What changed 17

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 31 October 2026. No other catalogue keeps this.

7 Nov a tool description was rewritten perigee_events
7 Nov a tool changed version
31 Oct 12 tools changed the parameters they ask for perigee_define, perigee_distance, perigee_distance_series and 9 more
31 Oct a tool changed version3 times that day
and 2 more, back to 31 October 2026

What the code does

We read the source, 3 d ago · tools taken from the live server · rules 995398eba69f

A tool parameter reaches a dangerous call

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

A tool parameter reaches a file or shell call perigee_describe_view.url → vite.config.ts:25, perigee_describe_view.url → vite.config.ts:184
        res.end(readFileSync(join(dir, name)));
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Builds a database query by concatenation src/render/BodyMesh.ts:438
    const cosSelect = Math.cos(PATCH_CAP_RAD + PATCH_MARGIN_RAD);
Runs an external command tools/perf/bench.ts:86
  const server = spawn(process.execPath, [vite, 'preview', '--port', String(PORT), '--strictPort'], {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 12 min ago.

run in your terminal
claude mcp add perigee --transport http https://perigee-mcp.perigeeinfo.workers.dev/mcp
Settings → Connectors → Add custom connector, then paste this address
https://perigee-mcp.perigeeinfo.workers.dev/mcp
~/.codex/config.toml
[mcp_servers.perigee]
url = "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "perigee": {
      "url": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "perigee": {
      "type": "http",
      "url": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
    }
  }
}

Available tools 19

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

perigee
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.
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.
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.
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.
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".
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.
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 (contact times; with a place: how they look from there, with the duration of totality or annularity and the altitude of the Sun or the Moon), 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.
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.
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.
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.
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).
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.
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.
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.
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.
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").
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).
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.
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.

Endpoints

URLTransportStateLatencyChecked
https://perigee-mcp.perigeeinfo.workers.dev/mcp streamable-http answering 402 ms 12 min ago

Alternatives to Perigee

same job, measured the same way
OrbitStudio
by orbitstudio3d

Find craters, mountains and landing sites on the Moon, Mars and more to 3D print in OrbitStudio.

6 tools answering
PowerStation Platform
by powerstationplatform

Transmission market data and TSR actions (MISO/SPP OASIS) from the PowerStation trading platform.

answering
Mapport
by cloudcorprecords

Geocoding, places, directions, distance, and elevation through Google Maps.

294 installs/wk local only
Semscraper
by semscraper

Real Google and Google Maps SERPs for AI assistants: pixel positions, AI Overviews and sources.

8 tools answering
Earth & Sky
by sslip-13-62-217-51

Live earthquakes, ISS position, weather, moon phase, and true star visibility. No key.

9 tools answering
Paradex Trading
by tradeparadex

MCP server for Paradex perp trading. Market data, accounts, orders, positions, and vaults.

149 installs/wk local only
Vesselapi MCP
by vessel-api

MCP server for the VesselAPI: maritime vessel tracking, port events and emissions

496 installs/wk local only
Serper.live
by serper-live

Live Google search results, domain positions and open markets via the Serper.live SERP API.

270 installs/wk local only

Perigee — questions

Answers built from our own checks of this server.

What can Perigee do?
It exposes 19 tools, read directly from the server on our last check. Among them: perigee_about, perigee_close_approach, perigee_define, perigee_describe_view, perigee_distance, perigee_distance_series and 13 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is Perigee working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 240 ms. The bar chart above shows every period we have measured.
How do I connect Perigee?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Perigee need an API key?
No. Perigee completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 19 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is Perigee?
It answers our handshake in 240 ms on average, which is faster than 61% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.
How many people use Perigee?
The npm package perigee-mcp was installed 1 134 times in the last week. Week over week that is +131%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Perigee open source?
The code is open source: it is published under the MIT licence, written in TypeScript, 4 stars on GitHub and 1 open issue. The licence covers the code in the repository, not the hosted service at perigee-mcp.perigeeinfo.workers.dev, which runs on its operator's own terms.