Perigee — Claude Code MCP server for space data
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.
MIT ★ 5 updated 2026-11-16
claude mcp add --transport http perigee https://perigee-mcp.perigeeinfo.workers.dev/mcpWhat Perigee 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.
What it helps with
- 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 for the agent
- 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?
How to install Perigee
1Platform CLI: remote server
claude mcp add --transport http perigee https://perigee-mcp.perigeeinfo.workers.dev/mcp2Platform CLI
claude mcp add --env PERIGEE_SITE=<PERIGEE_SITE> --env PERIGEE_MCP_CACHE=<PERIGEE_MCP_CACHE> --transport stdio mcp -- npx -y perigee-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add mcp --url https://perigee-mcp.perigeeinfo.workers.dev/mcp2Platform CLI
codex mcp add mcp --env PERIGEE_SITE=<PERIGEE_SITE> --env PERIGEE_MCP_CACHE=<PERIGEE_MCP_CACHE> -- npx -y perigee-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"url": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
}
}
}{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"perigee-mcp"
],
"env": {
"PERIGEE_SITE": "<PERIGEE_SITE>",
"PERIGEE_MCP_CACHE": "<PERIGEE_MCP_CACHE>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "http",
"url": "https://perigee-mcp.perigeeinfo.workers.dev/mcp"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http mcp https://perigee-mcp.perigeeinfo.workers.dev/mcp2Platform CLI
gemini mcp add -e PERIGEE_SITE=<PERIGEE_SITE> -e PERIGEE_MCP_CACHE=<PERIGEE_MCP_CACHE> mcp npx -y perigee-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Perigee
How do I install Perigee in Claude Code?
To connect to the hosted server, run claude mcp add --transport http perigee https://perigee-mcp.perigeeinfo.workers.dev/mcp.
What does Perigee do?
It gives an agent information about space objects, their orbits and positions, plus sky events. It can also report satellite passes and visibility from a location.
What does Perigee need to run?
The stdio setup requires Node.js 20 or later. You can instead connect to the hosted endpoint at https://perigee-mcp.perigeeinfo.workers.dev/mcp.