API & MCP

Everything a person can do on Skyfold Meteor Shower Calendar, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://skyfoldmeteorshowers.usefulweb.app/api/v1/calculate – run Skyfold Meteor Shower Calendar
GET https://skyfoldmeteorshowers.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Skyfold Meteor Shower Calendar

Lists the meteor showers of a year with the moment of maximum, the night to watch, how high the radiant climbs, how much the Moon spoils the view and the expected number of meteors per hour at the best time for your place and sky, plus an .ics calendar of the best windows.

Inputs of Skyfold Meteor Shower Calendar
Field	Type	Default	Description
`location`	text	"52.0907, 5.1214"	Location (latitude, longitude). Decimal degrees such as 52.09, 5.12 (north and east positive), or DMS, UTM, MGRS, Maidenhead or a plus code.
`elevation`	number	0	Elevation above sea level
`timeZone`	text	"Europe/Amsterdam"	Time zone. IANA name such as Europe/Berlin or America/New_York, or a fixed offset such as UTC+2.
`year`	integer	2026	Year
`sky`	select (dark, rural, suburban, city)	"rural"	Your sky. Light pollution sets how many faint meteors you can see; the Moon is added on top.
`showers`	select (major, all)	"major"	Showers
`detail`	select (, QUA, ACE, LYR, PPU, ETA, ELY, JBO, JPE, GDR, SDA, CAP, PER, KCG, AUR, SPE, DRA, STA, ORI, NTA, LEO, PUP, HYD, GEM, URS, COM)	—	Hour-by-hour table for

Example request

Utrecht, 2026, rural sky

curl -X POST https://skyfoldmeteorshowers.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"location":"52.0907, 5.1214","timeZone":"Europe/Amsterdam","year":2026,"sky":"rural","showers":"major","detail":"PER"}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://skyfoldmeteorshowers.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: skyfold_meteor_showers
Local stdio connector: node src/mcp-stdio.ts --tool=skyfold-meteor-showers

{
  "mcpServers": {
    "skyfold-meteor-showers": { "type": "http", "url": "https://skyfoldmeteorshowers.usefulweb.app/mcp" }
  }
}