`usno_solar_eclipses`

Pack: usno-astronomy · Endpoint: https://gateway.pipeworx.io/usno-astronomy/mcp

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 NEXT solar eclipse after today plus the rest of the current and following year, so “when is the next solar eclipse”, “solar eclipses in 2027”, “is there a total eclipse this year” are all one call. For where an eclipse is visible and what time it starts at a given place, follow with usno_eclipse_circumstances. Lunar eclipses are not published by this API.

Parameters

Name	Type	Required	Description
`year`	number	no	Four-digit year, 1800-2050. Omit for the next eclipse after today (current year and the next).

Example call

Arguments

{}

curl

curl -X POST https://gateway.pipeworx.io/usno-astronomy/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"usno_solar_eclipses","arguments":{}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('usno_solar_eclipses', {});

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "usno-astronomy": {
      "url": "https://gateway.pipeworx.io/usno-astronomy/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

usno_solar_eclipses