Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Luxembourg MCP

by amirdaraeeversion 0.7.0i★ 9iComputer or cloudOfficial site ↗
Registry nameio.github.amirdaraee/luxembourg-mcp

How to install

What it does

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

  • Connects Computer or cloud
  • Account or key No key needed
  • Category Law & government data

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity12/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score32/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Luxembourg MCP. Follow https://mcp.popnx.com/i/amirdaraee-luxembourg-mcp.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (mcp.luxembourg-mcp.com) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameLuxembourg MCP
    Remote MCP server URL · Addresshttps://mcp.luxembourg-mcp.com/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsLuxembourg MCP

  4. Try it

    Use Luxembourg MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Luxembourg MCP or shows a Luxembourg MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameLuxembourg MCP
    Connection · Addresshttps://mcp.luxembourg-mcp.com/mcp
  3. Pick Luxembourg MCP in a chat

    Start a new chat and pick Luxembourg MCP from your plugins before typing

  4. Try it

    Use Luxembourg MCP and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Luxembourg MCP or shows a Luxembourg MCP tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user luxembourg https://mcp.luxembourg-mcp.com/mcp
  3. Type /mcp in Claude Code

    You should see Luxembourg MCP listed as connected

  4. Try it

    Use Luxembourg MCP and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Luxembourg MCP or shows a Luxembourg MCP tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Luxembourg MCP and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Luxembourg MCP or shows a Luxembourg MCP tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Luxembourg MCP and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Luxembourg MCP or shows a Luxembourg MCP tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://mcp.luxembourg-mcp.com/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Luxembourg MCP💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user luxembourg https://mcp.luxembourg-mcp.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "luxembourg": {
      "url": "https://mcp.luxembourg-mcp.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "luxembourg": {
      "type": "http",
      "url": "https://mcp.luxembourg-mcp.com/mcp"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user luxembourg -- uvx luxembourg-mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "luxembourg": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "luxembourg-mcp"
      ]
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
25/wk
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.7.0
Published to registryi
Sep 17, 2026
Code last changedi
Oct 28, 2026
Last checked
Nov 18, 2026
Maker
amirdaraee
Packages
pypi: luxembourg-mcp
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 18, 2026. The maker wrote them, not us; we show them as plain text.

  • search_datasets

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

  • get_dataset

    Get metadata and current download resources for an official dataset.

  • geocode_address

    Resolve a Luxembourg address to official Geoportail coordinates.

  • reverse_geocode

    Find the nearest official Luxembourg address to WGS84 coordinates.

  • list_geo_collections

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

  • get_geo_features

    Fetch GeoJSON features from an official Geoportail OGC collection.

  • get_weather_alerts

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

  • search_legislation

    Search official Luxembourg legislation and consolidated laws through Legilux.

  • search_statistics

    Search STATEC LUSTAT statistical dataflows by topic or title.

  • get_statistics

    Retrieve recent observations from a STATEC LUSTAT SDMX dataflow.

  • get_city_parking

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

  • list_cfl_parking

    List official CFL Park and Ride facilities.

  • get_cfl_parking

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

  • get_traffic

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

  • get_water_levels

    Get the latest official measured water level at Luxembourg stations.

  • get_air_quality

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

  • search_chamber_bodies

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

  • get_accessibility_figures

    Get national Digital Accessibility Observatory key figures.

  • get_accessibility_audits

    Get the latest public-sector digital accessibility audits.

  • search_transit_stops

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

  • get_city_mobility

    Get Ville de Luxembourg mobility locations as GeoJSON features.

  • get_weather_observations

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

  • get_public_holidays

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

  • search_parliamentary_questions

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

  • get_housing_prices

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

  • get_election_results

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

  • get_ev_charging

    Get Chargy public EV charging stations with live connector availability.

  • get_waste_collections

    Get upcoming municipal waste-collection dates for a Luxembourg commune.

  • get_weather_forecast

    Get the official MeteoLux forecast for a place in Luxembourg: current conditions, 24 hours, 5 days, UV index, sunrise and sunset.

  • get_fuel_prices

    Get official monthly Luxembourg prices for petrol, diesel, hydrogen, LPG, home electricity and public EV charging.

  • get_public_alerts

    Get recent LU-Alert public warnings: floods, storms, food recalls and other national alerts.

  • get_commune_leaders

    Get the current mayor and aldermen of Luxembourg communes.

  • get_commune_population

    Get official resident population by commune, split by adults, minors and sex.

  • get_pharmacies_on_duty

    Get the pharmacies on duty in Luxembourg for a date, with address and phone number.

  • get_electricity_prices

    Get Luxembourg day-ahead wholesale electricity prices per quarter hour, with the cheapest and most expensive slots.

  • get_carsharing

    Find currently available CFL FLEX carsharing vehicles by station, town or fuel type.

  • get_bike_sharing

    Get live Vel'OK bike-sharing availability at stations in southern Luxembourg.

  • search_tenders

    Search Luxembourg public procurement notices with deadlines, buyers and CPV codes.

  • get_plenary_votes

    Get Chamber of Deputies plenary votes, newest first, with yes/no/abstain tallies per party and optionally how one deputy voted.

  • get_deputies

    List the current members of the Chamber of Deputies with party, constituency, start of mandate and official email.

  • lookup_luxembourgish

    Look up a word in the official Luxembourgish dictionary (LOD): translations into German, French, English and Portuguese, pronunciation, forms and examples.

  • get_traffic_events

    Get live roadworks, lane closures, incidents and equipment faults on Luxembourg motorways from CITA.

  • get_electricity_grid

    Get Luxembourg's latest daily electricity load, generation by production type and cross-border flows (ENTSO-E actuals).

  • get_unemployment

    Get monthly ADEM figures: registered resident jobseekers by sex and job vacancies, nationally or for one commune.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account amirdaraee, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 22 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 154 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 44 tool descriptions and found no hidden instructions to the AI

The cloud address answered 4 of the last 4 checks · latest 154 ms · checked Nov 18, 2026

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for luxembourg-mcp@0.7.0

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/amirdaraee-luxembourg-mcp.svg)](https://mcp.popnx.com/en/servers/amirdaraee-luxembourg-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Law & government datai

  • More stars than 97% of the other 1945 servers in this category
  • Published to the registry more recently than 33% of the other 1945 servers in this category
  • Basic checks equal to or better than 99% of the other 1945 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Luxembourg MCP safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 22 days ago, and the latest version (0.7.0) reached the registry 2 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

by lexifinaWidely used★ 2.1KUpdated 9 days ago

Runs in the cloud✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

by librejusticeEarly★ 36Updated 2 months ago

Runs in the cloud✓ service owner · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

by street1983nkEarly★ 18Updated 5 months ago

Runs in the cloud✓ service owner · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

by JayTheSkierEarly★ 8Updated 7 months ago

Runs in the cloud✓ service owner · fedlex-connector.ch
Compared with similar ones
This one
Luxembourg MCP
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Runs whereCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoNoNoNoNoNo
Basic checks5/54/44/44/44/44/4
LicenseMITNOASSERTIONMITApache-2.0Apache-2.0MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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 44 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.

  • 44 MCP tools
  • 28 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

ToolPublic sourcePurpose
search_datasetsdata.public.luSearch the national open-data catalogue
get_datasetdata.public.luInspect metadata and current resources
geocode_addressGeoportailResolve an official address
reverse_geocodeGeoportailFind the nearest official address
list_geo_collectionsGeoportail OGC APIDiscover queryable geospatial layers
get_geo_featuresGeoportail OGC APIRetrieve bounded GeoJSON features
get_weather_alertsMeteoLuxRead current weather warnings
search_legislationLegiluxSearch legislation and consolidated laws
search_statisticsSTATEC LUSTATDiscover statistical dataflows
get_statisticsSTATEC LUSTATRetrieve labelled SDMX observations
get_city_parkingVille de LuxembourgRead live city parking availability
list_cfl_parkingCFLList Park and Ride facilities
get_cfl_parkingCFLRead live P+R occupancy and free spaces
get_trafficCITARead live motorway traffic measurements
get_water_levelsWater Management AdministrationRead current water-station levels
get_air_qualityEnvironment AdministrationRead national air-quality measurements
search_chamber_bodiesChamber of DeputiesSearch bodies, memberships, and roles
get_accessibility_figuresDigital Accessibility ObservatoryRead national accessibility totals
get_accessibility_auditsDigital Accessibility ObservatoryList recent public-sector audits
search_transit_stopsPublic Transport AdministrationSearch nationwide GTFS stops
get_city_mobilityVille de Luxembourg MapsRetrieve mobility locations as GeoJSON
get_weather_observationsMeteoLuxLive temperature, wind, pressure at Findel
get_public_holidaysdata.public.luLegal public holidays in four languages
search_parliamentary_questionsChamber of DeputiesSearch parliamentary questions and answers
get_housing_pricesObservatoire de l'HabitatAdvertised housing sale prices by commune
get_election_resultsCTIE2023 legislative election results
get_ev_chargingChargyPublic EV charging with live availability
get_waste_collectionsEnvironment AdministrationUpcoming waste-collection dates by commune
get_weather_forecastMeteoLuxOfficial forecast, UV index, sunrise and sunset
get_fuel_pricesMinistère de l'ÉconomieMonthly fuel, hydrogen and EV-charging prices
get_public_alertsLU-AlertNational warnings, including food recalls
get_commune_leadersMinistère des Affaires intérieuresCurrent mayor and aldermen per commune
get_commune_populationCTIEResident population by commune, age group and sex
get_pharmacies_on_dutyPharmacie.luPharmacies on duty, with address and phone
get_electricity_pricesOpen Data LëtzebuergDay-ahead power prices per quarter hour
get_carsharingCFL MobilityAvailable FLEX carsharing vehicles
get_bike_sharingVël'OKLive bike-sharing availability in the south
search_tendersPortail des marchés publicsOpen public procurement notices
get_plenary_votesChamber of DeputiesPlenary votes with tallies per party and per deputy
get_deputiesChamber of DeputiesCurrent deputies, party, constituency and email
lookup_luxembourgishLëtzebuerger Online DictionnaireTranslations, pronunciation and examples
get_traffic_eventsCITALive roadworks, closures and incidents
get_electricity_gridOpen Data LëtzebuergDaily load, generation mix and cross-border flows
get_unemploymentADEMMonthly jobseekers and vacancies, national or by commune

Quick start

Python 3.11 or newer is required.

python -m venv .venv

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

Once running:

InterfaceURL
Tool cataloguehttp://127.0.0.1:8000/
MCP endpointhttp://127.0.0.1:8000/mcp
Health checkhttp://127.0.0.1:8000/health
Upstream statushttp://127.0.0.1:8000/status

/status reports whether each tool's official upstreams are reachable; the catalogue shows it as a light on every tool card. Each upstream gets one lightweight check (only the first few kilobytes are read) at most every 10 minutes, however many people load the page. One failed check marks an upstream *degraded*, two in a row *down*.

Stdio client
{

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

Docker
docker build -t luxembourg-mcp .

docker run --rm -i luxembourg-mcp # stdio (default) docker run --rm -p 8000:8000 luxembourg-mcp --transport http --host 0.0.0.0 # HTTP

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?
  • Are there roadworks or lane closures on the A4 right now?
  • How did each party vote on the latest tramway bill?
  • What does the Luxembourgish word "Schiertech" mean?
  • 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 2026-07-28 (stateless: per-request _meta, server/discover, cache hints) alongside the initialize-handshake revisions 2025-11-25, 2025-06-18, and 2025-03-26 on the same endpoint and over stdio;
  • validates the MCP-Protocol-Version, Mcp-Method, and Mcp-Name headers against the request body 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; fixed upstream URLs only follow HTTPS redirects on the same host.
  • Upstream XML declaring DTD entities is rejected before parsing, and user-supplied identifiers cannot form ./.. URL path segments.
  • 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; IPv6 clients are grouped by /64 prefix.
  • The HTTP server serves at most 32 concurrent connections by default and closes connections idle for 30 seconds.
  • The Docker image runs as an unprivileged app user from a digest-pinned base image.

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. Set LUXEMBOURG_MCP_MAX_CONNECTIONS to change the concurrent-connection cap; connections beyond it are closed immediately.

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 28 tools.

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

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

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 da

Only the beginning is shown; read the rest in the repo