# Sunrise-Sunset MCP for AI Agents AI Agent Connect

> Sunrise-Sunset gives you exact solar data for any spot on the planet. If you need to know when the sun hits a specific coordinate for a shoot, an event, or a solar study, this Connector pulls the numbers for you instantly. It handles sunrise, sunset, daylight duration, and all three phases of twilight.

## Overview
- **Category:** scientific-research
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_h5QVzZiOuKY354MuvcVnIyjZwY4zxU3WwytiY6cR/ai-agent-connect
- **Tags:** solar-data, astronomy, sunrise, sunset, geospatial

## Description

Imagine you're trying to plan a high-end outdoor wedding or a commercial photo shoot in a location you've never visited. You need to know exactly when the golden hour hits, but checking various time zones and local weather apps is a chore. This Connector changes that by letting your AI agent handle the heavy lifting. Instead of manual searching, you just tell your agent where you're going and when, and it pulls the precise astronomical data. It covers the basics like sunrise and sunset, but it also gets into the weeds with civil, nautical, and astronomical twilight times. This level of detail is huge for anyone who needs to know exactly how much light is available at a specific minute. Whether you're calculating solar potential for a building or just trying to make sure your guests aren't standing in the dark during a reception, this tool provides the raw numbers you need without the fluff. It's one of the many specialized tools available in the Vinkius catalog that turns a multi-tab research project into a single conversation with your AI. You get the data you need, exactly when you need it, based on precise coordinates and your preferred timezone.

## Tools

### get_sunrise_sunset
Pulls the exact sunrise and sunset times for any latitude and longitude. This helps you plan lighting for events or calculate solar exposure for specific sites.

## Prompt Examples

**Prompt:** 
```
What's the sunset and civil twilight in Rome on June 21st?
```

**Response:** 
```
For Rome on June 21st, here are the solar details:

*   **Sunset**: 09:44 PM
*   **Civil Twilight**: 10:12 PM
*   **Nautical Twilight**: 10:45 PM
*   **Astronomical Twilight**: 11:18 PM

This provides a long window of usable light for evening events.
```

**Prompt:** 
```
Give me the day length for a site at 40.7128, -74.0060 for the whole month of January.
```

**Response:** 
```
Here is the day length for New York City (40.7128, -74.0060) for January 2025:

| Date | Day Length |
| :--- | :--- |
| Jan 01 | 9h 44m |
| Jan 15 | 9h 58m |
| Jan 31 | 10h 12m |

The days are lengthening by about 1 minute every day during this period.
```

**Prompt:** 
```
I'm shooting in Iceland. What time is the golden hour on October 12th?
```

**Response:** 
```
For Iceland on October 12th, here is the lighting data:

*   **Sunrise**: 07:45 AM
*   **Sunset**: 06:12 PM
*   **Golden Hour**: This window begins roughly one hour before sunset, starting around 05:12 PM.

Note that because of the high latitude, twilight lasts significantly longer than in more southern regions.
```

## Capabilities

### Get sunrise and sunset times
Find the exact moments the sun rises and sets for any latitude and longitude.

### Check twilight phases
Access civil, nautical, and astronomical twilight data for precise light planning.

### Calculate total day length
Retrieve the total duration of daylight for any specific date and location.

### Specify local timezones
Get results in your specific local time using the tzid parameter.

### Query historical solar data
Look up solar events for dates in the past to analyze historical light patterns.

### Plan future solar events
Get accurate solar data for future dates to plan upcoming projects or events.

## Use Cases

### Planning a destination photo shoot
A photographer needs to know the exact blue hour for a shoot in Tokyo on a specific date. They ask the agent to pull the twilight timings for those coordinates.

### Solar energy feasibility study
An engineer wants to know how many hours of direct sunlight a site in Arizona gets in December. The agent calculates the day length for the specific coordinates.

### Outdoor wedding lighting schedule
A wedding planner needs to check if a 6 PM ceremony in Italy will have enough natural light. The agent provides the sunset and civil twilight times.

### Mapping seasonal light changes
A researcher needs to pull the day length for 50 different coordinates to map out seasonal changes. The agent processes these requests one by one.

## Benefits

- Eliminate manual timezone math by letting the Connector handle tzid parameters automatically for any location.
- Nail the golden hour for photography by getting specific civil and nautical twilight timings.
- Get accurate solar exposure data for energy audits by checking total day lengths for any date.
- Plan events with confidence by knowing exactly when natural light will fade in different regions.
- Access historical solar data to analyze past weather patterns or light conditions for research.
- Reduce research time by getting multiple solar metrics in a single request.

## How It Works

The bottom line is you get precise astronomical data for any coordinate on Earth without leaving your chat interface.

1. Subscribe to the Sunrise-Sunset MCP and enter your API credentials.
2. Connect the Connector to your preferred client like Claude or Cursor.
3. Ask your agent for solar data for any location and date.

## Frequently Asked Questions

**Can Sunrise-Sunset MCP give me the exact time for a specific city?**
Yes, it uses coordinates to give you the exact time for any city on Earth, including specific local times.

**Does Sunrise-Sunset MCP include twilight times?**
Yes, it provides civil, nautical, and astronomical twilight data to help you plan for specific light levels.

**Can I use Sunrise-Sunset MCP to plan a shoot for next year?**
Yes, it can query both historical and future dates, making it perfect for long-term project planning.

**Does Sunrise-Sunset MCP handle different timezones?**
Yes, you can specify the timezone to ensure the results match your local clock exactly.

**Is Sunrise-Sunset MCP good for solar energy research?**
It is excellent for calculating day length and solar exposure for specific coordinates to determine energy potential.

**How accurate is the data from Sunrise-Sunset MCP?**
It provides precise astronomical data based on latitude and longitude, ensuring high accuracy for professional use.

**Can I get solar data for a specific date in the future?**
Yes! Use the `get_sunrise_sunset` tool and provide the `date` parameter in YYYY-MM-DD format (e.g., '2025-12-25').

**Does the tool support local timezones?**
Yes. By providing a `tzid` (like 'Europe/London' or 'America/New_York'), the tool returns times adjusted for that specific region.

**What is the difference between civil and astronomical twilight in the results?**
The `get_sunrise_sunset` tool returns all phases. Civil twilight is when there is still enough light for outdoor activities, while astronomical twilight marks when the sky is completely dark for astronomical observations.