Star Ninja's MCP server
Star Ninja reports sky darkness, cloud cover and moonless hours for a night-sky spot you name. It does not rank spots, plan routes, or check access or safety.
There's a hosted MCP server, so an assistant can fetch those readings directly. No account, no API key, no signup.
How to connect
Paste this address into any MCP client that takes a server URL:
https://stars.2pm.ninja/mcp
The transport is Streamable HTTP. If your client adds servers from the
official MCP registry instead, look for io.github.2pm-ninja/star-ninja.
What you'd use it for
Ask an assistant how dark a spot is, what the cloud forecast looks like, and when the moon is out of the way. It can check several spots you name in one conversation.
The one tool
There's one tool, inspect_observing_spot. You give it a start point and
a spot, both as coordinates. You can also ask for one particular night.
It answers with:
- Darkness — the spot's darkness band.
- Distance — a straight line from your start, with an approximate drive figure.
- Cloud — the cloud forecast for each of the next few nights.
- Moon — the moonless hours each night, when they fall, and how lit the moon is.
- A link — the same start and spot on the map, to open in a browser.
What the readings don't promise
The darkness band is an annual satellite average, not a live reading of the sky. The distance is a straight line, and the drive figure assumes a flat average speed — it is not a route. Forecasts change.
Star Ninja doesn't rank spots or pick one for you. It doesn't check whether a spot is reachable, open to the public, or safe. It doesn't guarantee conditions. That judgement stays with the person going.
How often you can call it
Each caller has a rate limit. Go over it and calls are refused until the limit clears.
Next steps
Open the map to do the same thing by hand. For what the product is and isn't, see what Star Ninja is.