Everything you see in Acrelume, your AI agent can do too
Connect Acrelume to ChatGPT, Claude, Cursor, Codex or your own code. Your agent screens US sites for solar resource, grid distance, FEMA flood risk, wetlands, land cover, protected land, slope, prime farmland, the nearest substation, the county's interconnection queue and the electric utility, ranks them, saves the best to your projects and makes a PDF report. It uses the same data and the same verdict as Site Studio.
Included in the Pro and Portfolio plans.
One prompt, five sites, one report
A real answer from Claude Code connected to Acrelume (shortened).
Buckeye, AZ is the best site. It's the only one with strong sun, a nearby high-voltage line and a clear margin from flood zones all at once.
| Rank | Site | Sun (GHI) | Nearest line | Flood | Verdict |
|---|---|---|---|---|---|
| 1 | Buckeye AZ | 5.82 | 1.5 km, 238 kV | Outside high-risk zones | Good |
| 2 | Pahrump NV | 5.78 | 2.8 km, 138 kV | Outside, high-risk zone 0.27 km away | Good |
| 3 | Pecos County TX | 5.62 | 0.18 km, 138 kV | Outside high-risk zones | Good |
| 4 | Miami FL | 5.17 | 4.6 km, 138 kV | Inside FEMA zone AE | Possible deal-breaker |
| 5 | Antelope Valley CA | 5.83 | 14.2 km | Inside FEMA zone AO | Possible deal-breaker |
Saved Buckeye AZ to your Acrelume projects and created a one-page PDF site report. This is a first screen: confirm line capacity with the utility and get a flood survey of the site.
This answer is from October 2026. The verdict now counts the checks, for example “No red flags · 2 to look at · 9 clear” or “1 red flag · 1 to look at · 9 clear” (a red flag is a possible deal-breaker), and your agent can say what the site is for: ground-mount or rooftop solar, battery storage, a data center, an EV fleet or truck charging hub, or land for a solar lease.
What your agent can do
Seven tools, the same as in the app.
screen_siteScreen a site
Solar resource, nearest transmission line (distance and voltage), FEMA flood zone, wetlands, land cover, protected land, slope, prime farmland, nearest substation, county interconnection queue and electric utility, with a verdict about the checks (red flags, things to look at, clear) for one US location and use case (ground-mount or rooftop solar, battery storage, data center, EV charging hub, land for a solar lease).
screen_sitesScreen and rank sites
Up to 25 sites at once, ranked best first, so your agent can shortlist a pipeline.
save_siteSave a site
Saves a site to your Acrelume projects, so it shows up in Site Studio and your portfolio.
list_projectsList your projects
Your saved Site Studio projects with their verdicts. Free.
get_projectRead a project
Everything saved for one project: data, notes and the AI first read. Free.
create_reportCreate a PDF report
A branded PDF site report for a saved project, returned as a link.
get_usageCheck usage
This month's screenings and reports used and included. Free.
How to connect
ChatGPT and Claude: add the server URL and sign in with your Acrelume account. No key needed.
Coding tools and scripts: create an API key under Account > API & AI agents and keep it private, like a password.
MCP server URL: https://acrelume.com/mcp. With a key, send the header Authorization: Bearer YOUR_KEY. Pro and Portfolio plans.
ChatGPT
https://acrelume.com/mcp and set Authentication to OAuth (leave the advanced settings as they are). Click Create as a plugin, sign in to Acrelume and click Allow. Then turn Acrelume on in a chat and ask about a site.Claude (claude.ai and Claude Desktop)
https://acrelume.com/mcp. Click Connect, sign in to Acrelume and click Allow. Then ask Claude about a site.Claude Code
claude mcp add --transport http acrelume https://acrelume.com/mcp --header "Authorization: Bearer YOUR_KEY"
Cursor
~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"acrelume": {
"url": "https://acrelume.com/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}Codex
~/.codex/config.toml and set ACRELUME_API_KEY in your environment:
[mcp_servers.acrelume] url = "https://acrelume.com/mcp" bearer_token_env_var = "ACRELUME_API_KEY"
GitHub Copilot in VS Code
.vscode/mcp.json. VS Code asks for the key once and stores it securely:
{
"inputs": [{ "type": "promptString", "id": "acrelume-key", "description": "Acrelume API key", "password": true }],
"servers": {
"acrelume": {
"type": "http",
"url": "https://acrelume.com/mcp",
"headers": { "Authorization": "Bearer ${input:acrelume-key}" }
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"acrelume": {
"serverUrl": "https://acrelume.com/mcp",
"headers": { "Authorization": "Bearer YOUR_KEY" }
}
}
}REST API, for scripts
curl -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
-d '{"lat": 33.351, "lng": -112.75}' https://acrelume.com/api/v1/screen
POST /api/v1/screenone site,POST /api/v1/screen/batchup to 25 sites, rankedGET /api/v1/projects,GET /api/v1/projects/<id>,POST /api/v1/projectsto save a sitePOST /api/v1/projects/<id>/reportreturns a link to the PDF;GET /api/v1/usage- Full tool list with input schemas: https://acrelume.com/api/v1/tools
Included in your plan
Listing and reading your saved projects is always free. Screening or saving a site uses one screening; a PDF report uses one report.
Pro
50 site screenings and 10 PDF reports per month
Portfolio
500 site screenings and 50 PDF reports per month
Agent access is for paid plans and is not part of the free trial. Need more? Extra screenings at $0.50 each are coming soon; until then, contact us.
Questions
Does Acrelume have an MCP server?
Yes. The Acrelume MCP server is at https://acrelume.com/mcp (Streamable HTTP). ChatGPT and Claude connect with "Sign in with Acrelume" (OAuth), no key needed. Claude Code, Cursor, Codex, GitHub Copilot, Windsurf and other MCP clients connect with an API key. There is also a REST API at https://acrelume.com/api/v1.
What can an AI agent do with Acrelume?
Screen US sites for solar resource (NREL), distance and voltage of the nearest transmission line (HIFLD), FEMA high-risk flood zones, wetlands (USFWS NWI), land cover (USGS Annual NLCD), protected land and critical habitat (USGS PAD-US, USFWS), slope (USGS 3DEP), prime farmland (USDA soils), nearest substation (OpenStreetMap), the county's transmission interconnection queue (LBNL) and the electric utility, rank up to 25 sites at once, save sites to your projects, read your saved projects and create PDF site reports.
How much does it cost?
It is included in the paid plans: Pro includes 50 screenings and 10 PDF reports per month, Portfolio 500 screenings and 50 reports. Listing and reading saved projects is free. Agent access is not part of the free trial.
Can my agent see other people's projects?
No. A connected app or API key only works for its own account: your agent sees and saves your projects only. You can disconnect an app or revoke a key at any time under Account > API & AI agents, and it stops working right away.
Does it work outside the US?
Solar resource works worldwide (NREL in the Americas, PVGIS elsewhere). Transmission lines, FEMA flood zones and the land and grid checks are US data, so outside the US those checks are marked unavailable rather than guessed.
Is the screening a substitute for a utility or flood study?
No. It is a fast first screen to decide which sites deserve a closer look. It does not check hosting capacity, zoning or parcels. Confirm line capacity with the utility and get a wetland delineation and a flood survey before you commit to a site.