Skip to main content
Glama

get_environmental_impact_data

Read-onlyIdempotent

Return the versioned TheAIMeters data pack for global annualized AI electricity consumption, operational water consumption and operational carbon emissions. Includes central estimates, indicative ranges, sourced assumptions, model versions, revision evidence and structured references. These are modelled estimates, not official telemetry or direct real-time measurements.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_environmental_impact_data"
  }
}

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
idYes
reuseYes
titleYes
figureTypeYes
indicatorsYes
reviewedOnYes
descriptionYes
sourcesPathYes
methodologyPathYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed8 schema fields changed
    • addedOutput schema / properties / indicators / items / properties / assumptions
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "id": {
      +        "type": "string"
      +      },
      +      "kind": {
      +        "enum": [
      +          "assumption",
      +          "public_proxy"
      +        ],
      +        "type": "string"
      +      },
      +      "label": {
      +        "type": "string"
      +      },
      +      "note": {
      +        "type": "string"
      +      },
      +      "sourceIds": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "sources": {
      +        "items": {
      +          "additionalProperties": true,
      +          "properties": {
      +            "category": {
      +              "enum": [
      +                "research",
      +                "public_data",
      +                "api",
      +                "status"
      +              ],
      +              "type": "string"
      +            },
      +            "id": {
      +              "type": "string"
      +            },
      +            "name": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "format": "uri",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "id",
      +            "name",
      +            "url",
      +            "category"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "value": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "label",
      +      "value",
      +      "kind",
      +      "sources"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / indicators / items / properties / centralEstimateBasis
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / indicators / items / properties / rangeType
      Added value: +{
      +  "enum": [
      +    "indicative_sensitivity_range",
      +    "published_estimate_range"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / indicators / items / properties / revisions / items / properties / evidenceNote
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / indicators / items / properties / revisions / items / properties / sourceIds
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / indicators / items / properties / revisions / items / properties / sources
      Added value: +{
      +  "items": {
      +    "additionalProperties": true,
      +    "properties": {
      +      "category": {
      +        "enum": [
      +          "research",
      +          "public_data",
      +          "api",
      +          "status"
      +        ],
      +        "type": "string"
      +      },
      +      "id": {
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "url": {
      +        "format": "uri",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "name",
      +      "url",
      +      "category"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / properties / indicators / items / properties / revisions / items / required
      Previous value: -[
      -  "version",
      -  "effectiveOn",
      -  "centralValue",
      -  "unit",
      -  "reason",
      -  "summary"
      -]New value: +[
      +  "version",
      +  "effectiveOn",
      +  "centralValue",
      +  "unit",
      +  "reason",
      +  "summary",
      +  "sourceIds",
      +  "evidenceNote",
      +  "sources"
      +]
    • changedOutput schema / properties / indicators / items / required
      Previous value: -[
      -  "id",
      -  "label",
      -  "description",
      -  "canonicalMeterSlug",
      -  "indicatorPath",
      -  "methodologyPath",
      -  "methodologyId",
      -  "figureType",
      -  "scope",
      -  "period",
      -  "evidenceYear",
      -  "estimate",
      -  "rangeBasis",
      -  "confidenceLevel",
      -  "reviewedOn",
      -  "modelVersion",
      -  "sourceNote",
      -  "sourceIds",
      -  "sources",
      -  "revisions"
      -]New value: +[
      +  "id",
      +  "label",
      +  "description",
      +  "canonicalMeterSlug",
      +  "indicatorPath",
      +  "methodologyPath",
      +  "methodologyId",
      +  "figureType",
      +  "scope",
      +  "period",
      +  "evidenceYear",
      +  "estimate",
      +  "centralEstimateBasis",
      +  "rangeType",
      +  "rangeBasis",
      +  "confidenceLevel",
      +  "reviewedOn",
      +  "modelVersion",
      +  "sourceNote",
      +  "sourceIds",
      +  "sources",
      +  "assumptions",
      +  "revisions"
      +]
  2. Added

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already cover safety (readOnlyHint, idempotentHint, destructiveHint=false), so the description's value is in the extra context it supplies: the pack is versioned, carries model versions, sourced assumptions and revision evidence, and is explicitly a modelled estimate rather than measured telemetry. That last sentence is genuinely useful for an agent deciding how to present the numbers. It adds no detail on pack size, freshness cadence, or pagination, keeping it from a 5.

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?

Two sentences, no filler, with the resource identity front-loaded and the important epistemic caveat placed at the end where it reads as a qualifier. The middle sentence is a dense list of payload contents, which is efficient but borders on enumeration for its own sake given an output schema already exists.

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?

For a no-argument read tool with an output schema declared, the description covers what the payload is, how it is versioned, and how trustworthy it is — the dimensions an agent actually needs. The only material gap is the absence of routing guidance against get_meter and get_methodology, which the sibling set makes relevant.

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

Parameters4/5

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

Zero parameters with additionalProperties=false, so there is no parameter semantics to explain and the baseline of 4 applies. The description correctly stays silent on inputs rather than inventing them.

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

Purpose4/5

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

The description opens with a specific verb ('Return') and a precisely named resource ('versioned TheAIMeters data pack for global annualized AI electricity consumption, operational water consumption and operational carbon emissions'), which is enough to distinguish it from a single-meter lookup like get_meter. It never explicitly contrasts itself with the siblings (get_meter, get_methodology, get_sources), so it falls short of a 5.

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 only implied: the agent can infer this is the aggregate impact dataset rather than a single meter or methodology page, but no when-to-use condition, prerequisite, or named alternative is stated. The closing caveat ('not official telemetry or direct real-time measurements') hints at when not to rely on it, but isn't framed as routing guidance.

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.

Resources