Astronomy MCP Server

@cyanheads/astronomy-mcp-server What's in the sky, computed offline - planet and moon positions, rise/set, phases, eclipses, and seasons for any place and time via MCP. STDIO or Streamable HTTP. Its README documents 7 tools, including astronomy_get_sky_position, astronomy_get_rise_set, astronomy_get_moon_phase.

People who work with astronomy, cyanheads and eclipse and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-24 · ★ 3 · #16 OF 66 MAINTAINED WEB FRAMEWORK · VERIFIED 2026-09-30

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Astronomy MCP Server

before you install - you'll need

Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting.

Claude Code

claude mcp add cyanheads-astronomy-mcp-server --transport http https://astronomy.caseyjhand.com/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cyanheads-astronomy-mcp-server": {
      "url": "https://astronomy.caseyjhand.com/mcp"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://astronomy.caseyjhand.com/mcp

transport: streamable-http

endpoint alive - responded to MCP initialize · probed 2026-09-30

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to astronomy.caseyjhand.com

endpoint auth accepted our unauthenticated MCP initialize - no credentials needed to connect

license Apache-2.0 - declared in the repository

npm package @cyanheads/astronomy-mcp-server - published under the repo owner's npm scope (@cyanheads)

registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner

03 · What Astronomy MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 7 documented tools, including astronomy_get_sky_position, astronomy_get_rise_set, astronomy_get_moon_phase, astronomy_find_events, astronomy_list_visible.

The 7 tools it gives your agent

Extracted from the project's README - what astronomy-mcp-server lets an agent do.

astronomy_get_sky_position
- Apparent position of one body or named star for an observer and instant - equatorial (RA/Dec), horizontal (alt/az), ecliptic, plus distance, magnitude, angular
astronomy_get_rise_set
- Rise, set, and culmination times for a body at a location, with maximum altitude at transit. For the Sun, also the three twilight pairs (civil/nautical/astronom
astronomy_get_moon_phase
- Moon phase for an instant: illuminated fraction, phase name, synodic age, phase longitude, and the next four quarter phases with timestamps.
astronomy_find_events
- Forward search for the next occurrences of one sky-event class: eclipses, equinoxes, solstices, moon quarters, oppositions, conjunctions, greatest elongations,
astronomy_list_visible
- The one-call "what's up right now" answer: every naked-eye body (and optional bright stars) above the horizon, ranked, annotated, and gated by the Sun's altitud
astronomy_get_ephemeris
- (gated extension) Time-series ephemeris for a small body (asteroid/comet) or spacecraft via JPL Horizons - covers what the in-process major-body set cannot. Off
astronomy_get_satellite_passes
- (gated extension) Visible passes of a satellite (by NORAD catalog number, or by a name resolved against the catalog) over an observer, from a CelesTrak GP eleme

Latest releases

v0.4.0 · 2026-09-24

Moon phase longitude, star lookup, Sun elongation · astronomy_get_moon_phase's phase_angle_degrees is renamed phase_longitude_degrees (values unchanged) (#35) · astronomy_get_sky_position / astronomy_list_visible gain…

v0.3.1 · 2026-09-24

Horizons target names and span errors, satellite aliases · astronomy_get_ephemeris: an offset-bearing start/stop was forwarded to Horizons verbatim and its "Cannot interpret date" refusal was misread as body_not_found…

v0.3.0 · 2026-09-24

Global solar eclipses, per-contact altitudes, 2100 search stop · Any-contact eclipse visibility - local_visible and the new contact_altitudes_degrees now check every contact instead of only the peak, so a…

04 · Who maintains Astronomy MCP Server

astronomy-mcp-server is maintained by cyanheads. We track 137 MCP servers from cyanheads - 131 actively maintained, 1,856 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

  1. obsidian-mcp-server Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP. ★ 690
  2. mcp-ts-core Agent-native TypeScript framework for MCP servers. ★ 152
  3. git-mcp-server Comprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more. ★ 240
  4. clinicaltrialsgov-mcp-server Search ClinicalTrials.gov - find studies, retrieve results, match patients to eligible trials. ★ 96
  5. openalex-mcp-server Access the OpenAlex academic research catalog - 270M+ publications. ★ 14
  6. mcp-ts-template TypeScript template for building MCP servers with declarative tooling, observability, and auth. ★ 152

05 · Facts

category
web framework - ranked #16 of 66 actively-maintained web framework servers as of 2026-09-30.
release cadence
10+ releases in the last 90 days (latest 2026-09-24)
registry
io.github.cyanheads/astronomy-mcp-server (active, first published 2026-06-28 · 16 versions)
packages
npm:@cyanheads/astronomy-mcp-server · npm:@cyanheads/astronomy-mcp-server

06 · Astronomy MCP Server FAQ

Is Astronomy MCP Server still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-24 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can Astronomy MCP Server do?

An agent gets 7 documented tools, including astronomy_get_sky_position, astronomy_get_rise_set, astronomy_get_moon_phase, astronomy_find_events, astronomy_list_visible.

How do I install Astronomy MCP Server?

Run `npx -y @cyanheads/astronomy-mcp-server`. The README documents 2 environment variables (MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL) to set first. Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting. You can also paste the ready-made client config above.

Does Astronomy MCP Server require authentication?

No - the endpoint accepted our unauthenticated MCP initialize when probed on 2026-09-30; you can connect without credentials.

07 · Alternatives to Astronomy MCP Server

More web framework MCP servers · Aifeed · Gitwand · Source Library · Qrcodly · Aspicio

More TypeScript MCP servers · Aviation Weather MCP Server · Biorxiv MCP Server · Brapi MCP Server · Calculator MCP Server · Cdc Health MCP Server · see all