Astronomy Core

Connect

Connect your agent to the sky

Use OAuth in Claude, ChatGPT, or Perplexity for one-click access, or configure Cursor and other clients manually. 40 astronomy tools at our hosted MCP server (MCP v0.9.5, API v3.10.1), no local install.

https://mcp.astronomycore.com

One-click connect

Connect in one click

Add Astronomy Core in Claude, ChatGPT, or Perplexity — sign in once, approve access, and start calling sky tools. No API key to copy. OAuth issues the same ac_live_… credential used for REST and MCP.

Claude

  1. Open Claude Desktop → Settings → Connectors → Add custom connector.
  2. Name: Astronomy Core · URL: https://mcp.astronomycore.com
  3. Authentication: OAuth · Client id: claude
  4. Click Add, then sign in at astronomycore.com when prompted.

ChatGPT

  1. Open ChatGPT → Settings → Apps & Connectors (enable Developer mode if asked).
  2. Create a custom MCP connector · URL: https://mcp.astronomycore.com
  3. Choose OAuth when offered · Client id: chatgpt
  4. Complete sign-in and approve access at astronomycore.com.

Perplexity

  1. Open Perplexity (Comet desktop app) → Connectors → Add custom connector.
  2. Name: AstronomyCore · URL: https://mcp.astronomycore.com
  3. Authentication: OAuth · Client id: perplexity
  4. Check “I understand…”, click Add, then approve access when prompted.

Every OAuth connection is tracked individually and revocable in one click from your dashboard (Connected AI Assistants).

Advanced: manual API key setup

For Cursor, Claude Desktop, VS Code, and custom integrations — paste an ac_live_… key from your dashboard.

C

Add to ~/.cursor/mcp.json 

  
 
 
 🔑 
 Auth: use the same ac_live_… key from your
dashboard as a Bearer token. The same credit pool applies whether you call
        REST or MCP. tools/list shows only tools for modules your key can use
        (~20 free, ~28 pro). get_capabilities with your key returns
caller.modules including per-module moduleVersion.

 
 
 
Modules · 10 packages
 
Each module has an independent wire-contract semver — not the global MCP server version.
 
 
 
 
  
 Module moduleVersion packageVersion constants Free MCP tools 
   
  ephemeris 
Ephemeris
 		 2.1.0 0.1.0  —  ✓ 17 
  sky 
Sky
 		 1.0.0 0.1.0  —  ✓ 3 
  westernAstrology 
Western Astrology
 		 2.1.0 0.1.0  —  — 9 
  astrocartography 
Astrocartography
 		 1.2.0 0.1.0  —  — 2 
  numerology 
Numerology
 		 1.1.0 0.1.0  —  — 1 
  earthGrid 
Earth Grid
 		 1.0.0 0.1.0  1.0.1  — 2 
  locations 
Locations
 		 1.0.0 0.1.0  —  — 2 
  galacticTime 
Galactic Time
 		 1.0.0 0.1.0  —  — 1 
  chineseAstrology 
Chinese Astrology
 		 1.2.0 0.1.0  —  — 1 
  vedicAstrology 
Vedic Astrology
 		 1.0.0 0.1.0  —  — 1 
  
 
 
 
 
 
Tools · 40
 
Each tool maps to a REST endpoint and returns the same JSON envelope.
 
 
  ⌕ 
 
 
 
 
        
 Tool Auth REST Description 
   
 get_capabilities Optional API key GET /v1/capabilities Lite platform discovery: modules, tool names, bodies. Bearer key → caller.modules. Use get_tool_details for schemas. 
 get_tool_details No auth MCP only Batch tool schemas, REST equivalents, and examples (1–10 tool names). 
 get_sky_snapshot API key GET /v1/snapshots Full solar system snapshot for observer lat/lon and optional UTC datetime. 
 get_body API key GET /v1/bodies/{body} Single celestial body (phase, rise/set, etc.) for observer location. 
 get_topocentric_ephemeris API key GET /v1/ephemeris/topocentric Scientific topocentric apparent places (RA/Dec, alt/az, ecliptic). No astrology. 
 get_galactic_day API key + tier GET /v1/galactic/day Dreamspell / 13 Moon galactic day for UTC date: kin, thirteenMoon, oracle, signature. 
 get_astrocartography_lines API key + tier GET /v1/astrocartography/lines Astrocartography MC/IC/ASC/DSC geographic lines for UTC datetime. Optional includeParans. 
 get_location_astro_grid_overlay API key + tier GET /v1/astrocartography/overlay Combined Hartmann/Curry local grid, nearby UVG nodes, and regional astrocartography line summary. Requires earthGrid + astrocartography. 
 get_numerology_reading API key + tier GET /v1/numerology/reading Birth name numerology: life path, expression, soul urge, personality, birthday. Systems: pythagorean, chaldean, hebrew_gematria. 
 get_chinese_zodiac API key + tier GET /v1/chinese-astrology/chinese-zodiac Chinese zodiac year animal from birthDate. Default yearBoundary=lichun (BaZi). Data only — no interpretations. 
 get_earth_grid_local API key + tier GET /v1/earth-grid/local Hartmann + Curry local grids at observer lat/lon (computed models). 
 get_earth_grid_nodes API key + tier GET /v1/earth-grid/nodes 62 UVG Becker-Hagens nodes (compact or full detail). 
 get_astrological_chart API key + tier GET /v1/western-astrology/chart Natal/birth chart: tropical or sidereal, houses, aspects, lunar nodes. Optional includeFixedStars + fixedStarOrb; includeArabicParts for Part of Fortune/Spirit (tropical). 
 get_transits API key + tier GET /v1/western-astrology/transits Natal chart vs transit datetime: cross-aspects and houses activated. 
 get_synastry_chart API key + tier GET /v1/western-astrology/synastry Two natal charts: interAspects and houseOverlays (aInB / bInA). 
 get_composite_chart API key + tier GET /v1/western-astrology/composite Composite midpoint chart from two natal charts plus internal aspects. 
 get_solar_return API key + tier GET /v1/western-astrology/returns/solar Solar return chart for target year; optional relocation. 
 get_lunar_return API key + tier GET /v1/western-astrology/returns/lunar Next lunar return after searchFrom. 
 get_secondary_progressions API key + tier GET /v1/western-astrology/progressions/secondary Secondary progressions (day-for-a-year) at targetDate. 
 get_solar_arc_directions API key + tier GET /v1/western-astrology/progressions/solar-arc Solar arc directions from natal chart at targetDate age. 
 get_void_of_course_moon API key + tier GET /v1/western-astrology/void-of-course-moon Void of course Moon at query datetime. 
 get_vedic_chart API key + tier GET /v1/vedic-astrology/chart Vedic sidereal chart with nakshatra/pada and optional Vimshottari dasha. 
 geocode_location Locations quota GET /v1/locations/geocode Place name → lat/lon/elevation with rank, label, formattedAddress. 
 reverse_geocode_location Locations quota GET /v1/locations/reverse Latitude/longitude → formatted address and place components. 
 get_seasons API key + tier GET /v1/events/seasons Equinoxes and solstices for a calendar year (UTC). 
 search_moon_phases API key + tier GET /v1/events/moon-phases Upcoming moon quarter phases from a start datetime. 
 search_eclipses API key + tier GET /v1/events/eclipses/* Next eclipse after start (lunar, solar global, or solar local). 
 get_jupiter_moons API key GET /v1/bodies/jupiter/moons Galilean moon state vectors relative to Jupiter. 
 get_observer_metadata API key GET /v1/observer/metadata LST, atmosphere, gravity, sun/moon hour angles for observer site. 
 search_conjunction API key + tier GET /v1/events/conjunctions Next conjunction or opposition (targetRelLon 0 or 180). 
 search_lunar_apsis API key + tier GET /v1/events/apsis/lunar Next lunar perigee or apogee. 
 search_planetary_apsis API key + tier GET /v1/events/apsis/planetary Next planetary perihelion or aphelion. 
 search_elongation API key + tier GET /v1/events/elongation Mercury/Venus maximum elongation from the Sun. 
 search_transit API key + tier GET /v1/events/transits Mercury/Venus transit across the Sun. 
 search_moon_nodes API key + tier GET /v1/events/moon-nodes Next ascending/descending lunar node crossing. 
 search_moon_phase_at_longitude API key + tier GET /v1/events/moon-phases/search Find moon phase at target ecliptic longitude. 
 search_events API key + tier batch Unified batch or selective event search (types=all or comma-separated). 
 get_constellations API key GET /v1/catalog/constellations IAU constellation catalog; optional stick lines and boundary polygons. 
 get_stars_catalog API key GET /v1/catalog/stars Hipparcos mag≤6 star catalog (J2000). 
 get_sky_stars API key GET /v1/sky/stars Observer bright stars + constellation lines for sky maps.