MCP server and REST API

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.

  • ChatGPT
  • Claude
  • Cursor
  • Codex
  • GitHub Copilot
  • Windsurf

Included in the Pro and Portfolio plans.

One prompt, five sites, one report

A real answer from Claude Code connected to Acrelume (shortened).

Screen these 5 sites for solar, rank them, save the best one to Acrelume and make a one-page PDF report: Buckeye AZ, Pahrump NV, Pecos County TX, Miami FL, Antelope Valley CA.

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.

RankSiteSun (GHI)Nearest lineFloodVerdict
1Buckeye AZ5.821.5 km, 238 kVOutside high-risk zonesGood
2Pahrump NV5.782.8 km, 138 kVOutside, high-risk zone 0.27 km awayGood
3Pecos County TX5.620.18 km, 138 kVOutside high-risk zonesGood
4Miami FL5.174.6 km, 138 kVInside FEMA zone AEPossible deal-breaker
5Antelope Valley CA5.8314.2 kmInside FEMA zone AOPossible 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_site

Screen 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_sites

Screen and rank sites

Up to 25 sites at once, ranked best first, so your agent can shortlist a pipeline.

save_site

Save a site

Saves a site to your Acrelume projects, so it shows up in Site Studio and your portfolio.

list_projects

List your projects

Your saved Site Studio projects with their verdicts. Free.

get_project

Read a project

Everything saved for one project: data, notes and the AI first read. Free.

create_report

Create a PDF report

A branded PDF site report for a saved project, returned as a link.

get_usage

Check 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
In ChatGPT, open Plugins and choose Add > Add custom MCP server. Name it Acrelume, use the URL 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)
In Claude, open Settings > Connectors > Add custom connector. Name it Acrelume and use the URL https://acrelume.com/mcp. Click Connect, sign in to Acrelume and click Allow. Then ask Claude about a site.
Claude Code
Run in a terminal:
claude mcp add --transport http acrelume https://acrelume.com/mcp --header "Authorization: Bearer YOUR_KEY"
Cursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
  "mcpServers": {
    "acrelume": {
      "url": "https://acrelume.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
Codex
Add to ~/.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
Add to .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
Add to ~/.codeium/windsurf/mcp_config.json:
{
  "mcpServers": {
    "acrelume": {
      "serverUrl": "https://acrelume.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}
REST API, for scripts
The same tools as plain HTTPS endpoints with JSON in and out:
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/screen one site, POST /api/v1/screen/batch up to 25 sites, ranked
  • GET /api/v1/projects, GET /api/v1/projects/<id>, POST /api/v1/projects to save a site
  • POST /api/v1/projects/<id>/report returns 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.