Satellite Tracking

This MCP Server provides access to satellite tracking data via the N2YO API, enabling you to fetch real-time positions, TLE data, and predictive pass information for satellites. It’s useful for visualization, planning observations, and building integrations that rely on up-to-date satellite data.

How to use

You connect to this MCP server from an MCP client to request satellite data. Once the server is running, you can perform a variety of actions such as obtaining a satellite’s current position, retrieving its TLE data, predicting visible or radio passes from a given location, listing satellites above a location, or searching satellites by name or category. Each action is exposed as a dedicated tool you call through your MCP client, returning structured results you can display or process in your app.

To begin, configure your MCP client to point at the server as described in the setup section, supply your N2YO API key, and then invoke the tools you need. Common workflows include plotting the real-time position of a specific satellite, checking upcoming visible passes for an observer’s location, and fetching the latest TLE data for maintenance or recalculation tasks.

How to install

Prerequisites you need before installation: Node.js 18 or higher, and a N2YO API key.

Step by step install and start flow you can follow locally.

# Prerequisites
node --version
# Ensure Node.js 18+ is installed

# 1) Clone or download the source
# (Use your preferred method, e.g., git clone <repo-url>)

# 2) Install dependencies
cd satellite-tracking-server
npm install

# 3) Build the server
npm run build

# 4) Start the server (example command shown in MCP config snippets)
node /path/to/satellite-tracking-server/build/index.js

Configuration, security, and usage notes

The server requires your N2YO API key to function. Supply this key through environment variables when starting or integrating with an MCP client that launches the server.

Configuration snippets shown for integrating with an MCP client demonstrate using a local (stdio) runtime that launches the built server and passes the API key via environment variables. You can adapt these snippets to your environment, replacing the placeholder path with your actual build output path.

Environment variable example shown depicts the required API key setup:

"env": {
  "N2YO_API_KEY": "your-api-key-here"
}

Tools and capabilities

The server exposes a set of tools you can call through your MCP client to access satellite data.

Available tools

get_satellite_position

Fetch the real-time position of a satellite by NORAD ID using the N2YO API.

get_satellite_tle

Retrieve the Current Two-Line Element (TLE) data for a satellite by NORAD ID.

predict_visual_passes

Predict visible passes of a satellite over a specified location and time window.

predict_radio_passes

Predict radio frequency passes of a satellite over a location.

get_satellites_above

List satellites currently above a given latitude/longitude within a radius.

search_satellites

Search satellites by name or category to discover what is available.