Luxembourg MCP

Official27 toolsLive

by amirdaraee · Python

Keyless MCP access to official Luxembourg public data: laws, statistics, mobility, and more.

Topics

luxembourgmcpmcp-servermodel-context-protocolopen-datapython

Captured live from the server via tools/list.

search_datasets

Search Luxembourg's official data.public.lu catalog.

Parameters3

query	string	required
page	integer	optional
page_size	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "default": 1
    },
    "page_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

get_dataset

Get metadata and current download resources for an official dataset.

Parameters1

dataset_id_or_slug

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "dataset_id_or_slug": {
      "type": "string"
    }
  },
  "required": [
    "dataset_id_or_slug"
  ],
  "additionalProperties": false
}

geocode_address

Resolve a Luxembourg address to official Geoportail coordinates.

Parameters1

query

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

reverse_geocode

Find the nearest official Luxembourg address to WGS84 coordinates.

Parameters2

latitude	number	required
longitude	number	required

Raw schema

{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number"
    },
    "longitude": {
      "type": "number"
    }
  },
  "required": [
    "latitude",
    "longitude"
  ],
  "additionalProperties": false
}

list_geo_collections

Search official Geoportail OGC feature collections by title, description, or keyword.

Parameters2

query	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  },
  "additionalProperties": false
}

get_geo_features

Fetch GeoJSON features from an official Geoportail OGC collection.

Parameters3

collection_id	string	required
limit	integer	optional
bbox	array	optional	WGS84 [west, south, east, north]

Raw schema

{
  "type": "object",
  "properties": {
    "collection_id": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10
    },
    "bbox": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "minItems": 4,
      "maxItems": 4,
      "description": "WGS84 [west, south, east, north]"
    }
  },
  "required": [
    "collection_id"
  ],
  "additionalProperties": false
}

get_weather_alerts

Get current official MeteoLux weather warnings published on data.public.lu.

Parameters1

language

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "language": {
      "type": "string",
      "enum": [
        "en",
        "fr",
        "de",
        "lu"
      ],
      "default": "en"
    }
  },
  "additionalProperties": false
}

search_legislation

Search official Luxembourg legislation and consolidated laws through Legilux.

Parameters2

query	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

search_statistics

Search STATEC LUSTAT statistical dataflows by topic or title.

Parameters2

query	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

get_statistics

Retrieve recent observations from a STATEC LUSTAT SDMX dataflow.

Parameters4

dataflow_id	string	required	STATEC identifier such as DF_D7100
key	string	optional	SDMX dimension key or all
last_n_observations	integer	optional
max_rows	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "dataflow_id": {
      "type": "string",
      "description": "STATEC identifier such as DF_D7100"
    },
    "key": {
      "type": "string",
      "default": "all",
      "description": "SDMX dimension key or all"
    },
    "last_n_observations": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 5
    },
    "max_rows": {
      "type": "integer",
      "minimum": 1,
      "maximum": 2000,
      "default": 500
    }
  },
  "required": [
    "dataflow_id"
  ],
  "additionalProperties": false
}

get_city_parking

Get current Ville de Luxembourg car-park capacity and free spaces.

Parameters2

query	string	optional
available_only	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "available_only": {
      "type": "boolean",
      "default": false
    }
  },
  "additionalProperties": false
}

list_cfl_parking

List official CFL Park and Ride facilities.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_cfl_parking

Get live occupancy and details for a CFL Park and Ride facility.

Parameters1

parking_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "parking_id": {
      "type": "string"
    }
  },
  "required": [
    "parking_id"
  ],
  "additionalProperties": false
}

get_traffic

Get live CITA motorway speed, occupancy, and flow measurements.

Parameters1

road

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "road": {
      "type": "string",
      "enum": [
        "a3",
        "a4",
        "a6",
        "a7",
        "a13",
        "b40"
      ],
      "default": "a6"
    }
  },
  "additionalProperties": false
}

get_water_levels

Get the latest official measured water level at Luxembourg stations.

Parameters1

station

string

optional

Optional station-name filter

Raw schema

{
  "type": "object",
  "properties": {
    "station": {
      "type": "string",
      "description": "Optional station-name filter"
    }
  },
  "additionalProperties": false
}

get_air_quality

Get the latest national telemetric air-quality measurements by station.

Parameters1

city

string

optional

Optional city-name filter

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "Optional city-name filter"
    }
  },
  "additionalProperties": false
}

search_chamber_bodies

Search official Chamber committees, delegations, bodies, memberships, and roles.

Parameters2

query	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

get_accessibility_figures

Get national Digital Accessibility Observatory key figures.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_accessibility_audits

Get the latest public-sector digital accessibility audits.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 10
    }
  },
  "additionalProperties": false
}

search_transit_stops

Search official nationwide public-transport stops from the current ATP GTFS feed.

Parameters2

query	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

get_city_mobility

Get Ville de Luxembourg mobility locations as GeoJSON features.

Parameters1

get_weather_observations

Get live MeteoLux weather observations at Luxembourg-Airport: temperature, wind, pressure, humidity, visibility.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_public_holidays

List Luxembourg legal public holidays in four languages, optionally for one year.

Parameters1

year

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 2020,
      "maximum": 2100
    }
  },
  "additionalProperties": false
}

search_parliamentary_questions

Search Chamber of Deputies parliamentary questions by keyword, newest first.

Parameters2

query	string	required
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

get_housing_prices

Get advertised housing sale prices by commune from the official Observatoire de l'Habitat.

Parameters3

property_type	string	optional
commune	string	optional	Optional commune-name filter
year	string	optional	Four-digit year such as 2025; defaults to the latest

Raw schema

{
  "type": "object",
  "properties": {
    "property_type": {
      "type": "string",
      "enum": [
        "apartment",
        "house"
      ],
      "default": "apartment"
    },
    "commune": {
      "type": "string",
      "description": "Optional commune-name filter"
    },
    "year": {
      "type": "string",
      "description": "Four-digit year such as 2025; defaults to the latest"
    }
  },
  "additionalProperties": false
}

get_election_results

Get machine-readable 2023 legislative election results, national and per circonscription.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_ev_charging

Get Chargy public EV charging stations with live connector availability.

Parameters2

query	string	optional	Optional name or address filter
available_only	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional name or address filter"
    },
    "available_only": {
      "type": "boolean",
      "default": false
    }
  },
  "additionalProperties": false
}

README.md9 KBView on GitHub

Luxembourg MCP

Keyless Model Context Protocol access to Luxembourg public data.

Hosted endpoint — no install needed: point any MCP client at https://mcp.luxembourg-mcp.com/mcp (streamable HTTP). Or run it yourself with uvx luxembourg-mcp. Website: luxembourg-mcp.com

Luxembourg MCP turns fragmented public APIs and open datasets into 27 consistent tools that AI agents can call directly. It covers laws, official statistics, mobility, environmental measurements, parliament, accessibility, addresses, geospatial features, and the national open-data catalogue.

27 MCP tools
18 public data systems
No API keys or accounts
No scraping
Source URL returned with every result
Stdio and Streamable HTTP transports

Origin and credit

This project is directly inspired by Allemannsdata, created by Thomas Heggelund.

Heggelund's original idea was to give public data the same openness suggested by Norway's allemannsretten, the right to roam: public information should be straightforward to reach, combine, and use. Allemannsdata removes the repetitive integration work between agents and Norwegian public services by presenting many unrelated data sources through consistent, keyless MCP tools.

Luxembourg MCP applies that idea to the Grand Duchy. It is an independent implementation for Luxembourg, not a fork, official regional edition, or affiliated project. Credit for the original public-data-over-MCP catalogue concept belongs to Thomas Heggelund and Allemannsdata.

Available tools

Tool	Public source	Purpose
`search_datasets`	data.public.lu	Search the national open-data catalogue
`get_dataset`	data.public.lu	Inspect metadata and current resources
`geocode_address`	Geoportail	Resolve an official address
`reverse_geocode`	Geoportail	Find the nearest official address
`list_geo_collections`	Geoportail OGC API	Discover queryable geospatial layers
`get_geo_features`	Geoportail OGC API	Retrieve bounded GeoJSON features
`get_weather_alerts`	MeteoLux	Read current weather warnings
`search_legislation`	Legilux	Search legislation and consolidated laws
`search_statistics`	STATEC LUSTAT	Discover statistical dataflows
`get_statistics`	STATEC LUSTAT	Retrieve labelled SDMX observations
`get_city_parking`	Ville de Luxembourg	Read live city parking availability
`list_cfl_parking`	CFL	List Park and Ride facilities
`get_cfl_parking`	CFL	Read live P+R occupancy and free spaces
`get_traffic`	CITA	Read live motorway traffic measurements
`get_water_levels`	Water Management Administration	Read current water-station levels
`get_air_quality`	Environment Administration	Read national air-quality measurements
`search_chamber_bodies`	Chamber of Deputies	Search bodies, memberships, and roles
`get_accessibility_figures`	Digital Accessibility Observatory	Read national accessibility totals
`get_accessibility_audits`	Digital Accessibility Observatory	List recent public-sector audits
`search_transit_stops`	Public Transport Administration	Search nationwide GTFS stops
`get_city_mobility`	Ville de Luxembourg Maps	Retrieve mobility locations as GeoJSON
`get_weather_observations`	MeteoLux	Live temperature, wind, pressure at Findel
`get_public_holidays`	data.public.lu	Legal public holidays in four languages
`search_parliamentary_questions`	Chamber of Deputies	Search parliamentary questions and answers
`get_housing_prices`	Observatoire de l'Habitat	Advertised housing sale prices by commune
`get_election_results`	CTIE	2023 legislative election results
`get_ev_charging`	Chargy	Public EV charging with live availability

Quick start

Python 3.11 or newer is required.

bash

python -m venv .venv
. .venv/bin/activate
pip install -e .
luxembourg-mcp --transport http --port 8000

Once running:

Interface	URL
Tool catalogue	`http://127.0.0.1:8000/`
MCP endpoint	`http://127.0.0.1:8000/mcp`
Health check	`http://127.0.0.1:8000/health`

Stdio client

json

{
  "mcpServers": {
    "luxembourg": {
      "command": "luxembourg-mcp"
    }
  }
}

Docker

bash

docker build -t luxembourg-mcp .
docker run --rm -p 8000:8000 luxembourg-mcp

Example questions

After connecting an MCP client, an agent can answer questions such as:

What weather warnings are active in Luxembourg?
How many spaces are free at a CFL Park and Ride?
What is the latest water level at Mersch?
Find legislation concerning pensions.
Which STATEC datasets contain population figures?
What are the latest traffic measurements on the A6?
Find the official coordinates for an address in Luxembourg City.
Which bus or tram stops match Hamilius?

Protocol behavior

The server:

validates arguments against every advertised tool input schema;
rejects JSON-RPC batches and other non-object JSON with -32600 Invalid Request;
supports MCP revisions 2025-11-25, 2025-06-18, and 2025-03-26;
validates the MCP-Protocol-Version header for HTTP requests;
returns tool failures as MCP tool results without terminating the server;
bounds large upstream responses before placing them in agent context.

The built-in HTTP server is stateless and does not provide an SSE stream. By default it accepts browser origins only from loopback addresses; hosted deployments can extend this with LUXEMBOURG_MCP_ALLOWED_ORIGINS (a comma-separated origin list, or *), which also enables CORS preflight and response headers for the allowed origins. Public deployments should add TLS, response caching, and observability at a reverse proxy or application gateway.

Security and deployment

The built-in server includes baseline controls, but it is not a replacement for a production API gateway:

HTTP request bodies are limited to 1 MiB.
Upstream responses are limited to 25 MiB.
Metadata-derived downloads are restricted to trusted data.public.lu HTTPS resource hosts, including redirects.
GTFS ZIP members are checked for decompressed size, encryption, and suspicious compression ratios before extraction.
HTTP clients are limited to 60 MCP requests per minute by default.
The Docker image runs as an unprivileged app user.

Set LUXEMBOURG_MCP_RATE_LIMIT to change the per-minute, per-client limit. A value of 0 disables the built-in limiter. The limiter intentionally uses the direct TCP peer address and does not trust forwarding headers unless LUXEMBOURG_MCP_CLIENT_IP_HEADER names one explicitly (for example CF-Connecting-IP behind Cloudflare); only set it when a trusted proxy controls that header, since clients could otherwise spoof it to escape the limit.

Tool output is untrusted external data. Dataset descriptions, legislation titles, and other public text may contain misleading or adversarial instructions. MCP clients and agent hosts must treat tool results as data, not system instructions, and should require confirmation or policy checks before allowing powerful sibling tools to act on content returned here.

Testing

The default suite is deterministic and does not use the network. It covers JSON-RPC behavior, schema validation, provider parsers, catalogue packaging, and the tools/call contract for all 27 tools.

bash

PYTHONPATH=src python -m unittest discover -s tests -v

The opt-in live suite calls every real upstream service:

bash

LUXEMBOURG_MCP_LIVE=1 PYTHONPATH=src \
  python -m unittest tests.test_live_tools -v

Live tests may fail when a source is unavailable or changes its published data. They also download larger STATEC, air-quality, Chamber, and GTFS resources.

Current limitations

The official ATP API for real-time departures and journey planning requires a personal access key. This project exposes keyless static stops from the official GTFS feed instead.
The cache is bounded but local to one process. Multiple workers do not share cached data.
Upstream availability, update frequency, schemas, and licensing remain controlled by each data producer.
Tool coverage is not yet at parity with Allemannsdata. Candidates include parliamentary votes, court decisions, historical weather, EV charging, road works, and more environmental measurements.

Independence and data ownership

Luxembourg MCP is a community project. It is not affiliated with Thomas Heggelund, Allemannsdata, the Luxembourg government, or any agency whose data it exposes.

The project does not own the upstream data. Each producer's licence and terms continue to apply. Tool results preserve the upstream source URL so agents and users can inspect the authoritative record.

Licence

The Luxembourg MCP source code is released under the MIT licence. Upstream public data is licensed separately by its respective producer.

mcp-name: io.github.amirdaraee/luxembourg-mcp

Install

Tools (27)

search_datasetsget_datasetgeocode_addressreverse_geocodelist_geo_collectionsget_geo_featuresget_weather_alertssearch_legislation

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "luxembourg-mcp": {
      "command": "uvx",
      "args": [
        "luxembourg-mcp"
      ]
    }
  }
}