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
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":{}}}'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.