get_positions
Pack: n2yo · Endpoint: https://gateway.pipeworx.io/n2yo/mcp
Track where a satellite is right now (or in the next few seconds): get its live latitude, longitude, altitude, and look-angles (azimuth/elevation) from an observer on Earth. Use this to answer “where is the ISS right now?” (NORAD id 25544) or to locate any satellite by NORAD id. Example: get_positions({ 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, 20580 for Hubble. |
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). |
seconds | number | no | Number of future seconds of positions to predict (default 2, max 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_positions","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.