N2YO

live Data

N2YO MCP — wraps the N2YO Satellite Tracking REST API (n2yo.com)

3 tools
0ms auth
free tier 50 calls/day

Tools

get_positions

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

No parameters required.

Try it
get_visual_passes

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,

No parameters required.

Try it
whats_above

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

No parameters required.

Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash
curl -X POST https://gateway.pipeworx.io/n2yo/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash
curl -X POST https://gateway.pipeworx.io/n2yo/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_positions","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("get_positions", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("n2yo mcp — wraps the n2yo satellite tracking rest api (n2yo");