# Planetary Hour Calculator MCP for AI Agents MCP

> The Planetary Hour Calculator determines the precise timing and governing celestial body for each of the twenty-four planetary hours in a day, following ancient Chaldean astrology. This MCP helps you map out complex temporal schedules by dividing daylight and night into distinct segments, allowing your AI agents to generate full daily horoscopes or time flow charts based on specific astronomical parameters.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DzfthSHOnxzEVQMbdUAFjmTxitmFcaSr0OMVnn5S/mcp
- **Tags:** astrology, chaldean, planetary-hours, astronomical-time, schedule-generator

## Description

This connector lets you calculate the precise timing of planetary hours according to Chaldean tradition. Instead of guesswork, you get a structured timeline that maps every segment of the day—both daylight and night—to its ruling planet. You tell your AI agent the sunrise and sunset times, and it handles the complex math required to divide those periods into 24 equal parts. For instance, if you need a full schedule, the MCP runs `get_planetary_schedule` to give you start times, end times, and planets for every hour. Need to know how long the day or night segments are? Use `calculate_segment_durations`. Or maybe you only care about the beginning—`get_day_planet_affinity` identifies the planet that rules the first hour of any given weekday. Connecting this MCP through Vinkius gives your AI client access to deep, specific calendrical data without needing custom code or complex external lookups.

## Tools

### get_day_planet_affinity
Identifies which planet rules the first hour of a specific weekday, giving you immediate insight into the day's energy.

### get_planetary_schedule
Generates a comprehensive list covering all twenty-four planetary hours for any given day, including precise start and end times.

### calculate_segment_durations
Determines the specific length (in minutes or hours) of the daylight and nighttime portions of a planetary cycle.

## Prompt Examples

**Prompt:** 
```
What's the full planetary schedule for a day starting at 05:30 and ending at 19:30?
```

**Response:** 
```
**Planetary Schedule: Day X**

*   **Daylight Hours (05:30 - 19:30):**
    *   Moon: 05:30 to 07:45
    *   Mars: 07:45 to 09:30
    *   Jupiter: 09:30 to 11:15
    *   ... (and so on, listing all 24 segments with precise times)
*   **Nighttime Hours (19:30 - Day X+1 05:30):**
    *   Saturn: 19:30 to 21:45
    *   ... (showing the continuous cycle until the next sunrise)
```

**Prompt:** 
```
How long were the day and night segments on a Monday?
```

**Response:** 
```
**Segment Lengths**

| Segment | Start Time | End Time |
| :--- | :---: | :---: |
| Daylight | 06:00 | 18:00 | 12 hours (720 minutes) |
| Nighttime | 18:00 | 06:00 | 12 hours (720 minutes) |

*Calculation based on average seasonal length.*
```

**Prompt:** 
```
What planet rules the start of a Friday?
```

**Response:** 
```
**First Hour Affinity**

The primary ruler for the first hour of Friday is **Venus**. This suggests themes related to love, balance, and artistry will dominate the beginning of the week.
```

## Capabilities

### Generate a full planetary schedule
Retrieves a complete list of all 24 planetary hours for a specified day, including start times and ruling planets.

### Determine segment durations
Calculates the exact length of the daytime and nighttime periods based on provided astronomical times.

### Identify first-hour ruler
Pinpoints the governing planet for the initial hour of a given weekday.

## Use Cases

### Creating a full daily reading for a client
An astrologer needs to generate the complete 24-hour schedule for a consultation. The agent runs `get_planetary_schedule`, providing the start and end times for every hour, which is then formatted into a readable chart.

### Comparing day/night cycle lengths
A researcher wants to know if a specific historical date had an unusually long or short daylight period. The agent uses `calculate_segment_durations` with the given sunset and sunrise times, providing a quick comparative metric.

### Determining the energy of a starting day
A student needs to know what planetary influence governs their exam week. The agent uses `get_day_planet_affinity` for Friday, immediately identifying Venus as the ruler for the first hour.

### Building a complex time-based narrative
A writer needs to describe how a specific ritual unfolds over 24 hours. The agent uses `get_planetary_schedule` to build the timeline, ensuring that every transition point is marked with the correct planet and timing.

## Benefits

- Get a full daily reading instantly. Use `get_planetary_schedule` to map out all twenty-four planetary hours, including start times and ruling planets for any given day.
- Understand the time structure at a glance. Run `calculate_segment_durations` to know exactly how long your daytime or nighttime segments are—no manual math needed.
- Focus on key moments. Use `get_day_planet_affinity` when you only need to know which planet governs the very first hour of a specific weekday.
- Accuracy matters for complex systems. This MCP handles the tricky transitions between daylight and night cycles, ensuring your schedule is always correct.
- Saves research time. Instead of cross-referencing multiple tables or formulas, your AI agent gets one clean output with all necessary timing data.

## How It Works

The bottom line is, you get accurate, segmented temporal data based on specific astrological timing rules, ready to feed into any analysis your AI client needs.

1. You provide your AI agent with key dates and times: sunrise, sunset, and the next day's sunrise.
2. The MCP processes these inputs using its internal rules to divide the total time into 24 segments, calculating the start/end points for each one. This might involve running `calculate_segment_durations` first.
3. Your agent receives a structured output containing the full schedule and all associated planetary rulers for that day.

## Frequently Asked Questions

**How does the Planetary Hour Calculator work with different sunrise/sunset times?**
It calculates the schedule using your specific timings. Instead of a standard 12-hour day, it accurately segments the time based on the exact duration between sunrise and sunset, ensuring every hour is correct for your location.

**Do I need to know my latitude or longitude?**
The MCP handles the complex astronomical calculations internally. You just need to provide the specific date and the local timings (sunrise/sunset), and it generates the schedule.

**Can I use this for a full 24-hour reading?**
Yes, you can get a complete 24-hour planetary schedule. It accurately maps both the daylight hours and the subsequent nighttime hours into continuous segments.

**What if I only want to know what day a specific planet rules?**
You can use the tool to identify which planet governs the first hour of any given weekday, giving you an immediate insight into that day's primary influence.