MaStR MCP Server
Plugs Claude directly into Germany's Marktstammdatenregister, the federal energy plant registry run by Bundesnetzagentur. You get 21 tools split between authenticated SOAP endpoints and public JSON searches. Query wind turbines by postcode and capacity range, pull full unit details with EEG and storage data, search gas production facilities, filter grid connection points by voltage level, or track market actors and balancing areas. Supports 10 filter operators (contains, starts with, greater than, null checks) and recognizes all 20 energy carrier types from solar to hydrogen. Credentials unlock the full SOAP API with delta syncs and catalog lookups, but seven public search tools work immediately without registration. Built for energy analysts and researchers who need programmatic access to Germany's 3+ million registered energy market entries.
- GitHub stars
- 6
- tools
- 21
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Apr 15, 2026
Tools
21 toolsPublic tool metadata for what this MCP can expose to an agent.
get_unitFull unit details + EEG + CHP + permit + storage in one call
Full unit details + EEG + CHP + permit + storage in one call
No parameter schema in public metadata yet.
search_power_generation_soapFiltered search for power generation (all 20 energy carriers, postcode, capacity)
Filtered search for power generation (all 20 energy carriers, postcode, capacity)
No parameter schema in public metadata yet.
get_actorMarket actor details by MaStR number
Market actor details by MaStR number
No parameter schema in public metadata yet.
get_api_quotaDaily API quota (used / limit)
Daily API quota (used / limit)
No parameter schema in public metadata yet.
get_recent_changesDelta sync: changes since date (EEG, CHP, permit, location, storage)
Delta sync: changes since date (EEG, CHP, permit, location, storage)
No parameter schema in public metadata yet.
search_power_consumption_soapFiltered search for power consumers (postcode, state, status, etc.)
Filtered search for power consumers (postcode, state, status, etc.)
No parameter schema in public metadata yet.
search_gas_production_soapFiltered search for gas production (capacity, postcode, etc.)
Filtered search for gas production (capacity, postcode, etc.)
No parameter schema in public metadata yet.
search_gas_consumption_soapFiltered search for gas consumers (capacity, postcode, etc.)
Filtered search for gas consumers (capacity, postcode, etc.)
No parameter schema in public metadata yet.
search_actors_soapFiltered search for market actors (function, role, postcode, etc.)
Filtered search for market actors (function, role, postcode, etc.)
No parameter schema in public metadata yet.
get_locationLocation details incl. linked units + grid connection points
Location details incl. linked units + grid connection points
No parameter schema in public metadata yet.
get_catalog_valuesCatalog/enum values (legal form, manufacturer, etc.) by category ID
Catalog/enum values (legal form, manufacturer, etc.) by category ID
No parameter schema in public metadata yet.
get_catalog_categoriesList all available catalog categories
List all available catalog categories
No parameter schema in public metadata yet.
get_balancing_areasBalancing areas (Y-EIC codes, control areas), optionally by DSO
Balancing areas (Y-EIC codes, control areas), optionally by DSO
No parameter schema in public metadata yet.
get_grid_connectionGrid connection points for a unit (voltage level, location, co-located units)
Grid connection points for a unit (voltage level, location, co-located units)
No parameter schema in public metadata yet.
search_power_generation_publicPower generation units (27 filter keys)
Power generation units (27 filter keys)
No parameter schema in public metadata yet.
search_actors_publicMarket actors (23 filter keys)
Market actors (23 filter keys)
No parameter schema in public metadata yet.
search_power_consumption_publicPower consumption units (29 filter keys)
Power consumption units (29 filter keys)
No parameter schema in public metadata yet.
search_gas_production_publicGas production / gas storage (30 filter keys)
Gas production / gas storage (30 filter keys)
No parameter schema in public metadata yet.
search_gas_consumption_publicGas consumption units (30 filter keys)
Gas consumption units (30 filter keys)
No parameter schema in public metadata yet.
search_grid_connections_publicGrid connection points & locations (4 types, 12-20 filter keys)
Grid connection points & locations (4 types, 12-20 filter keys)
No parameter schema in public metadata yet.
get_local_timeConnection test (always available)
Connection test (always available)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MASTR_USERMaStR Marktakteur number (SOM/SEM...) for SOAP API access. Without credentials, only 7 public tools are available.
MASTR_TOKENsecretMaStR web service token (~540 chars) for SOAP API access. Enables 14 additional SOAP tools.
Readme
MaStR MCP Server
An MCP server for the Marktstammdatenregister (MaStR) — the German energy market master data register operated by the Bundesnetzagentur (Federal Network Agency). Enables Claude Desktop, Cowork, and Claude Code to directly access the German energy plant registry.
Deutsche Version / German version
Features
21 Tools — 14 SOAP (with credentials), 7 Public (always available)
Details
- Repository
- github.com/ulircs/mastr-mcp-server
- Website
- github.com/UliRCS/mastr-mcp-server
- Package
mastr-mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active