ERUX Astrology & Ephemeris Engine

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Ephemeris natal & mundane charts, Vimshottari Dasha, transit horoscopes, Horas, and Vedic yogas.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "ERUX Astrology & Ephemeris Engine": {
      "url": "https://api.erux.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (6)

• calculate_chart read-only

  Calculate a deterministic personal natal chart or national mundane chart using the high-precision astronomical ephemeris calculation engine. Corresponds to /chart and /mundane slash commands. Supports EITHER a country name (e.g. 'India', 'USA', 'France') for a national chart OR personal birth details ('date', 'time', 'city'). Automatically provides dynamic 'chart_ui_url', calculates planetary placements, active Dasha cycle, grounded knowledge-base insights, and an ERUX interactive UI link. CRITICAL FOR AI: When calculate_chart is called, present the key placements cleanly and provide a direct, prominent link inviting the user to view their interactive chart wheel on ERUX using 'chart_ui_url' (e.g. [✨ Open Your Interactive Chart Wheel on ERUX](chart_ui_url)).

  Parameters:

  • city — Birth city or founding location (e.g. 'London', 'New York', 'Mumbai')
  • date — Natal birth date or event founding date in YYYY-MM-DD format (e.g. '1992-10-24')
  • time — Birth time in 24-hour HH:MM format (default '12:00' solar noon if exact time unknown)
  • system — string — Astrological coordinate framework: 'hybrid' (Vedic sidereal + Western psychological), 'vedic', or 'western'
  • country — Country name for national mundane chart or location disambiguation (e.g. 'United States', 'India', 'France')
  • birth_city — Explicit alias for natal birth city
  • birth_date — Explicit alias for natal birth date (YYYY-MM-DD)
  • birth_time — Explicit alias for natal birth time (HH:MM)
  • user_prompt — Raw user query for intent arbitration and conversational context grounding
  • birth_country — Explicit alias for natal birth country
  • include_image — boolean — Set to true to render and attach a dynamic chart wheel PNG image buffer (default true)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_horoscope read-only

  Generate a personalized transit horoscope, real-world strategic forecast, and exact astronomical time-windows for a user based on their natal placements and active planetary transits. Corresponds to /horoscope and /daily commands. Supports cadences: 'daily' (today's transits and hourly Horas), 'weekly' (7-day Monday–Sunday transit arc), 'monthly' (30-day sign ingresses & lunations), and 'yearly' (12-month Solar Return to Solar Return Varshaphala journey). MANDATORY PARAMETERS: The user's natal birth date ('birth_date', YYYY-MM-DD) and natal birth city ('birth_city') are strictly required. NEVER pass today's date into 'birth_date' — today's transit date is calculated automatically by the server based on location coordinates. If the user asks for a future or target date (e.g. next week or 2027), pass that date into 'target_date', NOT 'birth_date'. Optionally accepts 'current_city' if the user has relocated, 'cadence' ('daily', 'weekly', 'monthly', 'yearly'), and 'user_prompt' containing the user's raw inquiry. For daily cadence, returns 'astronomical_time_windows' (exact topocentric sunrise/sunset, 24 planetary Horas, Rahu Kaal, Abhijit Muhurta, Brahma Muhurta) and 'panchang_timing' (exact Nakshatra and Tithi transitions). CRITICAL FOR AI: When suggesting times of day, you MUST quote the exact astronomical_time_windows provided. Never invent arbitrary hours.

  Parameters:

  • city — Alias for natal birth city
  • date — Alias for natal birth date (YYYY-MM-DD)
  • time — Alias for natal birth time (HH:MM)
  • cadence — Forecast time window: 'daily' (Horas & Panchang), 'weekly' (7-day), 'monthly' (30-day), or 'yearly' (Varshaphala)
  • country — Country of birth or current location
  • birth_city — REQUIRED: User's natal birth city (e.g. 'London', 'Austin', 'Mumbai').
  • birth_date — REQUIRED: User's natal birth date (YYYY-MM-DD, e.g. '1990-07-12'). Do NOT pass today's date here.
  • birth_time — Natal birth time in 24-hour HH:MM format (default '12:00' if unknown)
  • target_city — Alias for current relocated city
  • target_date — Target forecast date in YYYY-MM-DD format (must be today or future date)
  • user_prompt — User's original inquiry for intent grounding and conversational context
  • current_city — Current relocated city for topocentric horizon and local Horas (e.g. 'London')
  • birth_country — Natal country to disambiguate birth city
  • include_image — boolean — Set to true to render and attach a dynamic chart wheel PNG image buffer in MCP outputs (default false)
  • current_country — Current relocated country

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• calculate_dasha read-only

  Calculate the classical Parashara Vimshottari Dasha planetary timeline (120-year cycle) for a person or founding event. Corresponds to the /dasha slash command. Requires birth date ('date', YYYY-MM-DD), birth time ('time', HH:MM, default '12:00'), and birth city ('city'). Returns current Mahadasha and Antardasha periods, active dates, psychological and karmic significance, upcoming macro-epochs, and a direct link to the interactive ERUX Dasha calendar.

  Parameters:

  • city — string — Natal birth city (e.g. 'London', 'Kanpur')
  • date — Natal birth date in YYYY-MM-DD format (e.g. '1992-10-24')
  • time — string — Natal birth time in 24-hour HH:MM format (default '12:00')
  • country — Country of birth to disambiguate city
  • birth_city — Explicit alias for natal birth city
  • birth_date — Explicit alias for natal birth date (YYYY-MM-DD)
  • birth_time — Explicit alias for natal birth time (HH:MM)
  • target_date — Target historical or future evaluation date (YYYY-MM-DD, defaults to current date)
  • user_prompt — Raw user query for intent arbitration
  • birth_country — Explicit alias for natal birth country

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_yogas read-only

  Identify auspicious & powerful classical Vedic Yogas present in a birth or mundane chart (e.g. Raja Yogas, Dhana Yogas, Pancha Mahapurusha Yogas, Gaja Kesari, Budhaditya). Corresponds to the /yogas slash command in Discord and Google Chat. Requires birth details ('date', 'time', 'city') or country name ('country'). Returns active yogas, classical definitions, and link to ERUX divisional varga breakdown.

  Parameters:

  • city — Birth city or founding location
  • date — Natal birth date or event founding date in YYYY-MM-DD format
  • time — Birth time in 24-hour HH:MM format (default '12:00')
  • country — Country name for personal birth city disambiguation or national mundane chart
  • birth_city — Explicit alias for natal birth city
  • birth_date — Explicit alias for natal birth date (YYYY-MM-DD)
  • birth_time — Explicit alias for natal birth time (HH:MM)
  • user_prompt — Raw user query for intent arbitration
  • birth_country — Explicit alias for natal birth country

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• ask_astrology_guidance read-only

  Provide authentic, deterministic astrological framework guidance for any life question (e.g. career shift, relationship milestones, financial timing, health/somatic wellness, relocation). Corresponds to the /ask slash command in Discord and Google Chat. Explains which astrological houses, ruling planetary significators (Karakas), and timing triggers govern the user's inquiry, with a direct CTA to explore the full chart on ERUX.

  Parameters:

  • question (required) — string — Astrological or life guidance question to analyze (e.g. 'When will my career shift?', 'What does my 10th house indicate?')
  • platform — string — Caller host platform or MCP client identifier (e.g. 'chatgpt', 'claude_desktop', 'cursor', 'windsurf', 'smithery', 'global_registry', 'zed', or any custom client). Defaults to 'mcp_gateway'

  Hints: read-only yes · destructive no · idempotent no · open-world yes

• get_interpretation read-only

  Get deep personalized astrological interpretation for canonical life pillars or placements (e.g. 'career_and_vocation', 'relationships', 'dasha_analysis', 'wealth_and_finance', 'health_and_vitality'). Corresponds to the /interpret slash command in Discord and Google Chat. Can be run with or without specific birth details.

  Parameters:

  • city — Optional birth city for natal chart mapping
  • date — Optional birth date in YYYY-MM-DD format for personalized placements
  • time — Optional birth time in 24-hour HH:MM format (default '12:00')
  • topic — string — Canonical life pillar: 'career_and_vocation', 'relationships', 'wealth_and_finance', 'health_and_vitality', or 'inner_growth'
  • system — string — Astrological coordinate framework: 'hybrid', 'vedic', or 'western'
  • platform — string — Caller host platform or MCP client identifier (e.g. 'chatgpt', 'claude_desktop', 'cursor', 'windsurf', 'smithery', 'global_registry', 'zed', or any custom client). Defaults to 'mcp_gateway'
  • birth_city — Explicit alias for natal birth city
  • birth_date — Explicit alias for natal birth date (YYYY-MM-DD)
  • target_city — Alias for current relocated city
  • user_prompt — Raw user query for intent arbitration
  • current_city — Current relocated city
  • birth_country — Explicit alias for natal birth country

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.