Belgium
БесплатноНе проверенOne MCP server for Belgian public APIs. It bundles Belgian transport, official statistics, open data, addresses, weather, air quality, and geospatial services.
Описание
One MCP server for Belgian public APIs. It bundles Belgian transport, official statistics, open data, addresses, weather, air quality, and geospatial services.
README
npm version npm downloads CI license node pnpm typescript mcp
One MCP server for Belgian public APIs.
mcp-belgium is the public entry point. It exposes a single aggregated MCP server that bundles Belgian transport, official statistics, open data, addresses, weather, air quality, and geospatial services behind one install and one client config entry.
The package is also prepared for publication to the official MCP Registry under io.github.lacausecrypto/mcp-belgium.
Why use it
- one npm package
- one MCP server entry in your client config
- namespaced tools like
irail_*,statbel_*,best_*,kmi_*,urban_*, andurbis_* - built-in catalog tools, resources, and a prompt so the LLM can discover the right Belgian domain before calling tools
- explicit, actionable errors when an upstream requires a key or has changed contract (no silent empty results)
Install
Run directly:
npx -y mcp-belgium
With pnpm:
pnpm dlx mcp-belgium
Global install:
pnpm add -g mcp-belgium
mcp-belgium
Default transport is stdio, which is what desktop MCP clients expect.
Claude Desktop
{
"mcpServers": {
"belgium": {
"command": "npx",
"args": [
"-y",
"mcp-belgium"
],
"env": {
"LOG_LEVEL": "silent"
}
}
}
}
Most domains need no key. Two are key-gated, and their keys go in the same env block:
"env": {
"LOG_LEVEL": "silent",
"CBEAPI_KEY": "<your cbeapi key>",
"STIB_API_KEY": "<your stib key>"
}
| Variable | Enables | Where to get it |
|---|---|---|
CBEAPI_KEY |
kbo_* company registry tools |
free tier (2,500 calls/day) at https://cbeapi.be |
STIB_API_KEY |
stib_* Brussels transit tools |
free key at https://data.stib-mivb.brussels |
MCP_TRANSPORT=http |
Streamable HTTP instead of stdio | — |
PORT_BELGIUM |
HTTP port of the aggregated server (default 3017) |
— |
Restart your MCP client after editing its config.
What the LLM gets
Alongside the domain tools, mcp-belgium exposes a discovery layer:
belgium_catalog_overviewbelgium_list_domainsbelgium_describe_domainbelgium://catalogbelgium://catalog.jsonbelgium://domain/{domain}belgium_capability_guide
That means the LLM can:
- inspect the Belgian domains available from this single MCP
- see which domains are live, limited, or key-gated
- understand what kind of data each domain provides
- pick the right namespaced tool without guessing
Main domains
| Prefix | Domain | Status | Auth | Main data |
|---|---|---|---|---|
irail_* |
Belgian rail / iRail | Live | None | stations, connections, liveboards, vehicles, disruptions |
mobility_* |
Trip planning via Transitous | Live | None | door-to-door trips across SNCB, STIB, De Lijn and TEC; operators, GTFS references |
stib_* |
STIB/MIVB Brussels transit | Live | API key | waiting times, stops, routes, service messages |
infrabel_* |
Infrabel Open Data | Live | None | rail infrastructure datasets and records |
kbo_* |
Belgian company registry | Live | API key | enterprise search, company details, companies by NACE code |
best_* |
BeST Belgian addresses | Live | None | addresses, municipalities, streets, postal infos |
statbel_* |
Statbel | Live | None | population, CPI, employment by year and region; search and read any Be.STAT view |
airquality_* |
IRCELINE air quality | Live | None | nearest stations, live measurements, BelAQI at any point, timeseries |
datagov_* |
data.gov.be catalogue (via data.europa.eu) | Live | None | dataset search, metadata, publishers, download links |
brussels_* |
Brussels Region open data | Live | None | datasets and records |
wallonia_* |
Wallonia open data | Live | None | datasets and records |
kmi_* |
KMI / IRM GeoServer | Live | None | stations, hourly observations, WFS discovery |
wallonia_geo_* |
Wallonia GeoServices | Live | None | ArcGIS folders, services, layer queries |
urban_* |
urban.brussels WFS | Live | None | feature types, schemas, GeoJSON features, the 19 commune boundaries |
urbis_* |
URBIS public WMS | Live | None | WMS layer discovery and map URL generation |
flanders_* |
Datavindplaats compatibility layer | Deprecated | API key | explicit upstream limitation error |
For a sector or company question, kbo_search_by_activity lists companies by NACE code; for any other Belgian open dataset, start with datagov_search_datasets, which covers federal, regional and local publishers.
Docs / Wiki
The repo now includes a docs/ tree that works as a lightweight public wiki:
Local development
Requirements:
- Node.js >= 22
- pnpm >= 9
Setup:
pnpm install
pnpm run build
pnpm run test
pnpm run typecheck
Run the aggregated server over stdio:
pnpm --filter mcp-belgium start:stdio
Run it over Streamable HTTP:
MCP_TRANSPORT=http PORT_BELGIUM=3017 pnpm --filter mcp-belgium start
Run the whole workspace:
docker compose up --build
Monorepo shape
packages/core: shared HTTP, retry, cache, rate limiting, XML helpers, and MCP response helperspackages/mcp-belgium: public aggregated entry pointpackages/mcp-*: domain-specific packages kept modular for maintenance, testing, and isolated validation
The public consumer path is mcp-belgium. Internal workspace packages stay modular for development, but the published mcp-belgium package bundles them so end users install only one npm package.
Upstream caveats
This project wraps public upstream APIs. Some Belgian portals change authentication or endpoint contracts over time. When an upstream is no longer publicly compatible, this project prefers explicit, machine-readable limitation errors over silent failure.
Current examples:
stib_*requiresSTIB_API_KEY,kbo_*requiresCBEAPI_KEYdatagov_*reads the data.gov.be catalogue from its official data.europa.eu mirror, since data.gov.be retired its CKAN APImobility_plan_triproutes through Transitous, a community-run open-source service: keep request volume reasonablewallonia_*record queries share the anonymous ODS quota of the Wallonia portal (10,000 calls/day) and can return HTTP 429 when it is exhaustedflanders_*preserves the old tool contract but returns an explicit API-key limitation
See CHANGELOG.md for upstream changes handled in each release.
Validation
Current workspace checks (the same steps run in CI):
pnpm run lintpnpm run buildpnpm run testpnpm run typecheckpnpm audit --prod
License
MIT. See LICENSE.
Установка Belgium
У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.
▸ github.com/lacausecrypto/mcp-belgiumFAQ
Belgium MCP бесплатный?
Да, Belgium MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Belgium?
Нет, Belgium работает без API-ключей и переменных окружения.
Belgium — hosted или self-hosted?
Доступен hosted-вариант: Unyly запускает сервер в облаке, локальная установка не обязательна.
Как установить Belgium в Claude Desktop, Claude Code или Cursor?
Открой Belgium на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
GitHub
PRs, issues, code search, CI status
автор: GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
автор: mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
автор: GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
автор: UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
автор: duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
автор: blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
автор: Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
автор: runapi-aiCompare Belgium with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development
