Skip to main content
Glama

Epa Emissions

by io.github.pipeworx-io
OverviewDiscussionsAdmin

Tri Chemical Releases

tri_chemical_releases
Read-onlyIdempotent

Track toxic chemical releases by chemical name and state. Returns quantities released to air, water, and land broken down by year.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMax results (default 20, max 100).
stateNoTwo-letter state abbreviation to filter by (optional).
chemicalYesChemical name (e.g., "LEAD", "MERCURY", "BENZENE", "TOLUENE").

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
countYesNumber of release records returned
chemicalYesChemical name (uppercase)
releasesYesArray of toxic release records by chemical

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "properties": {
+    "chemical": {
+      "description": "Chemical name (uppercase)",
+      "type": "string"
+    },
+    "count": {
+      "description": "Number of release records returned",
+      "type": "number"
+    },
+    "releases": {
+      "description": "Array of toxic release records by chemical",
+      "items": {
+        "properties": {
+          "chemical": {
+            "description": "Chemical name",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "facility_name": {
+            "description": "Name of the facility",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "fugitive_air": {
+            "description": "Fugitive air emissions quantity",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "landfills": {
+            "description": "Landfill disposal quantity",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "off_site_total": {
+            "description": "Total off-site releases",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "on_site_total": {
+            "description": "Total on-site releases",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "reporting_year": {
+            "description": "Year of report",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "stack_air": {
+            "description": "Stack air emissions quantity",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "state": {
+            "description": "State abbreviation",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "total_releases": {
+            "description": "Total quantity released",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "tri_facility_id": {
+            "description": "TRI facility identifier",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "underground": {
+            "description": "Underground injection quantity",
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "unit": {
+            "description": "Unit of measure",
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "water": {
+            "description": "Water releases quantity",
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "chemical",
+    "count",
+    "releases"
+  ],
+  "type": "object"
+}
  2. Changed1 schema field changed
    • addedInput schema / examples
      Added value: +[
+  {
+    "chemical": "LEAD"
+  },
+  {
+    "chemical": "MERCURY",
+    "limit": 40,
+    "state": "OH"
+  }
+]
  3. First observed

TDQS

A4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint, covering safety and idempotence. The description adds that it returns quantities to air, water, and land by year, which is useful behavioral context beyond annotations.

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

Conciseness5/5

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

The description is a single sentence that front-loads the core purpose and output structure. No unnecessary words or repetition; every part adds value.

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

Completeness4/5

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

Given the existence of an output schema and simple parameters, the description adequately covers inputs and outputs. It explains the breakdown by year and media, but does not mention that state is optional. Slight room for improvement.

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 coverage is 100%, and each parameter has a description. The description restates the 'chemical' and 'state' dimensions but adds no extra meaning beyond the schema. Thus it meets the baseline for high-coverage schemas.

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 uses a specific verb 'track' and specifies the resource 'toxic chemical releases' with clear dimensions: chemical name, state, and yearly breakdown. This distinguishes it from sibling tools like tri_facility_releases (facility-level) and tri_trends (trend analysis).

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

Usage Guidelines4/5

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

The description explicitly states the two key filters (chemical name and state), making it clear when to use this tool—for chemical-state queries. However, it does not mention when not to use it or provide explicit alternatives, though sibling names imply differentiation.

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

All Epa Emissions toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources