Skip to content
MCP server

Perigee

Positions, orbits and sky events for satellites, planets and probes, with sources shown

Pricing
Open source
Platforms
CLI, Web, API
Runs
Locally or Remotely
Version
1.10.1
Listing updated
3 days ago

About Perigee

Perigee is an open-source MCP server for health and science. It can run locally on your machine or as a hosted remote server.

Questions like how far Mars is from Earth on 1 December 2026, where the ISS is now, or what Lucy's mission is can be answered with the method behind each number: which data it came from, how fresh it is and how accurate. The README pitches it at teaching assistants, and an answer can include a live 3D view for the student.

Objects can be looked up by English or French name, or by NORAD or COSPAR id for any active Earth satellite. Beyond positions it covers orbital elements, satellite passes over a place, the night sky from a location, and calendar events such as eclipses, oppositions and full Moons. The site computes positions in the browser from CelesTrak and NASA/JPL Horizons data.

It is for education only and not for navigation, collision avoidance or conjunction assessment. Run it locally over stdio with Node 20 or later, or use the hosted endpoint, which allows 60 units a minute per address and caps distance series, pass searches and event searches.

Install

Run in a terminal

claude mcp add --transport http perigee https://perigee-mcp.perigeeinfo.workers.dev/mcp

Add to Settings → Connectors → Add custom connector

https://perigee-mcp.perigeeinfo.workers.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "perigee": {
      "url": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "perigee": {
      "serverUrl": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Configuration

  • PERIGEE_SITEBase URL of the Perigee site to query (default: https://perigee.info/)
  • PERIGEE_MCP_CACHEDirectory for the on-disk cache (default: OS user cache directory)

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

perigee_find
Finds ids of objects matching a name in English or French, including satellites by NORAD or COSPAR id.
perigee_object
Returns facts such as agency, country, launch, status, mission goals, sources and image credit.
perigee_state
Returns position, velocity, distance, altitude, speed, light time and sunlight at a date.
perigee_orbit
Returns perigee and apogee altitudes, period, inclination, eccentricity and orbit regime.
perigee_passes
Returns rise, highest point and set times of an Earth satellite over a place.
perigee_sky
Returns the sky from a place at a date, including the Sun, Moon phase, planets and bright stars.
perigee_events
Returns Moon phases, eclipses, equinoxes, solstices, oppositions, conjunctions and mission milestones.
perigee_tonight
Returns what to see tonight from a place.

What it does

Object lookup
Find planets, moons, missions, satellites, stars, comets and asteroids by name or id.
State and distance
Position, velocity, altitude, speed, light time and sunlight at a chosen date.
Orbit summary
Perigee, apogee, period, inclination, eccentricity and orbit regime for satellites.
Satellite passes
Rise, peak and set times over a place with naked-eye visibility.
Sky and events
Moon phases, eclipses, solstices, oppositions and what to see tonight.
Provenance for each figure
Answers cite how a number was obtained, its data source, freshness and accuracy.

Good for

  • Answer a student's question about planetary distance on a date
  • Find when the ISS passes overhead tonight
  • Look up a mission's agency, launch date and goals
  • Plan stargazing with Moon phase and planet positions
  • Embed a live 3D view in a lesson

Pricing

Open source

Open-source; hosted endpoint is free with a rate budget

Prices change. Check perigee.info before you buy.

Perigee FAQ

Can I use it for navigation?

No. The README says it is for educational use only, not for navigation, collision avoidance or conjunction assessment.

Is there a hosted version?

Yes, at https://perigee-mcp.perigeeinfo.workers.dev/mcp over streamable HTTP with no account. It allows 60 units a minute per address, and each tool call costs 1 to 4.

Does the hosted endpoint log requests?

It keeps a short usage log of tool, object asked about and outcome, never your address or place coordinates.

What does it need locally?

Node.js 20 or later, run with npx -y perigee-mcp.

Is Perigee free?

Yes. Perigee is open source, so you can use and self-host it for free.

How do I add Perigee to Claude Code?

Run this command in your terminal: claude mcp add --transport http perigee https://perigee-mcp.perigeeinfo.workers.dev/mcp

What are the best alternatives to Perigee?

The closest alternatives to Perigee are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

Alternatives to Perigee

  1. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  2. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  3. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  4. Read-only local index of medical-device standards with official links, no standard text

    Runs locally
    • 4 tools
    • Free
    • Legal and government
  5. Splyt

    MCP server

    Let Claude or ChatGPT read your Splyt workouts, records, plan, habits and sleep

    • Remote
    • Free
    • Health and science