Back to Browse

Erux MCP Server

Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://api.erux.ai/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

6 tools verified · Open access · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-akashagl92-erux-astrology": {
      "url": "https://api.erux.ai/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

ERUX Astrology & Ephemeris MCP Server

MCPRush Glama MCP Registry Transport Version Discord License: MIT

The official Model Context Protocol (MCP) server for ERUX — the high-precision astronomical ephemeris and dual-zodiac astrology intelligence engine.

Connect Google Gemini, ChatGPT, Claude.ai, Perplexity, Claude Desktop, Claude Code, Cursor, Windsurf, Open-WebUI, LibreChat, or autonomous agent frameworks directly to deterministic astrological calculations without compiling C ephemeris libraries or running local Python background processes.


Key Capabilities

  • High-Precision Ephemeris Calculations: Sub-arcsecond planetary coordinates for Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu, Uranus, Neptune, Pluto, and Chiron.
  • Hybrid Insight Model (Dual-Zodiac Decoupling): Simultaneously evaluates Western Tropical Placidus (psychological and temperamental wiring) alongside Vedic Sidereal Lahiri (karmic timing and Dasha epochs).
  • 120-Year Parashara Vimshottari Timeline: Multi-level Mahadasha, Antardasha, and Pratyantardasha hierarchy with exact date boundaries down to the hour.
  • Real-Time Transit Horoscopes: Continuous tracking of planetary transits against natal chart cusps with structured transit aspect predictions.
  • Topocentric 24-Hora & Muhurta Engine: Dynamic planetary hours (Horas) tied to local solar sunrise and sunset, plus Rahu Kaal, Yamaganda, Gulika, and Abhijit Muhurta.
  • Classical Vedic Yoga Detection: Algorithmic identification of Raja, Dhana, Pancha Mahapurusha, and Gaja Kesari yogas with planetary trigger explanations.
  • Interactive Visual Wheel Generation: Tools automatically return interactive visual chart wheel URLs (https://erux.ai/chart?id=...) and rendered PNG previews.

MCP Endpoints, Registries & Direct Setup Links

ResourceEndpoint / Direct LinkPurpose
Remote MCP Serverhttps://api.erux.ai/mcpProduction Streamable HTTP endpoint for IDEs, AI assistants, and MCP SDKs
Google GeminiOpen Gemini Connected AppsClick + Custom, paste https://api.erux.ai/mcp, set Authentication to None
ChatGPTOpen ChatGPT PluginsClick Add (top-right), paste https://api.erux.ai/mcp into Server URL, set Auth to No Auth, and click Create as a plugin
Claude.ai WebOpen Claude.ai ConnectorsClick + -> Add custom connector, paste https://api.erux.ai/mcp, and click Add
PerplexityOpen Perplexity PluginsClick + Add custom -> Import plugin from GitHub, and paste https://github.com/akashagl92/erux_mcp
Developer Documentationerux.ai/developers/mcpInteractive 1-click setup guides, live tool schema inspector, and prompt playbook
Official MCP RegistryView on MCP RegistryOfficial Model Context Protocol registry manifest (io.github.akashagl92/erux-astrology)
GlamaView on GlamaGlama MCP Connector directory card, tool schema explorer, and client configs
MCPRushView on MCPRushCurated global MCP directory listing and client configurations
Developer SupportDiscord #dev-chatDirect engineering support, bug reports, and MCP integration assistance
ERUX Web Engineerux.aiInteractive natal, transit, and divisional (D1–D60) chart viewer for chart_ui_url outputs

Quickstart: Adding to Your MCP Client

ERUX runs as a remote Streamable HTTP (SSE) server at https://api.erux.ai/mcp. No local package installation, pip install, or npx compilation is required.

1. Google Gemini (Web & Mobile)

  1. Open Gemini Connected Apps and click + Custom in the top-right corner.
  2. Paste https://api.erux.ai/mcp, name it ERUX Astrology with Authentication set to None, and click Save.

2. ChatGPT (Custom MCP Plugin)

  1. Open ChatGPT Plugins and click Add in the top-right corner to open Add custom MCP server.
  2. Set Name to ERUX Astrology, paste https://api.erux.ai/mcp into Connection (Server URL), and change Authentication from OAuth to No Auth.
  3. Check I understand and want to continue and click Create as a plugin.

3. Claude.ai (Web & Mobile) & Claude Desktop

Claude.ai Web & Mobile:

  1. Open Claude.ai Connectors (or Customize -> Connectors).
  2. Click + -> Add custom connector, paste https://api.erux.ai/mcp, name it ERUX Astrology, and click Add.

Claude Desktop (claude_desktop_config.json):

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "erux-astrology": {
      "url": "https://api.erux.ai/mcp"
    }
  }
}

Using with mcp-remote (optional stdio bridge): If your client strictly requires a stdio process:

{
  "mcpServers": {
    "erux-astrology": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.erux.ai/mcp"]
    }
  }
}

4. Perplexity (1-Click GitHub Plugin Import)

  1. Open Perplexity Plugins and click + Add custom in the top-right corner.
  2. Select Import plugin from GitHub and paste https://github.com/akashagl92/erux_mcp.
  3. Perplexity automatically imports plugin.json, the remote HTTP mcp.json (https://api.erux.ai/mcp), and the erux-astrology skill bundle.

5. Claude Code CLI (Direct Vendor HTTP)

Register ERUX directly in Claude Code with zero third-party proxy dependencies:

claude mcp add --transport http erux https://api.erux.ai/mcp

6. Cursor & VS Code

Add to .cursor/mcp.json (Cursor Settings > Features > MCP) or .vscode/mcp.json:

{
  "mcpServers": {
    "erux-astrology": {
      "url": "https://api.erux.ai/mcp"
    }
  }
}

(1-click IDE deep links for Cursor and VS Code are also available on erux.ai/developers/mcp.)


7. Windsurf (Codeium)

Add to your mcp_config.json:

{
  "mcpServers": {
    "erux-astrology": {
      "serverUrl": "https://api.erux.ai/mcp"
    }
  }
}

8. Open-WebUI & LibreChat

Navigate to Admin Panel > Settings > Tools / MCP and register the remote SSE endpoint:

  • Server Name: erux-astrology
  • Server URL: https://api.erux.ai/mcp
  • Transport: sse / streamable-http

9. Python / LangChain / CrewAI Agents

import asyncio
from mcp.client.session import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def run_astrology_agent():
    async with streamablehttp_client("https://api.erux.ai/mcp") as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()

            # List available tools
            tools = await session.list_tools()
            print([tool.name for tool in tools.tools])

            # Calculate birth chart
            result = await session.call_tool("calculate_chart", {
                "date": "1992-10-14",
                "time": "14:30",
                "city": "Austin, Texas",
                "system": "hybrid"
            })
            print(result)

asyncio.run(run_astrology_agent())

Tool Catalog

ERUX exposes 6 deterministic tools to the host model:

1. calculate_chart

Calculates personal birth charts or national mundane charts.

  • Arguments:
    • date (string, YYYY-MM-DD): Birth date or national founding date.
    • time (string, HH:MM): 24-hour birth time (defaults to 12:00 solar noon if unknown).
    • city (string): City of birth or founding.
    • country (optional string): Country to disambiguate city name.
    • system (optional string): 'hybrid' (default), 'vedic', or 'western'.
  • Outputs: Exact planetary longitudes, retrogrades, nakshatras, house cusps, active Dasha cycle, and interactive chart_ui_url.

2. get_horoscope

Generates transit horoscopes, daily 24-Hora planetary hours, and transit aspect predictions.

  • Arguments:
    • birth_date (string, YYYY-MM-DD): User's natal birth date.
    • birth_city (string): Natal birth city.
    • birth_time (optional string, default '12:00'): Natal birth time.
    • current_city (optional string): Relocated city for local topocentric horizon.
    • cadence (optional string): 'daily' (Horas & Panchang), 'weekly', 'monthly', 'yearly' (Solar Return).
    • target_date (optional string): Future target forecast date.
  • Outputs: Real-world strategic guidance, topocentric 24-Hora schedule, Rahu Kaal, transit predictions, and interactive transits wheel link.

3. calculate_dasha

Computes the 120-year Parashara Vimshottari planetary timeline.

  • Arguments:
    • date (string, YYYY-MM-DD): Natal birth date.
    • time (string, HH:MM): 24-hour birth time.
    • city (string): Birth city.
    • target_date (optional string): Target date to inspect active sub-periods.
  • Outputs: 120-year Mahadasha timeline with full Antardasha and Pratyantardasha start and end dates.

4. get_yogas

Identifies classical Vedic yogas and active planetary formations.

  • Arguments:
    • date (string, YYYY-MM-DD): Natal birth date.
    • time (string, HH:MM): 24-hour birth time.
    • city (string): Birth city.
  • Outputs: Detected yogas (Raja, Dhana, Gajakesari, Mahapurusha), strength assessments, and planetary triggers.

5. ask_astrology_guidance

Contextual life pillar synthesis grounded in house significations and Karakas.

  • Arguments:
    • question (string): The user's life question (e.g. career pivot, relocation timing).
    • date (optional string, YYYY-MM-DD): Natal birth date for personalized house and Dasha evaluation.
    • time (optional string, HH:MM, default '12:00'): Natal birth time.
    • city (optional string): Natal birth city for personalized chart grounding.
  • Outputs: Grounded astrological framework guidance with relevant house, active Dasha, and Karaka analysis.

6. get_interpretation

Comprehensive deep-dive analysis across canonical life pillars.

  • Arguments:
    • topic (optional string, default 'career_and_vocation'): Canonical life pillar topic (e.g. 'career_and_vocation', 'love_and_relationships', 'wealth_and_finances', 'health_and_vitality').
    • date (string, YYYY-MM-DD): Natal birth date.
    • time (optional string, HH:MM, default '12:00'): Natal birth time.
    • city (string): Natal birth city.
    • current_city (optional string): Relocated city for topocentric transit context.
    • system (optional string, default 'hybrid'): 'hybrid', 'vedic', or 'western'.
  • Outputs: Detailed analysis combining natal placements, dasha cycles, and transit influences.

Example Prompts

Ask your MCP-connected model:

  • "What is my current Vimshottari Mahadasha and Antardasha? Born October 14, 1992 at 2:30 PM in Austin, Texas."
  • "Show my complete birth chart wheel and calculate my Vedic yogas."
  • "What are the best astronomical Horas for business negotiations today in London?"
  • "Calculate the national mundane chart for France and summarize its key planetary placements."
  • "I am planning a career transition next month. Based on my natal placements, what planetary transits are active?"

Security & Architecture

  • Hosted Remote Endpoint: All astronomical calculations execute on secure, hardened ERUX cloud infrastructure (api.erux.ai).
  • No Local Code Execution: Connecting to ERUX does not execute arbitrary binaries or scripts on your local machine.
  • Zero API Keys Required: The public MCP endpoint requires no authentication or upfront API keys for standard queries.
  • Read-Only & Idempotent: All tools are annotated as read-only and idempotent, ensuring safe execution within enterprise agent workflows.

Resources & Links


License

This repository and its configuration schemas are licensed under the MIT License. Calculations and data provided via the ERUX API are subject to the ERUX Terms of Service.

Reviews

No reviews yet

Be the first to review this server!