whats_above
Pack: n2yo · Endpoint: https://gateway.pipeworx.io/n2yo/mcp
List what satellites are currently above a location on Earth, within a given radius of the observer’s zenith. Use this to answer “what satellites are overhead right now?” Optionally filter by category (e.g. 52 = Starlink, 18 = amateur radio, 1 = brightest). Example: whats_above({ lat: 40.71, lon: -74.0 }).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
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). |
radius | number | no | Search radius in degrees from the observer zenith (default 70, max 90). |
category | number | no | N2YO category filter: 0 = all (default), 18 = amateur radio, 52 = Starlink, 1 = brightest. |
_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":"whats_above","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.