`get_visual_passes`

Pack: n2yo · Endpoint: https://gateway.pipeworx.io/n2yo/mcp

Find when a satellite will be visible to the naked eye overhead from an observer location (visual passes = bright, sunlit passes against a dark sky). Returns start/max/end times, elevation, azimuths, brightness magnitude, and duration. Use this for “when can I see the ISS pass over?” Example: get_visual_passes({ norad_id: 25544, lat: 40.71, lon: -74.0 }).

Parameters

Name	Type	Required	Description
`norad_id`	number	yes	NORAD catalog id of the satellite, e.g. 25544 for the ISS.
`lat`	number	yes	Observer latitude in decimal degrees.
`lon`	number	yes	Observer longitude in decimal degrees.
`altitude`	number	no	Observer altitude in meters above sea level (default 0).
`days`	number	no	Number of days ahead to search for passes (default 5, max 10).
`min_visibility`	number	no	Minimum visible duration in seconds for a pass to be returned (default 300).
`_apiKey`	string	no	Optional — your own N2YO API key for higher limits; omit to use the shared Pipeworx key.

Example call

Arguments

{
  "norad_id": 25544,
  "lat": 40.71,
  "lon": -74
}

curl

curl -X POST https://gateway.pipeworx.io/n2yo/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_visual_passes","arguments":{"norad_id":25544,"lat":40.71,"lon":-74}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_visual_passes', {
  "norad_id": 25544,
  "lat": 40.71,
  "lon": -74
});

More examples

{
  "norad_id": 25544,
  "lat": 40.71,
  "lon": -74,
  "days": 10,
  "min_visibility": 600
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "n2yo": {
      "url": "https://gateway.pipeworx.io/n2yo/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_visual_passes