home / mcp / satellite tracking mcp server

Satellite Tracking MCP Server

Provides access to satellite data from the N2YO API including position, TLE data, passes, and satellites above a location.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cyreslab-ai-satellitetracking-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/satellite-tracking-server/build/index.js"
      ],
      "env": {
        "N2YO_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can access real-time satellite data using this MCP Server, which interfaces with the N2YO API to provide position, TLE data, pass predictions, and satellite listings. It enables you to query satellite information by NORAD ID, search by name or category, and see which satellites are above a location or visible during a given window.

How to use

Use an MCP client to send commands to the Satellite Tracking MCP Server. You can retrieve the real-time position of a satellite by its NORAD ID, fetch TLE data, and predict both visual and radio passes for a specific observer location. You can also discover satellites currently above a location or search for satellites by name or category. Access a satellite’s information through its resource URI or browse satellites by category or by location.

How to install

Prerequisites: Node.js 18 or higher and a N2YO API key.

bash
mkdir satellite-tracking-server
cd satellite-tracking-server

# Install dependencies
npm install

# Build the server
npm run build

# Start the server (if you have a start script, otherwise start using the runtime command below)
# npm run start

Configuration and runtime details

The server requires a N2YO API key. Provide it through the environment variable N2YO_API_KEY when you run the server.

Additional notes

If you plan to run the server locally and connect to it from an MCP client, you can start it using a local Node.js runtime with the built index file.

Access and tools overview

The server exposes tools to fetch satellite position, TLE data, and pass predictions, as well as resources to access satellite information and category listings.

Available tools

get_satellite_position

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

get_satellite_tle

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

predict_visual_passes

Predict visible passes of a satellite over a given 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 specified observer location.

search_satellites

Search for satellites by name or category.