@cyanheads/epa-mcp-server 0.2.1 → 0.3.1

package/dist/config/server-config.d.ts

@@ -8,6 +8,7 @@ declare const ServerConfigSchema: z.ZodObject<{
     echoBaseUrl: z.ZodDefault<z.ZodString>;
     dmapBaseUrl: z.ZodDefault<z.ZodString>;
     airNowBaseUrl: z.ZodDefault<z.ZodString>;
+    ejscreenBaseUrl: z.ZodPreprocess<z.ZodDefault<z.ZodString>>;
 }, z.core.$strip>;
 export type ServerConfig = z.infer<typeof ServerConfigSchema>;
 export declare function getServerConfig(): ServerConfig;

package/dist/config/server-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;;;iBA2BtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAQ9C"}
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;;;;iBAoCtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAS9C"}

package/dist/config/server-config.js

@@ -26,6 +26,12 @@ const ServerConfigSchema = z.object({
         .url()
         .default('https://www.airnowapi.org/aq')
         .describe('AirNow API base URL'),
+    // Optional override. Bundle/compose configs may inject an unfilled
+    // `${EJSCREEN_API_BASE_URL}` placeholder as an empty string — treat empty or
+    // whitespace-only as absent so the default applies instead of failing `.url()`.
+    ejscreenBaseUrl: z
+        .preprocess((v) => (typeof v === 'string' && v.trim() === '' ? undefined : v), z.string().url().default('https://api.ejanalysis.com'))
+        .describe('EJScreen (EJAM) API base URL — the community-maintained EJScreen rehost'),
 });
 let _config;
 export function getServerConfig() {
@@ -34,6 +40,7 @@ export function getServerConfig() {
         echoBaseUrl: 'EPA_ECHO_BASE_URL',
         dmapBaseUrl: 'EPA_DMAP_BASE_URL',
         airNowBaseUrl: 'EPA_AIRNOW_BASE_URL',
+        ejscreenBaseUrl: 'EJSCREEN_API_BASE_URL',
     });
     return _config;
 }

package/dist/config/server-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,oFAAoF;IACpF,qFAAqF;IACrF,uFAAuF;IACvF,YAAY,EAAE,CAAC;SACZ,UAAU,CACT,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EACjE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAC7B;SACA,QAAQ,CACP,4JAA4J,CAC7J;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,+BAA+B,CAAC;SACxC,QAAQ,CAAC,mBAAmB,CAAC;IAChC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,kCAAkC,CAAC;SAC3C,QAAQ,CAAC,mBAAmB,CAAC;IAChC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,8BAA8B,CAAC;SACvC,QAAQ,CAAC,qBAAqB,CAAC;CACnC,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,mBAAmB;QAChC,aAAa,EAAE,qBAAqB;KACrC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,oFAAoF;IACpF,qFAAqF;IACrF,uFAAuF;IACvF,YAAY,EAAE,CAAC;SACZ,UAAU,CACT,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EACjE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAC7B;SACA,QAAQ,CACP,4JAA4J,CAC7J;IACH,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,+BAA+B,CAAC;SACxC,QAAQ,CAAC,mBAAmB,CAAC;IAChC,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,kCAAkC,CAAC;SAC3C,QAAQ,CAAC,mBAAmB,CAAC;IAChC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,8BAA8B,CAAC;SACvC,QAAQ,CAAC,qBAAqB,CAAC;IAClC,mEAAmE;IACnE,6EAA6E;IAC7E,gFAAgF;IAChF,eAAe,EAAE,CAAC;SACf,UAAU,CACT,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EACjE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,4BAA4B,CAAC,CACvD;SACA,QAAQ,CAAC,yEAAyE,CAAC;CACvF,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,mBAAmB;QAChC,aAAa,EAAE,qBAAqB;QACpC,eAAe,EAAE,uBAAuB;KACzC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.js

@@ -10,21 +10,23 @@ import { allToolDefinitions, coreToolDefinitions } from './mcp-server/tools/defi
 import { initAirNowService } from './services/airnow/airnow-service.js';
 import { initDmapService } from './services/dmap/dmap-service.js';
 import { initEchoService } from './services/echo/echo-service.js';
+import { initEjscreenService } from './services/ejscreen/ejscreen-service.js';
 // AirNow is the only key-gated service. When AIRNOW_API_KEY is absent the server
-// starts without epa_get_air_quality, leaving the 7 keyless tools available.
+// starts without epa_get_air_quality, leaving the 8 keyless tools available.
 const airNowEnabled = getServerConfig().airNowApiKey !== undefined;
 /** Server instructions, omitting AirNow guidance when the air quality tool is disabled. */
 function buildInstructions() {
     const lines = [
-        `EPA environmental data server covering facility compliance (ECHO), toxic releases (TRI), Superfund sites, drinking water systems (SDWIS)${airNowEnabled ? ', and real-time air quality (AirNow)' : ''}.`,
-        '- All tools are read-only. All APIs are US federal government public domain data.',
+        `EPA environmental data server covering facility compliance (ECHO), toxic releases (TRI), Superfund sites, drinking water systems (SDWIS), environmental-justice screening (EJScreen)${airNowEnabled ? ', and real-time air quality (AirNow)' : ''}.`,
+        '- All tools are read-only. Most APIs are US federal government public domain data.',
         '- ECHO tools require at least one geographic filter (zip_code, state, or city) — unscoped searches time out. epa_search_facilities also accepts latitude + longitude + radius_miles for proximity search.',
         '- TRI data lags ~18 months — most recent available year is typically 2 years prior to current.',
+        '- epa_get_ejscreen serves EJScreen v2.2 (2022) via the community-maintained EJAM API (Public Environmental Data Partners), which rehosts EJScreen after EPA discontinued public access in 2025 — not a live EPA endpoint; US coverage only.',
     ];
     if (airNowEnabled) {
         lines.push('- AirNow data is preliminary and not valid for regulatory, trend, or enforcement purposes.');
     }
-    lines.push('- Typical workflows: epa_search_facilities → epa_get_facility → epa_search_violations (compliance audit); epa_search_superfund (proximity); epa_search_water_systems + has_violation=true (drinking water safety).');
+    lines.push('- Typical workflows: epa_search_facilities → epa_get_facility → epa_search_violations (compliance audit); epa_search_superfund (proximity); epa_search_water_systems + has_violation=true (drinking water safety); epa_get_ejscreen (environmental-justice indicators for a point + buffer).');
     return lines.join('\n');
 }
 await createApp({
@@ -37,6 +39,7 @@ await createApp({
     setup(core) {
         initEchoService(core.config, core.storage);
         initDmapService(core.config, core.storage);
+        initEjscreenService(core.config, core.storage);
         if (airNowEnabled)
             initAirNowService(core.config, core.storage);
     },

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,iFAAiF;AACjF,6EAA6E;AAC7E,MAAM,aAAa,GAAG,eAAe,EAAE,CAAC,YAAY,KAAK,SAAS,CAAC;AAEnE,2FAA2F;AAC3F,SAAS,iBAAiB;IACxB,MAAM,KAAK,GAAG;QACZ,2IAA2I,aAAa,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,EAAE,GAAG;QACzM,mFAAmF;QACnF,2MAA2M;QAC3M,gGAAgG;KACjG,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CACR,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CACR,oNAAoN,CACrN,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,gBAAgB;IACvB,KAAK,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACtE,SAAS,EAAE,CAAC,GAAG,sBAAsB,CAAC;IACtC,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,iBAAiB,EAAE;IACjC,KAAK,CAAC,IAAI;QACR,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,aAAa;YAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAE9E,iFAAiF;AACjF,6EAA6E;AAC7E,MAAM,aAAa,GAAG,eAAe,EAAE,CAAC,YAAY,KAAK,SAAS,CAAC;AAEnE,2FAA2F;AAC3F,SAAS,iBAAiB;IACxB,MAAM,KAAK,GAAG;QACZ,uLAAuL,aAAa,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,EAAE,GAAG;QACrP,oFAAoF;QACpF,2MAA2M;QAC3M,gGAAgG;QAChG,6OAA6O;KAC9O,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CACR,4FAA4F,CAC7F,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CACR,8RAA8R,CAC/R,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,gBAAgB;IACvB,KAAK,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC;IACtE,SAAS,EAAE,CAAC,GAAG,sBAAsB,CAAC;IACtC,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,iBAAiB,EAAE;IACjC,KAAK,CAAC,IAAI;QACR,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,aAAa;YAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/get-ejscreen.tool.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Tool for retrieving EJScreen environmental-justice indicators for a
+ * point + buffer, backed by the community-maintained EJAM API.
+ * @module mcp-server/tools/definitions/get-ejscreen.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getEjscreenTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    distance: z.ZodDefault<z.ZodNumber>;
+    unit: z.ZodDefault<z.ZodEnum<{
+        kilometers: "kilometers";
+        miles: "miles";
+    }>>;
+}, z.core.$strip>, z.ZodObject<{
+    location: z.ZodObject<{
+        latitude: z.ZodNumber;
+        longitude: z.ZodNumber;
+        bufferMiles: z.ZodNumber;
+        state: z.ZodOptional<z.ZodString>;
+        stateName: z.ZodOptional<z.ZodString>;
+        population: z.ZodOptional<z.ZodNumber>;
+        blockGroupCount: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    environmental: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        value: z.ZodNumber;
+        unit: z.ZodOptional<z.ZodString>;
+        usPercentile: z.ZodOptional<z.ZodNumber>;
+        statePercentile: z.ZodOptional<z.ZodNumber>;
+        ejIndex: z.ZodOptional<z.ZodNumber>;
+        ejIndexUsPercentile: z.ZodOptional<z.ZodNumber>;
+        ejIndexStatePercentile: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    demographic: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        label: z.ZodString;
+        percent: z.ZodNumber;
+        usPercentile: z.ZodOptional<z.ZodNumber>;
+        statePercentile: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    demographicIndex: z.ZodOptional<z.ZodObject<{
+        value: z.ZodNumber;
+        usPercentile: z.ZodOptional<z.ZodNumber>;
+        statePercentile: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    supplementalDemographicIndex: z.ZodOptional<z.ZodObject<{
+        value: z.ZodNumber;
+        usPercentile: z.ZodOptional<z.ZodNumber>;
+        statePercentile: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    reportUrl: z.ZodOptional<z.ZodString>;
+    coverage: z.ZodObject<{
+        valid: z.ZodBoolean;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    dataSource: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "buffer_too_large";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "The buffer radius exceeds the EJAM API cap of 15 miles (after converting kilometers to miles).";
+    readonly recovery: "Reduce distance so the miles-equivalent is 15 or less (about 24 km) and retry.";
+}, {
+    readonly reason: "upstream_rejected";
+    readonly code: JsonRpcErrorCode.ValidationError;
+    readonly when: "The EJAM API rejected the request, typically for invalid coordinates.";
+    readonly recovery: "Check that latitude and longitude are valid decimal-degree US coordinates and retry.";
+}], {
+    readonly notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=get-ejscreen.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-ejscreen.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ejscreen.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ejscreen.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAQjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+S1B,CAAC"}

package/dist/mcp-server/tools/definitions/get-ejscreen.tool.js

@@ -0,0 +1,273 @@
+/**
+ * @fileoverview Tool for retrieving EJScreen environmental-justice indicators for a
+ * point + buffer, backed by the community-maintained EJAM API.
+ * @module mcp-server/tools/definitions/get-ejscreen.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getEjscreenService } from '../../../services/ejscreen/ejscreen-service.js';
+/** Miles-per-kilometer conversion factor. */
+const MILES_PER_KM = 0.621371;
+/** The EJAM API caps the buffer at 15 miles. */
+const MAX_BUFFER_MILES = 15;
+export const getEjscreenTool = tool('epa_get_ejscreen', {
+    title: 'Get EJScreen Environmental Justice Indicators',
+    description: 'Get EJScreen environmental-justice indicators for a point and surrounding buffer. Returns the 13 EJScreen environmental indicators (PM2.5, ozone, diesel particulate, NO2, lead paint, traffic proximity, Superfund/RMP/hazardous-waste/wastewater proximity, underground storage tanks, drinking-water non-compliance, and RSEI toxic air releases) and 6 demographic indicators (people of color, low income, limited English, less than high school, under 5, over 64), each with national and state percentiles plus EJ Index values, along with the Demographic Index and Supplemental Demographic Index. Data is EJScreen v2.2 (2022) served via the community-maintained EJAM API (api.ejanalysis.com, Public Environmental Data Partners), which rehosts EJScreen after EPA discontinued public access in 2025 — not a live EPA endpoint. Provide latitude, longitude, and a buffer distance (default 1 mile, max 15 miles). Points outside US coverage return a coverage note instead of indicators.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        latitude: z.number().min(-90).max(90).describe('Latitude in decimal degrees.'),
+        longitude: z.number().min(-180).max(180).describe('Longitude in decimal degrees.'),
+        distance: z
+            .number()
+            .positive()
+            .default(1)
+            .describe('Buffer radius around the point, in the given unit (default 1). The miles-equivalent must be 15 or less.'),
+        unit: z
+            .enum(['miles', 'kilometers'])
+            .default('miles')
+            .describe('Unit for distance. Kilometers are converted to miles (× 0.621371) before the request.'),
+    }),
+    output: z.object({
+        location: z
+            .object({
+            latitude: z.number().describe('Latitude of the queried point in decimal degrees.'),
+            longitude: z.number().describe('Longitude of the queried point in decimal degrees.'),
+            bufferMiles: z
+                .number()
+                .describe('Buffer radius in miles used for the query (kilometers inputs converted first).'),
+            state: z
+                .string()
+                .optional()
+                .describe('2-letter state abbreviation for the area (e.g. "MD"). Absent when out of coverage.'),
+            stateName: z
+                .string()
+                .optional()
+                .describe('Full state name (e.g. "Maryland"). Absent when out of coverage.'),
+            population: z
+                .number()
+                .optional()
+                .describe('Area-weighted population within the buffer. Absent when out of coverage.'),
+            blockGroupCount: z
+                .number()
+                .optional()
+                .describe('Number of census block groups intersecting the buffer. Absent when out of coverage.'),
+        })
+            .describe('The queried location and buffer context.'),
+        environmental: z
+            .array(z
+            .object({
+            code: z
+                .string()
+                .describe('EJScreen environmental indicator code (e.g. "pm", "o3", "proximity.npl").'),
+            label: z.string().describe('Human-readable indicator name.'),
+            value: z.number().describe('Raw indicator value, in the unit given by the unit field.'),
+            unit: z.string().optional().describe('Unit or scale of the raw value.'),
+            usPercentile: z
+                .number()
+                .optional()
+                .describe('National percentile (0–100) for the raw value.'),
+            statePercentile: z
+                .number()
+                .optional()
+                .describe('State percentile (0–100) for the raw value.'),
+            ejIndex: z
+                .number()
+                .optional()
+                .describe('EJ Index (raw) — the indicator combined with the demographic index.'),
+            ejIndexUsPercentile: z
+                .number()
+                .optional()
+                .describe('National percentile (0–100) of the EJ Index.'),
+            ejIndexStatePercentile: z
+                .number()
+                .optional()
+                .describe('State percentile (0–100) of the EJ Index.'),
+        })
+            .describe('One environmental indicator with percentiles and its EJ Index.'))
+            .describe('EJScreen environmental indicators present for the area. Empty when out of coverage.'),
+        demographic: z
+            .array(z
+            .object({
+            code: z
+                .string()
+                .describe('EJScreen demographic indicator code (e.g. "pctmin", "pctlowinc").'),
+            label: z.string().describe('Human-readable indicator name.'),
+            percent: z
+                .number()
+                .describe('Share of the buffer population, as a percentage (0–100).'),
+            usPercentile: z
+                .number()
+                .optional()
+                .describe('National percentile (0–100) for the share.'),
+            statePercentile: z
+                .number()
+                .optional()
+                .describe('State percentile (0–100) for the share.'),
+        })
+            .describe('One demographic indicator with percentiles.'))
+            .describe('EJScreen demographic indicators present for the area. Empty when out of coverage.'),
+        demographicIndex: z
+            .object({
+            value: z
+                .number()
+                .describe('Demographic Index raw value (average of low-income and people-of-color shares).'),
+            usPercentile: z
+                .number()
+                .optional()
+                .describe('National percentile (0–100) of the Demographic Index.'),
+            statePercentile: z
+                .number()
+                .optional()
+                .describe('State percentile (0–100) of the Demographic Index.'),
+        })
+            .optional()
+            .describe('EJScreen Demographic Index. Absent when out of coverage.'),
+        supplementalDemographicIndex: z
+            .object({
+            value: z
+                .number()
+                .describe('Supplemental Demographic Index raw value (five-factor average).'),
+            usPercentile: z
+                .number()
+                .optional()
+                .describe('National percentile (0–100) of the Supplemental Demographic Index.'),
+            statePercentile: z
+                .number()
+                .optional()
+                .describe('State percentile (0–100) of the Supplemental Demographic Index.'),
+        })
+            .optional()
+            .describe('EJScreen Supplemental Demographic Index. Absent when out of coverage.'),
+        reportUrl: z
+            .string()
+            .optional()
+            .describe('Link (absolute URL) to the full EJScreen report for this point and buffer.'),
+        coverage: z
+            .object({
+            valid: z
+                .boolean()
+                .describe('True when EJScreen returned indicators for the point; false when the point is outside coverage.'),
+            note: z
+                .string()
+                .optional()
+                .describe('Explanation from EJScreen when coverage is unavailable (e.g. point outside the US).'),
+        })
+            .describe('Whether EJScreen data was available for the point.'),
+        dataSource: z.string().describe('Provenance and vintage of the data.'),
+    }),
+    enrichment: {
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance when the point is outside EJScreen coverage and no indicators were returned.'),
+    },
+    errors: [
+        {
+            reason: 'buffer_too_large',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'The buffer radius exceeds the EJAM API cap of 15 miles (after converting kilometers to miles).',
+            recovery: 'Reduce distance so the miles-equivalent is 15 or less (about 24 km) and retry.',
+        },
+        {
+            reason: 'upstream_rejected',
+            code: JsonRpcErrorCode.ValidationError,
+            when: 'The EJAM API rejected the request, typically for invalid coordinates.',
+            recovery: 'Check that latitude and longitude are valid decimal-degree US coordinates and retry.',
+        },
+    ],
+    async handler(input, ctx) {
+        const bufferMiles = input.unit === 'kilometers' ? input.distance * MILES_PER_KM : input.distance;
+        if (bufferMiles > MAX_BUFFER_MILES) {
+            throw ctx.fail('buffer_too_large', `Buffer of ${bufferMiles.toFixed(2)} miles exceeds the EJAM API limit of ${MAX_BUFFER_MILES} miles.`, { ...ctx.recoveryFor('buffer_too_large') });
+        }
+        ctx.log.info('epa_get_ejscreen', {
+            lat: input.latitude,
+            lon: input.longitude,
+            bufferMiles,
+        });
+        const result = await getEjscreenService().getIndicators({ latitude: input.latitude, longitude: input.longitude, bufferMiles }, ctx);
+        ctx.log.info('epa_get_ejscreen completed', {
+            valid: result.coverage.valid,
+            environmental: result.environmental.length,
+            demographic: result.demographic.length,
+        });
+        if (!result.coverage.valid) {
+            ctx.enrich.notice(result.coverage.note
+                ? `EJScreen has no coverage for this point: ${result.coverage.note}`
+                : `EJScreen returned no indicators for lat=${input.latitude}, lon=${input.longitude}. EJScreen covers US locations only — verify the point is within the United States.`);
+        }
+        return result;
+    },
+    format: (result) => {
+        const lines = [];
+        const loc = result.location;
+        const place = loc.stateName ?? loc.state;
+        lines.push(`## EJScreen Environmental Justice — ${loc.latitude}, ${loc.longitude}${place ? ` (${place})` : ''}`);
+        lines.push(`**Buffer:** ${loc.bufferMiles} miles`);
+        if (loc.state)
+            lines.push(`**State:** ${loc.state}`);
+        if (loc.stateName)
+            lines.push(`**State name:** ${loc.stateName}`);
+        if (loc.population !== undefined)
+            lines.push(`**Population in buffer:** ${loc.population}`);
+        if (loc.blockGroupCount !== undefined) {
+            lines.push(`**Block groups intersected:** ${loc.blockGroupCount}`);
+        }
+        lines.push(`**Coverage valid:** ${result.coverage.valid ? 'yes' : 'no'}`);
+        if (result.coverage.note)
+            lines.push(`> ${result.coverage.note}`);
+        if (result.environmental.length > 0) {
+            lines.push('\n### Environmental indicators');
+            for (const e of result.environmental) {
+                const parts = [`**${e.label}** (\`${e.code}\`): ${e.value}${e.unit ? ` ${e.unit}` : ''}`];
+                if (e.usPercentile !== undefined)
+                    parts.push(`US pctile ${e.usPercentile}`);
+                if (e.statePercentile !== undefined)
+                    parts.push(`state pctile ${e.statePercentile}`);
+                if (e.ejIndex !== undefined)
+                    parts.push(`EJ Index ${e.ejIndex}`);
+                if (e.ejIndexUsPercentile !== undefined) {
+                    parts.push(`EJ Index US pctile ${e.ejIndexUsPercentile}`);
+                }
+                if (e.ejIndexStatePercentile !== undefined) {
+                    parts.push(`EJ Index state pctile ${e.ejIndexStatePercentile}`);
+                }
+                lines.push(`- ${parts.join(' · ')}`);
+            }
+        }
+        if (result.demographic.length > 0) {
+            lines.push('\n### Demographic indicators');
+            for (const d of result.demographic) {
+                const parts = [`**${d.label}** (\`${d.code}\`): ${d.percent}%`];
+                if (d.usPercentile !== undefined)
+                    parts.push(`US pctile ${d.usPercentile}`);
+                if (d.statePercentile !== undefined)
+                    parts.push(`state pctile ${d.statePercentile}`);
+                lines.push(`- ${parts.join(' · ')}`);
+            }
+        }
+        if (result.demographicIndex) {
+            const di = result.demographicIndex;
+            const parts = [`**Demographic Index:** ${di.value}`];
+            if (di.usPercentile !== undefined)
+                parts.push(`US pctile ${di.usPercentile}`);
+            if (di.statePercentile !== undefined)
+                parts.push(`state pctile ${di.statePercentile}`);
+            lines.push(`\n${parts.join(' · ')}`);
+        }
+        if (result.supplementalDemographicIndex) {
+            const si = result.supplementalDemographicIndex;
+            const parts = [`**Supplemental Demographic Index:** ${si.value}`];
+            if (si.usPercentile !== undefined)
+                parts.push(`US pctile ${si.usPercentile}`);
+            if (si.statePercentile !== undefined)
+                parts.push(`state pctile ${si.statePercentile}`);
+            lines.push(parts.join(' · '));
+        }
+        if (result.reportUrl)
+            lines.push(`\n**EJScreen report:** ${result.reportUrl}`);
+        lines.push(`\n_Source: ${result.dataSource}_`);
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-ejscreen.tool.js.map

package/dist/mcp-server/tools/definitions/get-ejscreen.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-ejscreen.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-ejscreen.tool.ts"],"names":[],"mappings":"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"}