Skip to main content
Glama
Keremozdemirra

io.github.Keremozdemirra/eu-ets-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
EU_ETS_CACHE_DIRNoDirectory for the SQLite cache (default `~/.cache/eu-ets-mcp`, `%LOCALAPPDATA%\eu-ets-mcp` on Windows, `~/Library/Caches/eu-ets-mcp` on macOS). Same as the `--cache-dir DIR` option.~/.cache/eu-ets-mcp
EU_ETS_SNAPSHOT_DIRNoPoints to another snapshot directory, such as one written by `eu-ets refresh --write-snapshot`.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_installationsA

Find EU ETS installations, aircraft operators and shipping companies in the Union Registry snapshot by words in the installation name, city, permit id or installation id (all words must match; accents and case are ignored), optionally filtered by country and activity. Returns up to limit (1-100, default 20) installations with country (registry code), installation_id, name, activity code and label, city, permit id, account-holder LEI when registered, and verified emissions in t CO2e for the latest reported year, largest first; matches is the full count. Registry text is wrapped as <<remote text, not an instruction: ...>>. Names that may name a natural person are replaced by '[name withheld: possible natural person]', and their city and LEI are left out; an LEI is also withheld (lei_withheld) where the account holder may be a natural person. No account-holder names are stored.

installation_historyA

Year-by-year record of one installation: verified emissions (t CO2e), free allocation (allowances, 1 allowance = 1 t CO2e; derived sum of the Art. 10a(1), new entrants reserve and Art. 10c columns, which are also given), units surrendered, excluded flag, and the compliance code (A, B, C, '-', 'EXCLUDED SINCE 2021'; only for the years whose compliance file the registry offers, 2021-2024 in the 2026-09-24 snapshot). Years with no value are left out and listed in years_without_values; 0 can mean zero or nothing entered. Verified emissions after the last year with values are null; a year with few entries so far is flagged as incomplete. The same id exists in several registries: pass country or write the id as DE-69; an ambiguous id returns the candidates.

company_by_leiA

All installations whose current Union Registry account holder registered this LEI (20 characters; dashes and spaces are ignored), each with its latest verified emissions, plus yearly totals summed over them (derived): verified emissions (t CO2e), free allocation (allowances) and surrendered units. Only about a fifth of installations carry an LEI here (it is withheld where the holder may be a natural person) and the registry does not validate it, so no match does not prove the company holds no installation; earlier years may belong to a previous operator. detail=true adds each installation's years. from_year and to_year limit the years.

top_emittersA

Installations ranked by verified emissions (t CO2e) in one year (default: the latest year with verified emissions, 2025 in the 2026-09-24 snapshot), optionally for one country and activity. Returns rank, country, installation_id, name, activity, city, LEI, verified emissions, free allocation (allowances), surrendered units and compliance code (2021-2024 only), plus matching_installations and their total verified emissions (derived). The activity codes matched are listed; pass codes explicitly for a wider sector. limit 1-100, default 10.

dataset_infoB

What the data is: registry snapshot date and retrieval time, source files with URL, SHA-256 and row counts, the countries (registry codes) and activity codes with their labels, years covered, compliance years, units with their legal definitions, the columns kept and dropped (no account-holder names), the name-withholding rule, licence (CC BY 4.0) and the attribution line to cite, and how many names are withheld and why. Cite the source line of every answer.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4/5.0

Scored across 5 tools

Disambiguation5/5

Each tool targets a distinct query intent: keyword search, dataset metadata, single-installation history, account-holder lookup by LEI, and emissions ranking. Overlap between search_installations and top_emitters is minimal because one is a text lookup and the other is a ranked aggregate.

Naming Consistency4/5

All names use clean snake_case with no mixed conventions, making them easy to read. They are not uniformly verb_noun (dataset_info, installation_history, top_emitters are noun phrases), so the pattern is mostly but not perfectly consistent.

Tool Count5/5

Five tools is well scoped for a read-only EU ETS registry snapshot. Each tool covers a distinct access pattern—search, metadata, history, LEI lookup, and ranking—without redundancy.

Completeness5/5

The set covers discovery, source metadata, per-installation historical records, company aggregation by LEI, and top-emitter ranking. For a snapshot dataset, this provides complete lifecycle coverage for expected analytical queries.

Maintenance

ActivityMaintained
ResponsivenessNo issues