# Vedic Nakshatra Calculator MCP

> The Vedic Nakshatra Calculator determines the Moon's exact location within the 27 lunar mansions (Nakshatras). It performs precise astronomical calculations, identifying a specific moment’s ruling deity, symbol, and astrological quality based on birth coordinates. This MCP provides raw data retrieval for ecliptic longitude and ayanamsa adjustments, giving users deep insight into sidereal zodiac mechanics.

## Overview
- **Category:** astrology
- **Price:** Free
- **Tags:** nakshatra, vedic-astrology, lunar-mansions, sidereal-zodiac, astronomical-calculations

## Description

Astrological timing requires more than just dates; it demands precise celestial mathematics. This MCP gives you access to calculations that pinpoint the Moon's position within the 27 lunar mansions according to Vedic tradition. You input a specific time and location, and the system calculates the exact attributes of that moment—including the governing deity and quality (guna). For deeper dives into pure astronomy, it also provides raw data like ecliptic longitude, allowing you to adjust for ayanamsa values yourself. If your current workflow is spread across multiple research databases or manual charts, connecting through Vinkius centralizes this complex computation. You simply ask your agent for the required celestial data, and it handles the math.

## Tools

### calculate_lunar_position
Outputs the raw astronomical longitude needed for foundational astrological calculations.

### get_nakshatra_details
Pinpoints a specific lunar mansion and returns all its associated attributes for a given time.

### list_all_constellations
Generates a complete list of all 27 Nakshatras, including their primary identifiers.

## Prompt Examples

**Prompt:** 
```
Find the Nakshatra for someone born on 1990-05-15 at 10:30 in New York (Lat: 40.71, Lon: -74.00).
```

**Response:** 
```
The tool `get_nakshatra_details` would return the specific Nakshatra name, its ruling deity, symbol, and the calculated pada.
```

**Prompt:** 
```
List all the constellations in the zodiac.
```

**Response:** 
```
Using `list_all_constellations`, the tool returns a complete list of all 27 Nakshatras with their respective symbols.
```

**Prompt:** 
```
What is the lunar longitude for 2023-10-01 at 12:00 in London?
```

**Response:** 
```
The `calculate_lunar_position` tool will provide the ecliptic longitude and the ayanamsa value for that specific time.
```

## Capabilities

### Calculate Raw Lunar Position
Gets the precise astronomical longitude of the Moon at any given time.

### Detail Specific Nakshatra Data
Identifies a specific lunar mansion and retrieves all its associated attributes, such as ruling deities and symbols.

### List Full Zodiac Inventory
Provides a complete list of the 27 constellations (Nakshatras) and their primary identifiers for reference.

## Use Cases

### Validating a Birth Chart
A student needs to verify the Nakshatra for a client born on a specific date and time. Instead of consulting physical charts, they ask their agent to use `get_nakshatra_details`, receiving the precise name, deity, and attributes immediately.

### Building a Comparative Model
A researcher needs to compare lunar cycles across different epochs. They instruct their agent to run `calculate_lunar_position` multiple times with varying dates to get the raw longitudinal data needed for analysis, bypassing complex astronomical software.

### Creating a Reference Guide
An astrologer is writing an e-book on the zodiac. They ask their agent to run `list_all_constellations` to retrieve every Nakshatra’s name and symbol, saving hours of manual data entry.

### Troubleshooting Timing Errors
A practitioner suspects a timing error in an old record. They use the MCP's ability to calculate lunar positions to get current raw longitude values, ensuring their interpretation is based on verifiable astronomical math.

## Benefits

- Stop guessing the Moon's location. Use `get_nakshatra_details` to pinpoint a specific Nakshatras’ ruling deity, symbol, and quality for any moment in time.
- Need raw data for your models? The `calculate_lunar_position` tool provides the exact ecliptic longitude and ayanamsa values you need without manual math.
- Build comprehensive reference guides easily. Running `list_all_constellations` gives you a complete, verified inventory of all 27 Nakshatras instantly.
- Accuracy is key for deep research. This MCP ensures your calculations respect the complex rules of sidereal zodiac mechanics.
- Cross-reference attributes fast. Instead of checking multiple academic sources, let your agent pull the ruling deity and symbol from `get_nakshatra_details` in one go.

## How It Works

The bottom line is: you get accurate, calculated celestial positions without doing any math yourself.

1. You provide your agent with the necessary inputs: a date, time, and geographical coordinates.
2. The MCP runs complex astronomical calculations to map the Moon's current position relative to the zodiacal framework.
3. Your agent receives structured data detailing the specific Nakshatra name, its governing attributes, or raw longitudinal values.

## Frequently Asked Questions

**How do I find the ruling deity for a birth time using `get_nakshatra_details`?**
You simply provide your agent with the required date, time, and coordinates. The tool runs the calculation and returns the specific Nakshatra name along with its associated ruling deity.

**What is the difference between `calculate_lunar_position` and `get_nakshatra_details`?**
`calculate_lunar_position` only gives you raw astronomical numbers (like ecliptic longitude). It's a foundational metric. `get_nakshatra_details`, however, takes those metrics and translates them into readable astrological attributes.

**Can I list all constellations using the `list_all_constellations` tool?**
Yes, running `list_all_constellations` provides a complete inventory of the 27 Nakshatras. It’s perfect for building reference sections or educational content.

**Do I need to provide coordinates when using `get_nakshatra_details`?**
Yes, you must provide accurate geographical coordinates (latitude and longitude) along with the date and time. The calculation relies on these inputs to pinpoint the exact local celestial alignment.

**What should I do if the date or time input causes an error when using `get_nakshatra_details`?**
The MCP will return a specific error message indicating why the calculation failed. You must verify that your date format and coordinates fall within the acceptable range for accurate results.

**How does `calculate_lunar_position` account for ayanamsa adjustments?**
The tool integrates necessary ayanamsa calculations into its output. This ensures you receive the precise ecliptic longitude required by sidereal Vedic astrology standards.

**Are there rate limits when I call `get_nakshatra_details` repeatedly for many people?**
While the platform manages general usage, rapid, high-volume calls might trigger temporary throttling. For bulk processing, it's best to check Vinkius documentation or batch your requests.

**Does `list_all_constellations` provide details beyond just the names of the 27 Nakshatras?**
No. This tool is strictly limited to listing a complete inventory of all 27 Vedic lunar mansions, providing only their respective identifiers.

**What is a Nakshatra?**
A Nakshatra is one of the 27 lunar mansions in Vedic astrology, representing a specific segment of the ecliptic path of the Moon.

**How accurate are the calculations?**
The tool uses precise astronomical algorithms to calculate the Moon's ecliptic longitude and applies the necessary Ayanamsa correction for sidereal zodiac accuracy.

**Can I use this for any date and time?**
Yes, as long as you provide a valid ISO 8601 date and time along with the correct geographic coordinates.