Integrations & the Cosmik API
Pipe live aurora odds, ISS passes and launch times into your smart home, your Discord server or your own code — all from the free Cosmik JSON API.
Ready-made integrations
- Home AssistantAdd a live aurora-forecast sensor and a next-ISS-pass sensor for your city with copy-paste RESTful-sensor YAML — flash your lights when the Station flies over.
- Discord botInvite the Go Cosmik bot for /aurora, /iss and /nextlaunch slash commands — live space data straight in your server, no gateway, no setup.
What you can wire up today
Every integration on this page reads the same free, CORS-open JSON endpoints, so anything the Home Assistant sensor or the Discord bot can do, your own script can do too:
- Tonight's aurora odds for one city —
/api/widget/aurora/tromsoreturns the live NOAA SWPC Kp compared against that city's own geomagnetic-latitude threshold, so you get a yes/no for a place rather than a planet-wide index. Poll it every 30 minutes; that's how often the upstream forecast moves. - The next visible ISS passes for one city —
/api/widget/iss/paris, SGP4-propagated, 550+ cities by slug. Each pass carries its start time, duration and maximum elevation, which is what decides whether a pass is worth walking outside for (40° and up is the rule of thumb). - The live launch schedule —
/api/launches, soonest first, with the NET timestamp and status so your automation can react to a scrub rather than to a plan. - The whole tracked catalogue —
/api/catalogserves current CelesTrak TLEs grouped by constellation, if you'd rather propagate orbits yourself. - An MCP server for AI agents —
/api/mcpexposesget_next_launches,get_iss_passesandget_launch_newsover streamable HTTP; point Claude, ChatGPT or any agent framework at it and it can answer live sky questions without you writing a client.
Three things people actually build
Flash the lights when the Station passes. The Home Assistant ISS sensor plus a time-based automation is the single most common build — and the reason the sensor returns elevation, so you can ignore the 12° passes nobody can see. Aurora watch for a group chat. The Discord bot's /aurora command answers for whichever city you name, which beats everyone in the server independently refreshing a Kp map. A countdown on a screen. Museums, planetariums and news sites use the launch endpoint (or a ready-made embeddable widget) to keep an exhibit or an article live without running a TLE pipeline.
Build your own
See the API & data documentation for the full endpoint list, response shapes and the commercial terms, grab a copy-paste embeddable widget or the single-satellite widget, or connect an AI agent to the live Cosmik MCP server. The free tier asks only for a “data: Cosmik” credit and a link. Questions: hello@gocosmik.com.



