Astrology Engine

Multi-tradition astrology (Western, Vedic, BaZi).

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Get Astrology Chart: Calculate an astrological chart (Western, Vedic, BaZi) based on birth data. All inputs feed directly into the deterministic ephemeris engine.
  • Get Astrology Reference: Retrieve authentic interpretation guidelines for a specific astrological system. Use this to ground your readings instead of hallucinating meanings. Valid systems: 'western',
  • Save Profile: Save a user's birth profile to local memory for future sessions.

What data it sees

Do you need an account

No: the server works without sign-in

Multi-tradition astrology (Western, Vedic, BaZi). 19 modes, 18 MCP tools. Deterministic ephemeris engine — computes mathematically real charts from birth data with zero dependencies.

How to connect

How to connect Astrology Engine to Claude

The server address to paste into Claude settings:

https://astrology--aryaminus.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Astrology Engine to ChatGPT

The server address to paste into ChatGPT settings:

https://astrology--aryaminus.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Astrology Engine to Cursor

The server address to paste into Cursor settings:

https://astrology--aryaminus.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (18)

Raw names from tools/list. Only developers need these.

get_astrology_chart Calculate an astrological chart (Western, Vedic, BaZi) based on birth data. All inputs feed directly into the deterministic ephemeris engine.
get_astrology_reference Retrieve authentic interpretation guidelines for a specific astrological system. Use this to ground your readings instead of hallucinating meanings. Valid systems: 'western', 'vedic', 'bazi', 'health', 'synastry', 'consultation'.
save_profile Save a user's birth profile to local memory for future sessions.
get_profile Retrieve a saved birth profile.
geocode_city Retrieve the latitude and longitude for a given city name. Use this to look up coordinates if the user only provides a city name.
get_solar_return Calculate a solar return chart — the moment the Sun returns to its natal position. Essential for annual birthday forecasts and year-ahead readings.
get_lunar_return Calculate a lunar return chart — the moment the Moon returns to its natal position. Used for monthly forecasts and emotional cycle tracking.
get_compatibility Calculate detailed compatibility scoring (0-100) between two people. Returns overall score plus romantic, emotional, intellectual, physical, and spiritual subscores.
get_navamsa Calculate the Vedic Navamsa (D9) divisional chart. Reveals soul-level strengths, relationship potential, and vargottama status.
get_panchang Calculate complete Vedic Panchang elements: Tithi, Nakshatra, Yoga, and Karana. Essential for muhurta (auspicious timing) and daily Vedic guidance.
get_moon_phase Get the current moon phase (or for a specific date): name, illumination %, age, and the next 4 upcoming lunar phase events (new moons, full moons, quarters).
get_numerology Calculate core numerology: Life Path number, Personal Year, and (if name provided) Expression and Soul Urge numbers. Master numbers 11/22/33 are preserved (not reduced).
get_composite_chart Calculate a midpoint composite chart — the relationship as a third entity. Each planet is the midpoint of its positions in both charts.
get_progressions Calculate secondary progressions (1 day = 1 year of life). Reveals evolving identity, emotional needs, and life direction.
get_planetary_return Calculate a planetary return chart for any planet (Mercury, Venus, Mars, Jupiter, Saturn, etc.). The moment the planet returns to its natal position, beginning a new cycle.
get_varga Calculate a Vedic divisional chart (Varga). D2=Hora (wealth), D3=Drekkana (siblings), D7=Saptamsa (children), D9=Navamsa (marriage), D10=Dasamsa (career), D12=Dwadashamsa (parents). Supports D2 through D60.
get_planetary_hours Calculate Chaldean planetary hours for a given day and location. Each hour is ruled by a planet in sequence — useful for electional timing.
get_transit_aspects Get detailed transit-to-natal aspects with impact ratings (high/moderate/low). Shows which transiting planets are affecting which natal planets and how strongly. Defaults to today's transits.