USNO Astronomy

liveSpace

When the next solar eclipse is, what it looks like from a place, every full and new moon, and the equinoxes and solstices — from the US Naval Observatory ephemeris.

4tools
0msauth
free tier50 calls/day

Tools

usno_solar_eclipses

When is the next solar eclipse — the list of solar eclipses in a year from the US Naval Observatory, each with its date and type (total, annular, partial, hybrid). With no arguments it returns the NEX

No parameters required.

▶Try it
usno_eclipse_circumstances

Local circumstances of a solar eclipse at a given latitude/longitude on a given date — whether the Sun is totally, annularly or partially eclipsed there, the magnitude and obscuration (percentage of t

No parameters required.

▶Try it
usno_moon_phases

Moon phases from the US Naval Observatory: the UT date and time of every New Moon, First Quarter, Full Moon and Last Quarter in a year, or the next few phases from a given date. Answers "when is the n

No parameters required.

▶Try it
usno_seasons

The seasons for a year from the US Naval Observatory: the UT date and time of the March and September equinoxes, the June and December solstices, and Earth's perihelion and aphelion. Answers "when is

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/usno-astronomy/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/usno-astronomy/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"usno_solar_eclipses","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("usno_solar_eclipses", {});
ask_pipeworx
// Or ask in plain English:
const answer = await px.ask("when the next solar eclipse is, what it looks like from a place, every full and new moon, and the equinoxes and solstices — from the us naval observatory ephemeris");