Skip to main content
Glama

Get EJScreen Environmental Justice Indicators

epa_ejscreen_get_scores
Read-onlyIdempotent

EJScreen: 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 and their national averages. Data is EJAM's ACS 2018–2022 release of EJScreen (EJScreen 2.3 method), 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). When EJScreen has no indicators — the point is outside its US bounds, the buffer holds no Census block, or its blocks have no residents — coverage.valid is false and coverage.note says which, and whether a larger distance may help.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "latitude": "<latitude>",
      "longitude": "<longitude>"
    },
    "name": "epa_ejscreen_get_scores"
  }
}

Input Schema

NameRequiredDescriptionDefault
unitNoUnit for distance. Kilometers are converted to miles (× 0.621371) before the request.miles
distanceNoBuffer radius around the point, in the given unit (default 1). The miles-equivalent must be 15 or less.
latitudeYesLatitude in decimal degrees.
longitudeYesLongitude in decimal degrees.

Output Schema

NameRequiredDescriptionDefault
errorNoPresent when the call failed. Absent on success.
noticeNoThe coverage note as guidance, when no indicators were returned.
coverageNoWhether EJScreen had data for the buffer.
locationNoQueried point and buffer; state, stateName, population, and blockGroupCount are absent when the buffer holds no Census block.
reportUrlNoAbsolute URL of the full EJScreen report for this point and buffer.
dataSourceNoProvenance and vintage of the data.
demographicNoEmpty when coverage.valid is false.
environmentalNoEmpty when coverage.valid is false.
demographicIndexNoAbsent when coverage.valid is false.
supplementalDemographicIndexNoAbsent when coverage.valid is false.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed42 schema fields changed
    • changedOutput schema / properties / coverage / description
      Previous value: -"Whether EJScreen data was available for the buffer."New value: +"Whether EJScreen had data for the buffer."
    • changedOutput schema / properties / coverage / properties / note / description
      Previous value: -"Present when valid is false: what EJScreen found for the buffer, and whether a larger distance may reach data."New value: +"Present when valid is false: what EJScreen found, and whether a larger distance may reach data."
    • changedOutput schema / properties / coverage / properties / valid / description
      Previous value: -"True when EJScreen returned indicators for the buffer; false when it has none because the point is outside its US bounds, the buffer holds no Census block, or its blocks have no residents."New value: +"False when EJScreen has no indicators: the point is outside its US bounds, or the buffer holds no Census block or no residents."
    • changedOutput schema / properties / demographic / description
      Previous value: -"EJScreen demographic indicators present for the area. Empty when coverage.valid is false."New value: +"Empty when coverage.valid is false."
    • changedOutput schema / properties / demographic / items / description
      Previous value: -"One demographic indicator with percentiles."New value: +"One demographic indicator."
    • changedOutput schema / properties / demographic / items / properties / code / description
      Previous value: -"EJScreen demographic indicator code (e.g. \"pctmin\", \"pctlowinc\")."New value: +"EJScreen demographic indicator code."
    • changedOutput schema / properties / demographic / items / properties / label / description
      Previous value: -"Human-readable indicator name."New value: +"Indicator name."
    • changedOutput schema / properties / demographic / items / properties / percent / description
      Previous value: -"Share of the buffer population, as a percentage (0–100)."New value: +"Share of the buffer population, 0–100."
    • changedOutput schema / properties / demographic / items / properties / statePercentile / description
      Previous value: -"State percentile (0–100) for the share."New value: +"State percentile (0–100) of percent."
    • changedOutput schema / properties / demographic / items / properties / usPercentile / description
      Previous value: -"National percentile (0–100) for the share."New value: +"National percentile (0–100) of percent."
    • changedOutput schema / properties / demographicIndex / description
      Previous value: -"EJScreen Demographic Index. Absent when coverage.valid is false."New value: +"Absent when coverage.valid is false."
    • changedOutput schema / properties / demographicIndex / properties / statePercentile / description
      Previous value: -"State percentile (0–100) of the state-normalized Demographic Index, which is built from z-scores within the state rather than nationally."New value: +"State percentile (0–100) of the state-normalized index, built from z-scores within the state."
    • changedOutput schema / properties / demographicIndex / properties / usAverage / description
      Previous value: -"National average of the Demographic Index. Absent when EJScreen did not report it."New value: +"National average; absent when EJScreen omits it."
    • changedOutput schema / properties / demographicIndex / properties / usPercentile / description
      Previous value: -"National percentile (0–100) of the Demographic Index."New value: +"National percentile (0–100)."
    • changedOutput schema / properties / demographicIndex / properties / value / description
      Previous value: -"Demographic Index for the buffer: the mean of the national z-scores for percent low income and percent people of color, shifted so the lowest block group scores 0. Unitless; higher means more disadvantaged, and usAverage gives the national average to compare against."New value: +"Mean of the national z-scores for percent low income and percent people of color, shifted so the lowest block group scores 0. Unitless; higher is more disadvantaged."
    • changedOutput schema / properties / environmental / description
      Previous value: -"EJScreen environmental indicators present for the area. Empty when coverage.valid is false."New value: +"Empty when coverage.valid is false."
    • changedOutput schema / properties / environmental / items / description
      Previous value: -"One environmental indicator with percentiles and its EJ Index."New value: +"One environmental indicator."
    • changedOutput schema / properties / environmental / items / properties / code / description
      Previous value: -"EJScreen environmental indicator code (e.g. \"pm\", \"o3\", \"proximity.npl\")."New value: +"EJScreen environmental indicator code."
    • changedOutput schema / properties / environmental / items / properties / ejIndex / description
      Previous value: -"EJ Index: the Demographic Index × this indicator's US percentile, computed per block group and population-weighted over the buffer."New value: +"EJ Index: the Demographic Index × this indicator's US percentile, per block group, population-weighted over the buffer."
    • changedOutput schema / properties / environmental / items / properties / ejIndexStatePercentile / description
      Previous value: -"State percentile (0–100) of the EJ Index."New value: +"State percentile (0–100) of ejIndex."
    • changedOutput schema / properties / environmental / items / properties / ejIndexUsPercentile / description
      Previous value: -"National percentile (0–100) of the EJ Index."New value: +"National percentile (0–100) of ejIndex."
    • changedOutput schema / properties / environmental / items / properties / label / description
      Previous value: -"Human-readable indicator name."New value: +"Indicator name."
    • changedOutput schema / properties / environmental / items / properties / statePercentile / description
      Previous value: -"State percentile (0–100) for the raw value."New value: +"State percentile (0–100) of value."
    • changedOutput schema / properties / environmental / items / properties / unit / description
      Previous value: -"Unit or scale of the raw value."New value: +"Unit or scale of value."
    • changedOutput schema / properties / environmental / items / properties / usPercentile / description
      Previous value: -"National percentile (0–100) for the raw value."New value: +"National percentile (0–100) of value."
    • changedOutput schema / properties / environmental / items / properties / value / description
      Previous value: -"Raw indicator value, in the unit given by the unit field."New value: +"Raw value, in unit."
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `buffer_too_large`: The buffer radius exceeds the EJAM API cap of 15 miles (after converting kilometers to miles). `upstream_rejected`: The EJAM API answered HTTP 400 for a point inside the bounds it accepts, so the lookup failed at EJAM rather than on the coordinates. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `buffer_too_large`: The buffer exceeds the EJAM API's 15-mile cap (kilometers converted first). `upstream_rejected`: The EJAM API answered HTTP 400 for a point inside its accepted bounds, so the failure is at EJAM, not in the coordinates. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / location / description
      Previous value: -"The queried location and buffer context."New value: +"Queried point and buffer; state, stateName, population, and blockGroupCount are absent when the buffer holds no Census block."
    • changedOutput schema / properties / location / properties / blockGroupCount / description
      Previous value: -"Number of census block groups intersecting the buffer. Absent when EJScreen found no Census block for the buffer."New value: +"Census block groups intersecting the buffer."
    • changedOutput schema / properties / location / properties / bufferMiles / description
      Previous value: -"Buffer radius in miles used for the query (kilometers inputs converted first)."New value: +"Buffer radius in miles (kilometer input converted)."
    • changedOutput schema / properties / location / properties / latitude / description
      Previous value: -"Latitude of the queried point in decimal degrees."New value: +"Queried latitude, decimal degrees."
    • changedOutput schema / properties / location / properties / longitude / description
      Previous value: -"Longitude of the queried point in decimal degrees."New value: +"Queried longitude, decimal degrees."
    • changedOutput schema / properties / location / properties / population / description
      Previous value: -"Area-weighted population within the buffer; 0 when its blocks have no residents. Absent when EJScreen found no Census block for the buffer."New value: +"Area-weighted population in the buffer; 0 when its blocks have no residents."
    • changedOutput schema / properties / location / properties / state / description
      Previous value: -"2-letter state abbreviation for the area (e.g. \"MD\"). Absent when EJScreen found no Census block for the buffer."New value: +"2-letter state code."
    • changedOutput schema / properties / location / properties / stateName / description
      Previous value: -"Full state name (e.g. \"Maryland\"). Absent when EJScreen found no Census block for the buffer."New value: +"State name."
    • changedOutput schema / properties / notice / description
      Previous value: -"The coverage note, repeated as guidance, when no indicators were returned."New value: +"The coverage note as guidance, when no indicators were returned."
    • changedOutput schema / properties / reportUrl / description
      Previous value: -"Link (absolute URL) to the full EJScreen report for this point and buffer."New value: +"Absolute URL of the full EJScreen report for this point and buffer."
    • changedOutput schema / properties / supplementalDemographicIndex / description
      Previous value: -"EJScreen Supplemental Demographic Index. Absent when coverage.valid is false."New value: +"Absent when coverage.valid is false."
    • changedOutput schema / properties / supplementalDemographicIndex / properties / statePercentile / description
      Previous value: -"State percentile (0–100) of the state-normalized Supplemental Demographic Index, which is built from z-scores within the state rather than nationally."New value: +"State percentile (0–100) of the state-normalized index, built from z-scores within the state."
    • changedOutput schema / properties / supplementalDemographicIndex / properties / usAverage / description
      Previous value: -"National average of the Supplemental Demographic Index. Absent when EJScreen did not report it."New value: +"National average; absent when EJScreen omits it."
    • changedOutput schema / properties / supplementalDemographicIndex / properties / usPercentile / description
      Previous value: -"National percentile (0–100) of the Supplemental Demographic Index."New value: +"National percentile (0–100)."
    • changedOutput schema / properties / supplementalDemographicIndex / properties / value / description
      Previous value: -"Supplemental Demographic Index for the buffer: the mean of the national z-scores for percent low income, percent limited English, percent less than high school education, percent with disabilities, and low life expectancy (four components when life expectancy is missing), shifted so the lowest block group scores 0. Unitless; higher means more disadvantaged, and usAverage gives the national average to compare against."New value: +"Mean of the national z-scores for percent low income, limited English, less than high school education, and with disabilities, plus low life expectancy (four when it is missing), shifted so the lowest block group scores 0. Unitless; higher is more disadvantaged."
  2. Changed20 schema fields changed
    • changedOutput schema / properties / coverage / description
      Previous value: -"Whether EJScreen data was available for the point."New value: +"Whether EJScreen data was available for the buffer."
    • changedOutput schema / properties / coverage / properties / note / description
      Previous value: -"Explanation from EJScreen when coverage is unavailable (e.g. point outside the US)."New value: +"Present when valid is false: what EJScreen found for the buffer, and whether a larger distance may reach data."
    • changedOutput schema / properties / coverage / properties / valid / description
      Previous value: -"True when EJScreen returned indicators for the point; false when the point is outside coverage."New value: +"True when EJScreen returned indicators for the buffer; false when it has none because the point is outside its US bounds, the buffer holds no Census block, or its blocks have no residents."
    • changedOutput schema / properties / demographic / description
      Previous value: -"EJScreen demographic indicators present for the area. Empty when out of coverage."New value: +"EJScreen demographic indicators present for the area. Empty when coverage.valid is false."
    • changedOutput schema / properties / demographicIndex / description
      Previous value: -"EJScreen Demographic Index. Absent when out of coverage."New value: +"EJScreen Demographic Index. Absent when coverage.valid is false."
    • changedOutput schema / properties / demographicIndex / properties / statePercentile / description
      Previous value: -"State percentile (0–100) of the Demographic Index."New value: +"State percentile (0–100) of the state-normalized Demographic Index, which is built from z-scores within the state rather than nationally."
    • addedOutput schema / properties / demographicIndex / properties / usAverage
      Added value: +{
      +  "description": "National average of the Demographic Index. Absent when EJScreen did not report it.",
      +  "type": "number"
      +}
    • changedOutput schema / properties / demographicIndex / properties / value / description
      Previous value: -"Demographic Index raw value (average of low-income and people-of-color shares)."New value: +"Demographic Index for the buffer: the mean of the national z-scores for percent low income and percent people of color, shifted so the lowest block group scores 0. Unitless; higher means more disadvantaged, and usAverage gives the national average to compare against."
    • changedOutput schema / properties / environmental / description
      Previous value: -"EJScreen environmental indicators present for the area. Empty when out of coverage."New value: +"EJScreen environmental indicators present for the area. Empty when coverage.valid is false."
    • changedOutput schema / properties / environmental / items / properties / ejIndex / description
      Previous value: -"EJ Index (raw) — the indicator combined with the demographic index."New value: +"EJ Index: the Demographic Index × this indicator's US percentile, computed per block group and population-weighted over the buffer."
    • changedOutput schema / properties / error / properties / data / properties / reason / description
      Previous value: -"Machine-readable failure mode. Declared by this tool: `buffer_too_large`: The buffer radius exceeds the EJAM API cap of 15 miles (after converting kilometers to miles). `upstream_rejected`: The EJAM API rejected the request, typically for invalid coordinates. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `buffer_too_large`: The buffer radius exceeds the EJAM API cap of 15 miles (after converting kilometers to miles). `upstream_rejected`: The EJAM API answered HTTP 400 for a point inside the bounds it accepts, so the lookup failed at EJAM rather than on the coordinates. Other values are possible when a failure originates below the handler."
    • changedOutput schema / properties / location / properties / blockGroupCount / description
      Previous value: -"Number of census block groups intersecting the buffer. Absent when out of coverage."New value: +"Number of census block groups intersecting the buffer. Absent when EJScreen found no Census block for the buffer."
    • changedOutput schema / properties / location / properties / population / description
      Previous value: -"Area-weighted population within the buffer. Absent when out of coverage."New value: +"Area-weighted population within the buffer; 0 when its blocks have no residents. Absent when EJScreen found no Census block for the buffer."
    • changedOutput schema / properties / location / properties / state / description
      Previous value: -"2-letter state abbreviation for the area (e.g. \"MD\"). Absent when out of coverage."New value: +"2-letter state abbreviation for the area (e.g. \"MD\"). Absent when EJScreen found no Census block for the buffer."
    • changedOutput schema / properties / location / properties / stateName / description
      Previous value: -"Full state name (e.g. \"Maryland\"). Absent when out of coverage."New value: +"Full state name (e.g. \"Maryland\"). Absent when EJScreen found no Census block for the buffer."
    • changedOutput schema / properties / notice / description
      Previous value: -"Guidance when the point is outside EJScreen coverage and no indicators were returned."New value: +"The coverage note, repeated as guidance, when no indicators were returned."
    • changedOutput schema / properties / supplementalDemographicIndex / description
      Previous value: -"EJScreen Supplemental Demographic Index. Absent when out of coverage."New value: +"EJScreen Supplemental Demographic Index. Absent when coverage.valid is false."
    • changedOutput schema / properties / supplementalDemographicIndex / properties / statePercentile / description
      Previous value: -"State percentile (0–100) of the Supplemental Demographic Index."New value: +"State percentile (0–100) of the state-normalized Supplemental Demographic Index, which is built from z-scores within the state rather than nationally."
    • addedOutput schema / properties / supplementalDemographicIndex / properties / usAverage
      Added value: +{
      +  "description": "National average of the Supplemental Demographic Index. Absent when EJScreen did not report it.",
      +  "type": "number"
      +}
    • changedOutput schema / properties / supplementalDemographicIndex / properties / value / description
      Previous value: -"Supplemental Demographic Index raw value (five-factor average)."New value: +"Supplemental Demographic Index for the buffer: the mean of the national z-scores for percent low income, percent limited English, percent less than high school education, percent with disabilities, and low life expectancy (four components when life expectancy is missing), shifted so the lowest block group scores 0. Unitless; higher means more disadvantaged, and usAverage gives the national average to compare against."
  3. Added

TDQS

A4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, openWorld), yet the description adds substantial behavioral context they cannot carry: the data is EJAM's ACS 2018–2022 rehost of EJScreen 2.3 served from a community-maintained API after EPA discontinued public access, explicitly not a live EPA endpoint — a major reliability/vintage caveat. It also documents failure semantics precisely: coverage.valid goes false when the point is outside US bounds, the buffer contains no Census block, or blocks have no residents, with coverage.note identifying which and whether a larger distance may help. The only shortfall is that it doesn't characterize response size or latency for large buffers.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is front-loaded in the first clause, and the provenance caveat and failure conditions follow in a logical order. The long parenthetical list of indicators is dense but genuinely aids tool selection, so it earns its space; the description is still on the long side for a four-parameter tool and could compress the indicator inventory.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return values need not be explained, yet the description still covers the one thing the schema can't: what an empty/degraded result looks like and why. Combined with the data-vintage and endpoint-provenance disclosure, an agent has everything needed to call this correctly and interpret the outcome, including the 15-mile constraint.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the schema already spells out the unit conversion factor, the latitude/longitude ranges, and the 15-mile cap, so the structured data is doing the heavy lifting. The description restates the default 1 mile and max 15 miles without adding syntax or semantic detail beyond the schema, apart from a mild hint that a larger distance may improve coverage. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb and resource ("Get EJScreen environmental-justice indicators") and then enumerates exactly what is returned — 13 environmental indicators, 6 demographic indicators, national/state percentiles, EJ Index values, Demographic Index. That level of detail makes it unmistakable against the ECHO/Superfund/TRI siblings, which cover entirely different data domains.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is implied rather than stated: the description says to supply latitude, longitude, and a buffer (default 1 mile, max 15 miles), which tells the agent how to call it but not when to prefer it over alternatives. There are no exclusions and no routing to siblings, and no statement about when this tool is the wrong choice versus, say, a facility-level lookup.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.