The AIEcoSense MCP server exposes real-time US environmental data to AI agents. It was built in response to the EPA's shutdown of EJScreen in February 2025 — ensuring that free, community-grade environmental intelligence remains publicly accessible.
Base URL
https://aiecosense.comMCP Server Spec
https://aiecosense.com/api/mcpProtocol
This server implements a REST-based MCP-compatible tool interface. Tools are invoked via standard HTTP GET/POST requests. The /api/mcp endpoint returns the full tool manifest in JSON Schema format, compatible with Claude's tool use system.
Get environmental data into your Claude agent in under 2 minutes.
Claude Code / Claude Desktop
Add the MCP server to your config
In your claude_desktop_config.json or Claude Code settings:
{
"mcpServers": {
"aieco-sense": {
"url": "https://aiecosense.com/api/mcp",
"description": "Real-time US environmental health data — air quality, pollution, weather alerts"
}
}
}Use it in a prompt
Ask Claude to check environmental conditions for any ZIP code:
// Example Claude prompt
"What's the air quality like in ZIP code 10027 (Harlem, NYC)?
Are there any active health alerts I should know about?
How does it compare to national AQI standards?"Claude calls the tool automatically
Claude will invoke get_environmental_report, receive the JSON payload, and synthesize a human-readable response including AI health analysis.
get_environmental_report tool already includes Claude AI analysis in the response. For maximum context efficiency, use get_air_quality (raw data only) and let your own Claude instance do the synthesis.
Direct HTTP / curl
# Quick air quality check
curl "https://aiecosense.com/api/quick?zip=10301"
# Full AI environmental report
curl "https://aiecosense.com/api/analyze?zip=10301"No authentication required. All endpoints are public.
User-Agent header when running automated agents (e.g. User-Agent: my-app/1.0 (contact@example.com)). Rate limiting may be applied to abusive traffic.
Returns raw real-time air quality metrics for a US ZIP code. Lightweight — no AI call, under 100ms.
Parameters
| Name | Type | Description |
|---|---|---|
| ziprequired | string | 5-digit US ZIP code (e.g. 10301) |
Example Response
{
"zip": "10301",
"location": { "city": "Staten Island", "state": "New York", "lat": 40.6316, "lon": -74.0927 },
"airQuality": {
"pm25": 8.3, // PM2.5 µg/m³
"pm10": 8.7, // PM10 µg/m³
"co": 195, // Carbon monoxide µg/m³
"no2": 25.3, // Nitrogen dioxide µg/m³
"ozone": 80, // Ozone µg/m³
"so2": 9.4, // Sulfur dioxide µg/m³
"usAqi": 49, // US EPA AQI (0-500)
"aqiCategory": "Good",
"aqiColor": "#00e400",
"riskLevel": "low"
},
"weather": {
"tempF": 60.6, "humidity": 39, "windMph": 10.4
},
"alerts": []
}Full AI-synthesized environmental health report. Includes all air quality data, NOAA weather alerts, industrial facility proximity, and a plain-English Claude AI health assessment.
| Name | Type | Description |
|---|---|---|
| ziprequired | string | 5-digit US ZIP code |
Additional Response Fields
Submit an AI-validated community environmental concern. Reports are AI-triaged by Claude and stored in the VoxTerrae research database.
| Name | Type | Description |
|---|---|---|
| ziprequired | string | 5-digit US ZIP code |
| reportTyperequired | enum | air_quality | water | industrial | noise | other |
| descriptionrequired | string | Description of the concern (max 1000 chars) |
| contactEmailoptional | string | Follow-up contact |
Example Request
curl -X POST https://aiecosense.com/api/report -H "Content-Type: application/json" -d '{
"zip": "10301",
"reportType": "air_quality",
"description": "Strong chemical smell near the port since this morning"
}'Test any endpoint directly from this page. Real requests, real data.
All endpoints return JSON with consistent structure. CORS headers are included on all responses.
application/json | CORS: Access-Control-Allow-Origin: *
AQI Categories
0–50Good — Air quality is satisfactory51–100Moderate — Acceptable, but some pollutants may affect sensitive groups101–150Unhealthy for Sensitive Groups151–200Unhealthy — Everyone may begin to experience effects201–300Very Unhealthy — Health alert301+Hazardous — Emergency conditionsAll data is sourced from public, authoritative, and open-license providers.
Air quality (PM2.5, PM10, NO2, Ozone, CO, SO2) + weather data. CC BY 4.0. No API key required.
Active weather and environmental alerts. US government public domain data.
Global air quality monitoring station network. CC BY 4.0.
Plain-English health analysis and community report validation via claude-sonnet-4-5.
Built for Environmental Justice
The EPA's EJScreen tool — the primary free environmental health resource for low-income and marginalized communities — was shut down by the Trump administration in February 2025. AIEcoSense was built within weeks to fill that gap. Free forever. No ads. No accounts. Powered by open data and Claude AI. Built by VPDLNY — Vulnerable Persons Defense League of New York.