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.
- obsidian-mcp-server Read, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP. ★ 690
- mcp-ts-core Agent-native TypeScript framework for MCP servers. ★ 152
- git-mcp-server Comprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more. ★ 240
- clinicaltrialsgov-mcp-server Search ClinicalTrials.gov - find studies, retrieve results, match patients to eligible trials. ★ 96
- openalex-mcp-server Access the OpenAlex academic research catalog - 270M+ publications. ★ 14
- mcp-ts-template TypeScript template for building MCP servers with declarative tooling, observability, and auth. ★ 152
05 · Facts
- repository
- github.com/cyanheads/astronomy-mcp-server
- 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
Alternatives to Astronomy MCP Server
Maintained web framework servers if Astronomy MCP Server isn't the fit.
- Reactive Resume Free open-source resume builder with remote MCP tools for resumes and job applications. ★ 43,598 · 2026-09-30
- Tolgee Your app's translations in Tolgee: search keys, create translations, trigger machine translation ★ 4,117 · 2026-09-30
- Medplum MCP Server Securely access and manage FHIR healthcare data stored in Medplum. ★ 2,710 · 2026-09-30
- Semiotic Verified React chart generation: select, validate, repair, render, and inspect charts through MCP. ★ 2,708 · 2026-09-29
- Webcomponents React MCP Server MCP server for UI5 Web Components for React - Developer documentation and API assistance ★ 540 · 2026-09-29
- Geo Lens Read-only access to a self-hosted GeoLens spatial catalog: datasets, features, maps, sandboxed SQL. ★ 262 · 2026-09-29
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