# Moon Phase Calculator MCP for AI Agents MCP

> The Moon Phase Calculator gives you precise astronomical data for any date. It accurately determines the moon's current phase name and how much of its disk is visible, using established lunar algorithms. You can generate full monthly calendars, compare the brightness between two dates, or quickly check a specific day’s exact lunar details.

## Overview
- **Category:** utilities
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_soLzpvW0Ef4xx8ewhekQSA7RwAV5LPmW6wnym2A5/mcp
- **Tags:** moon, lunar, astronomy, calendar, science

## Description

Need accurate lunar cycle data for research, photography planning, or writing? This MCP calculates high-precision astronomical figures based on known celestial math. Instead of hunting through external APIs or complex spreadsheets, your AI client handles the calculations automatically.

It tells you if the moon is in a Waxing Crescent or Full Moon and gives you the exact percentage of illumination for any date you pick. You can ask it to generate an entire calendar view for a specific month, listing every major lunar event. Or maybe you need to know which night will give you the best shot? Use the tool to compare the brightness between two dates instantly.

Connecting this MCP through Vinkius means your AI agent has instant access to these deep astronomical calculations without needing complicated setup or worrying about external service downtime. It's reliable, accurate data when you need it most.

## Tools

### compare_brightness
Compares two given dates to tell you which one has a more brightly lit moon.

### generate_monthly_schedule
Creates a full calendar detailing all the major lunar events and phases for an entire month and year.

### calculate_phase
Retrieves the exact name of the moon's phase and its current brightness percentage for a specified date.

## Prompt Examples

**Prompt:** 
```
What's the moon status on July 4th next year?
```

**Response:** 
```
**Lunar Phase Report: July 4, 2025**

*   **Phase:** First Quarter
*   **Illumination:** Approximately 51%
*   **Notes:** The moon will be visible and steadily increasing in brightness that week. Great for landscape shots.

(Data accurate to the nearest percentage point.)
```

**Prompt:** 
```
I'm comparing two dates: Nov 10th and Dec 5th.
```

**Response:** 
```
Comparing illumination levels:

| Date | Phase Name | Illumination % |
| :--- | :--- | :--- |
| **Nov 10** | Waxing Gibbous | 78% |
| **Dec 5** | Full Moon | 99% |

Conclusion: December 5th will be significantly brighter and more fully illuminated. You'll need to adjust your camera settings accordingly.
```

**Prompt:** 
```
Generate the lunar schedule for March.
```

**Response:** 
```
**Lunar Schedule: March 2025**

*   Mar 1 (New Moon): Minimal light.
*   Mar 13 (First Quarter): ~50% illumination.
*   Mar 20 (Full Moon): Peak visibility, ~98% illumination.
*   Mar 27 (Last Quarter): Fading brightness.
```

## Capabilities

### Determine Moon Phase and Brightness
Get the specific name (like First Quarter) and illumination percentage for any given date.

### Generate Full Lunar Calendars
Request a comprehensive list of all major lunar events and phases for an entire month.

### Compare Lunar Brightness Across Dates
Figure out which of two specific dates features the more brightly illuminated moon.

## Use Cases

### Planning a Stellar Photography Shoot
An astrophotographer needs to know if their planned shoot date is ideal. They ask the agent, 'Which date in September will be brightest?' The agent uses `compare_brightness` and tells them that Sept 12th offers superior illumination compared to Sept 3rd.

### Writing a Sci-Fi Novel
A fantasy writer needs the exact lunar phases for their story's setting. They prompt the agent to 'Show me the full schedule for Year X, Month Y.' The agent uses `generate_monthly_schedule` and provides accurate phase names (e.g., Waning Gibbous) for historical consistency.

### Educational Presentation Prep
A science teacher needs to demonstrate lunar cycles on a specific day. They ask the agent, 'What is the moon status on June 21st?' The agent uses `calculate_phase` and returns the precise details (e.g., Full Moon, 99% illumination) instantly.

### Event Timing Logistics
An outdoor event planner needs to schedule a festival around a major lunar event. They ask the agent to compare two potential dates using `compare_brightness`, allowing them to choose the spot with maximum natural light contrast.

## Benefits

- Plan shoots with confidence. Use `compare_brightness` to ensure your target date has the optimal moon illumination level.
- Stop manual research. Generate a complete cycle overview for any month using `generate_monthly_schedule`, giving you an entire year's worth of timing data in one go.
- Get immediate details on demand. Quickly find out the exact phase name and brightness percentage for a single date with `calculate_phase`.
- Eliminate guesswork. No more relying on generalized calendars; this tool uses high-precision astronomical math, giving you reliable numbers every time.
- Focus on your art, not your data. Let your AI agent handle complex calculations that used to take hours of cross-referencing.

## How It Works

The bottom line is you ask your AI client a question about lunar cycles or dates, and it uses this MCP to calculate and deliver accurate astronomical results instantly.

1. Tell your AI client what you want to know, for example: 'What is the lunar phase on October 15th?'
2. The MCP runs its astronomical calculations using established algorithms and returns the specific name of the phase and the precise illumination percentage.
3. Your agent presents a clean summary of the data, giving you clear details about the moon's appearance for that date.

## Frequently Asked Questions

**How accurate is the Moon Phase Calculator for AI Agents?**
It uses high-precision astronomical algorithms, making the data highly reliable. You get exact phase names and illumination percentages, which is far better than general estimates found online.

**Can I use the Moon Phase Calculator to plan a photography trip?**
Yes. If you need to compare two dates for the best lighting conditions, let your AI client run `compare_brightness`. It tells you exactly which date will provide optimal visibility.

**Does this MCP handle lunar cycles beyond just full and new moons?**
Absolutely. The system calculates all phases, like Waxing Crescent or Last Quarter. You get the specific name and a percentage of illumination for any date you check.

**What if I need to know about multiple months? Is it possible with Moon Phase Calculator?**
You can generate full monthly schedules using `generate_monthly_schedule`. This gives you a comprehensive calendar view of all major lunar events for any given month and year.

**Is this better than just searching Google for 'moon phase'? **
Yes. Searching Google yields general articles, but this MCP gives you calculated data. You get verifiable results about illumination percentages and specific phases that are ready to use in your writing or planning.