io.github.Keremozdemirra/eu-ets-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| EU_ETS_CACHE_DIR | No | Directory 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_DIR | No | Points 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
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 |
| 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 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
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.
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.
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.
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.