Star Ninja

io.github.2pm-ninjaPublished by GitHub account 2pm-ninjav1.5.0Updated Oct 24, 2026

Star Ninja reports sky darkness, cloud cover and moonless hours for a night-sky spot you name.

VerifiedStreamable HTTPWeb executableLocation & Lifestyle

Overview

AI-generated overview

Star Ninja is a remote MCP server that lets an assistant check stargazing conditions — darkness, cloud cover and moonless hours — for a named night-sky spot.

What you can do
Inspect a stargazing spot over the coming nights: darkness band from light-pollution data, straight-line distance and rough drive time from a start point, and a map link. For each night, get the cloud forecast and when full darkness starts and ends, including nights with no moonless window.
When to use it
Useful when planning an observing session or deciding whether a particular location is worth the drive on a given night. It suits astronomy hobbyists and anyone comparing spots by darkness and forecast.
Requirements
A remote streamable HTTP endpoint; no package, environment variables or headers are declared. No authentication is declared. Network access to the endpoint is needed.
Before you install
The tool returns a map link and location details for the spot and start point you name, so those locations are sent to the remote service. Forecasts and drive times are estimates; verify conditions before travelling.

Installation

In SourceWeft

  1. Open Star Ninja in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.2pm-ninja%2Fstar-ninja/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "star-ninja": {
      "type": "http",
      "url": "https://stars.2pm.ninja/mcp"
    }
  }
}

Tools

1

inspect_observing_spot

Check a stargazing spot

Checks stargazing conditions at one spot over the coming nights. Returns the spot's darkness band from light-pollution data, its straight-line distance from a start point with a rough drive time, and a map link. For each night: the cloud forecast, when full darkness starts and ends (some nights have none), the moonless hours, and how much of the Moon is lit. Use it when someone asks where or when they can see stars, to check a place they name or compare several. Both the start and the spot must be given as coordinates. It does not find, rank or recommend spots, or check access or safety.

ParametersnightDatespotLatituderequiredspotLongituderequiredstartLatituderequiredstartLongituderequired

Version history

3
  1. v1.5.0LatestOct 12, 2026
  2. v1.1.0Oct 3, 2026
  3. v1.0.0Sep 29, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.