# SolarAnywhere API MCP for AI Agents AI Agent Connect

> SolarAnywhere API lets your AI agent pull high-resolution solar irradiance data and audit site metadata without you needing to navigate a complex technical portal. It turns messy meteorological searches into direct answers for renewable energy research and fleet management. You can get real-time GHI and DNI levels or pull long-term TMY patterns to see how a site actually performs over time.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_f0Kcu4NfnecUhzQ7w6ckL5Ei26Fo5XomerzJCBWI/ai-agent-connect
- **Tags:** solar-irradiance, meteorological-data, energy-intelligence, site-auditing, renewable-energy

## Description

Imagine you're trying to figure out the solar potential of a new site in a region you've never worked in. Usually, this means digging through different weather databases, comparing TMY reports, and trying to find reliable real-time irradiance numbers. It's a lot of tabs and manual data entry. With the SolarAnywhere API, your AI agent does the heavy lifting. You just ask it about a specific coordinate, and it pulls the latest GHI and DNI data, along with temperature metadata. It handles the technical side of the query so you can focus on the actual analysis. If you're managing a regional fleet, you can ask your agent to list all your registered sites and check their current status in one go. It's about moving from how do I find this data to what does this data mean for my project. Because Vinkius manages the connection, you get this power across your preferred AI client without the usual setup headaches. You get a research assistant that actually knows where the good sun is.

## Tools

### check_api_status
Checks the operational status of the SolarAnywhere service to ensure your workflow stays active. Use this to confirm your data feed is live.

### get_solar_irradiance
Fetches real-time GHI and DNI data for a specific location to check current solar conditions. This helps you see exactly how much sun is hitting a site right now.

### get_typical_solar_year
Pulls TMY solar data for a location to help understand long-term energy production potential. Use this to model year-round performance for new projects.

### list_solar_sites
Lists all solar sites registered in your account to give you a clear view of your portfolio. It's the fastest way to see your entire fleet in one list.

## Prompt Examples

**Prompt:** 
```
What's the solar potential like in Nevada for a new project?
```

**Response:** 
```
I've pulled the Typical Meteorological Year (TMY) data for the Nevada region. Here is the summary:

| Metric | Average Value |
| :--- | :--- |
| **Annual Irradiance** | 1,950 kWh/m² |
| **Peak GHI** | 1,100 W/m² |
| **Consistency** | High |

The data shows very consistent production levels throughout the summer months, making it a prime candidate for large-scale array installation.
```

**Prompt:** 
```
Check the current irradiance for a site at 34.0522, -118.2437.
```

**Response:** 
```
I've retrieved the real-time solar data for those coordinates:

*   **Global Horizontal Irradiance (GHI):** 842 W/m²
*   **Direct Normal Irradiance (DNI):** 715 W/m²
*   **Ambient Temperature:** 24°C

The site is currently receiving strong direct sunlight.
```

**Prompt:** 
```
List all my registered solar sites.
```

**Response:** 
```
I've retrieved your SolarAnywhere site catalog. You have 4 registered sites:

1.  **Solar-West-Alpha** (CA)
2.  **Utility-One-Prime** (AZ)
3.  **Desert-Sun-04** (NV)
4.  **Valley-Farm-Beta** (CA)

Would you like me to pull the current irradiance for any of these specific locations?
```

## Capabilities

### Get real-time solar irradiance
Pull GHI and DNI data for any coordinate instantly.

### Retrieve long-term solar potential
Access Typical Meteorological Year data for project planning.

### Audit registered solar sites
See your entire portfolio of solar assets in one list.

### Check atmospheric metadata
Get temperature and irradiance details for performance analysis.

### Verify service status
Check if the SolarAnywhere API is currently operational.

## Use Cases

### Evaluating a new project site
A developer needs to know if a site in Napa Valley is viable. They ask the agent to show TMY data for the area, and it retrieves the long-term solar potential using get_typical_solar_year.

### Checking current farm conditions
An analyst needs to check the current conditions at a specific farm. They ask for real-time irradiance at specific coordinates, and the agent pulls the GHI and DNI data via get_solar_irradiance.

### Inventorying a regional fleet
An ops lead needs to see all active sites. They ask for a list of all registered sites, and the agent uses list_solar_sites to show the entire catalog.

### Deep-dive performance analysis
A researcher needs to know why a site is underperforming. They ask for temperature and irradiance metadata to perform a deep-dive performance classification.

## Benefits

- Stop manual data scraping by using get_solar_irradiance to pull real-time GHI and DNI data directly into your conversation.
- Plan projects faster with get_typical_solar_year, which provides the long-term TMY patterns you need for accurate energy modeling.
- Maintain a clear view of your portfolio by using list_solar_sites to see every registered asset in your account instantly.
- Improve performance analysis by using atmospheric metadata to get temperature and irradiance details for deeper site classification.
- Stay informed on system health by using check_api_status to verify that your data feed is always active and reliable.

## How It Works

The bottom line is you get a direct line to high-resolution solar data through a simple chat interface.

1. Connect your SolarAnywhere API key to the Connector via the Vinkius dashboard.
2. Ask your AI client to find specific irradiance data or site info.
3. Review the structured solar data and metadata provided in your chat.

## Frequently Asked Questions

**Can SolarAnywhere API help me find the best location for a new solar farm?**
Yes, it pulls TMY data which shows the long-term solar potential of a region. This helps you identify high-performing areas for new projects.

**Does SolarAnywhere API provide real-time data?**
Yes, it can fetch real-time GHI and DNI data for any specific coordinate, allowing you to see current solar conditions instantly.

**How do I see all my sites at once?**
You can ask your agent to list all your registered sites. It will pull your entire catalog from SolarAnywhere into a single, easy-to-read list.

**What is TMY data and why do I need it?**
TMY stands for Typical Meteorological Year. It provides a consistent set of weather data that helps you model how much energy a site will produce over a full year.

**Is SolarAnywhere API good for site auditing?**
Yes, it's designed for auditing. You can quickly check site metadata and regional distribution across your entire portfolio of solar assets.

**How do I find my SolarAnywhere API Key?**
Log in to your [**SolarAnywhere account**](https://api.solaranywhere.com/account), and you will find your API Key in your dashboard or profile settings. Copy and paste it below.

**What irradiance parameters are provided?**
The API provides Global Horizontal Irradiance (GHI), Direct Normal Irradiance (DNI), and Diffuse Horizontal Irradiance (DHI) metadata.

**Can the agent show historical typical year data?**
Yes. The `get_typical_solar_year` tool retrieves TMY data for any coordinate pair to assist in long-term performance auditing.