# Perigee

The Perigee MCP server for Claude Code gives an agent data about objects orbiting Earth, the Moon and Mars. It can answer questions about satellite positions, planetary distances and spacecraft missions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: dlamarre-dev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dlamarre-dev/Perigee/tree/HEAD/mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/perigee

## What it does

Perigee lets an agent find space objects and retrieve facts about their position, orbit and related sky events. Ask where the ISS is, when a satellite will pass over a place, or what a mission aims to do. Object records can include sources and a verification date.

The server also reports sky visibility, lunar phases, eclipses and when an object enters or leaves a shadow. Running it over stdio requires Node.js 20 or later; alternatively, connect to the hosted endpoint at `https://perigee-mcp.perigeeinfo.workers.dev/mcp`. Its data is for educational use, not navigation, collision avoidance or conjunction assessment.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://perigee-mcp.perigeeinfo.workers.dev/mcp`
- Environment variables: `PERIGEE_SITE`, `PERIGEE_MCP_CACHE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http perigee https://perigee-mcp.perigeeinfo.workers.dev/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env PERIGEE_SITE=<PERIGEE_SITE> --env PERIGEE_MCP_CACHE=<PERIGEE_MCP_CACHE> --transport stdio mcp -- npx -y perigee-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp --url https://perigee-mcp.perigeeinfo.workers.dev/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp --env PERIGEE_SITE=<PERIGEE_SITE> --env PERIGEE_MCP_CACHE=<PERIGEE_MCP_CACHE> -- npx -y perigee-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "perigee-mcp"
            ],
            "env": {
                "PERIGEE_SITE": "<PERIGEE_SITE>",
                "PERIGEE_MCP_CACHE": "<PERIGEE_MCP_CACHE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "perigee-mcp"
            ],
            "env": {
                "PERIGEE_SITE": "<PERIGEE_SITE>",
                "PERIGEE_MCP_CACHE": "<PERIGEE_MCP_CACHE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp https://perigee-mcp.perigeeinfo.workers.dev/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e PERIGEE_SITE=<PERIGEE_SITE> -e PERIGEE_MCP_CACHE=<PERIGEE_MCP_CACHE> mcp npx -y perigee-mcp
```
Replace <…> with your own values

## When to use it
- find an object by name or identifier
- check a satellite's position on a chosen date
- get pass times for a location
- retrieve a mission's goals and sources
- see which planets are visible tonight

## Example prompts
- Where is the ISS now, and what country is below it?
- Summarize Lucy's mission goals and include the sources.
- Which planets can I see tonight from Paris?

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
