usno_solar_eclipses

Pack: usno-astronomy · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/usno_solar_eclipses for the schema, then POST the same URL with its arguments for the data.

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

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 — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

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

See Getting Started for client-specific install steps.