API & MCP

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

HTTP API

POST https://skyfoldauroraoutlook.usefulweb.app/api/v1/calculate – run Skyfold Aurora Outlook
GET https://skyfoldauroraoutlook.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 Aurora Outlook

Combines the NOAA SWPC Kp forecast with your geomagnetic latitude (IGRF-14 dipole), the darkness of each 3-hour period and the MET Norway cloud forecast into chance bands per period and night, and tells you which Kp you need for aurora overhead, on the horizon or on camera.

Inputs of Skyfold Aurora Outlook
Field	Type	Default	Description
`location`	text	"59.9139, 10.7522"	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/Oslo"	Time zone. IANA name such as Europe/Berlin or America/New_York, or a fixed offset such as UTC+2.
`source`	select (noaa, paste)	"noaa"	Kp forecast
`kpText`	textarea	—	Kp forecast text or JSON (when pasted). The NOAA “3-Day Forecast” text or the planetary K-index forecast JSON.
`clouds`	boolean	true	Add the cloud forecast from MET Norway. Only with the fetched forecast; the place is rounded to 0.01° for the request.

Example request

Oslo with the forecast of 8 November 2026

curl -X POST https://skyfoldauroraoutlook.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"location":"59.9139, 10.7522","timeZone":"Europe/Oslo","source":"paste","kpText":":Product: 3-Day Forecast\n:Issued: 2026 Nov 08 1230 UTC\n# Prepared by the U.S. Dept. of Commerce, NOAA, Space Weather Prediction Center\nNOAA Kp index breakdown Nov 08-Nov 10 2026\n             Nov 08       Nov 09       Nov 10\n00-03UT       5.00 (G1)    3.67         3.67\n03-06UT       3.33         4.67 (G1)    3.67\n06-09UT       3.00         3.67         2.67\n09-12UT       3.33         3.00         2.67\n12-15UT       2.67         2.67         1.67\n15-18UT       2.67         2.67         1.67\n18-21UT       3.67         2.67         1.67\n21-00UT       4.67 (G1)    3.67         2.67","clouds":false}'

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://skyfoldauroraoutlook.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: skyfold_aurora_outlook
Local stdio connector: node src/mcp-stdio.ts --tool=skyfold-aurora-outlook

{
  "mcpServers": {
    "skyfold-aurora-outlook": { "type": "http", "url": "https://skyfoldauroraoutlook.usefulweb.app/mcp" }
  }
}