# Solcast — how to use (mcp.ai)

Connect your Solcast account and use 6 tools for analytics straight from your AI agent. Connect with your own API key. Solar resource assessment and forecasting data for irradiance and PV power, globally.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_solcast?ms=1787291520000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `solcast_get_data_historic_radiation_and_weather`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/solcast`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/solcast/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/solcast/get/data/historic/radiation/and/weather` — Tool to get historical irradiance and weather estimated actuals for a requested location. Use when you need historical solar radiation and weather data from 2007-01-01 to 7 days ago, for up to 31 days
  - body: { end?: string, tilt?: number, start: string, format?: string, period?: string, azimuth?: number, duration?: string, latitude: number, longitude: number, time_zone?: string, array_type?: string, terrain_shading?: boolean, output_parameters?: string[] }
- `POST https://api.mcp.ai/api/solcast/get/resources/pv/power/site` — Tool to retrieve a specific PV power resource by its unique identifier. Use when you need to fetch complete resource configuration including capacity, orientation, tracking, and derating parameters.
  - body: { resource_id: string }
- `POST https://api.mcp.ai/api/solcast/get/resources/pv/power/sites` — Tool to list PV power resources available to authenticated user. Use when you need to retrieve the list of PV power sites with optional filtering by entitlement level.
  - body: { entitlement?: string }
- `POST https://api.mcp.ai/api/solcast/patch/resources/pv/power/site` — Tool to partially update an existing PV power resource's technical specifications. Use when you need to modify specific resource configuration fields without replacing the entire resource.
  - body: { name?: string, tilt?: number, azimuth?: number, capacity?: number, latitude?: number, longitude?: number, capacity_dc?: number, entitlement?: string, module_type?: string, pvrow_width?: number, resource_id: string, install_date?: string, pvrow_height?: number, terrain_slope?: number, tracking_type?: string, bifacial_system?: boolean, terrain_azimuth?: number, grid_export_limit?: number, bifaciality_factor?: number, confirmed_metadata?: string, site_ground_albedo?: number, derating_age_system?: number, derating_temp_module?: number, dust_soiling_average?: number[], tracker_axis_azimuth?: number, derating_other_system?: number, ground_coverage_ratio?: number, tracker_back_tracking?: boolean, tracker_smart_tracking?: boolean, inverter_peak_efficiency?: number, cloudy_zenith_coefficients?: number[], tracker_max_rotation_angle?: number, clearsky_zenith_coefficients?: number[] }
- `POST https://api.mcp.ai/api/solcast/post/resources/pv/power/site` — Tool to create a new PV power resource for Advanced PV Power forecasting. Use when you need to add a new solar installation site with comprehensive technical specifications including capacity, orienta
  - body: { name: string, tilt?: number, azimuth?: number, capacity: number, latitude: number, longitude: number, capacity_dc: number, entitlement?: string, module_type?: string, pvrow_width?: number, install_date: string, pvrow_height?: number, terrain_slope?: number, tracking_type: string, bifacial_system?: boolean, terrain_azimuth?: number, grid_export_limit?: number, bifaciality_factor?: number, confirmed_metadata?: string, site_ground_albedo?: number, derating_age_system?: number, derating_temp_module?: number, dust_soiling_average?: number[], tracker_axis_azimuth?: number, derating_other_system?: number, ground_coverage_ratio?: number, tracker_back_tracking?: boolean, tracker_smart_tracking?: boolean, inverter_peak_efficiency?: number, cloudy_zenith_coefficients?: number[], tracker_max_rotation_angle?: number, clearsky_zenith_coefficients?: number[] }
- `POST https://api.mcp.ai/api/solcast/put/resources/pv/power/site` — Tool to update an existing PV power resource with comprehensive technical specifications for solar installation site modeling. Use when you need to modify resource configuration including capacity, or
  - body: { name?: string, tilt?: number, azimuth?: number, capacity?: number, latitude?: number, longitude?: number, capacity_dc?: number, entitlement?: string, module_type?: string, pvrow_width?: number, resource_id: string, install_date?: string, pvrow_height?: number, terrain_slope?: number, tracking_type?: string, bifacial_system?: boolean, terrain_azimuth?: number, grid_export_limit?: number, bifaciality_factor?: number, confirmed_metadata?: string, site_ground_albedo?: number, derating_age_system?: number, derating_temp_module?: number, dust_soiling_average?: number[], tracker_axis_azimuth?: number, derating_other_system?: number, ground_coverage_ratio?: number, tracker_back_tracking?: boolean, tracker_smart_tracking?: boolean, inverter_peak_efficiency?: number, cloudy_zenith_coefficients?: number[], tracker_max_rotation_angle?: number, clearsky_zenith_coefficients?: number[] }

## Example prompts
- "What can I do in Solcast?"
- "Show me a summary of my Solcast account"

## More
- Page: https://mcp.ai/solcast
- Agent spec (llms.txt): https://mcp.ai/solcast/llms.txt
- Postman collection: https://mcp.ai/solcast/postman.json