`usno_eclipse_circumstances`

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

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 the Sun covered), the duration, and the UT time, Sun altitude and azimuth of each contact (eclipse begins, totality begins/ends, maximum eclipse, eclipse ends, or sunrise/sunset if the eclipse is in progress then). Answers “what time does the August 12 2026 eclipse start in Madrid”, “how much of the Sun will be covered in Denver”, “will the eclipse be total where I am”. Needs coordinates: resolve a place name to lat/lon first. Find the eclipse date with usno_solar_eclipses.

Parameters

Name	Type	Required	Description
`date`	string	yes	Date of the eclipse as YYYY-MM-DD, e.g. “2026-08-12”. Must be a solar eclipse date from usno_solar_eclipses.
`lat`	number	yes	Latitude in decimal degrees, north positive, e.g. 40.42 for Madrid.
`lon`	number	yes	Longitude in decimal degrees, east positive, e.g. -3.70 for Madrid.
`height`	number	no	Observer height in metres above sea level. Default 0.

Example call

Arguments

{
  "date": "2026-08-12",
  "lat": 40.42,
  "lon": -3.7
}

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_eclipse_circumstances","arguments":{"date":"2026-08-12","lat":40.42,"lon":-3.7}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('usno_eclipse_circumstances', {
  "date": "2026-08-12",
  "lat": 40.42,
  "lon": -3.7
});

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_eclipse_circumstances