MaStR MCP Server — Claude Code MCP server: how to install
Connects Claude Code to the German energy registry Marktstammdatenregister. Searches generation units, consumption facilities, and network operators.
claude mcp add --env MASTR_USER=<MASTR_USER> --env MASTR_TOKEN=<MASTR_TOKEN> --transport stdio mastr-mcp-server -- uvx mastr-mcp-serverWhat MaStR MCP Server does
This server connects coding assistants to the German energy market master data register managed by Bundesnetzagentur. Seven public tools query units, consumers, gas infrastructure, and market participants over JSON without login. Users can filter records across twenty energy carriers like solar, wind, biomass, and hydrogen.
Fourteen advanced SOAP tools require official MaStR API credentials. These calls fetch combined unit dossiers covering EEG subsidies, permits, and storage details, alongside daily quota checks and date-based change logs. Running the server requires Python 3.10 or newer.
What it helps with
- query solar and wind installations by postcode and capacity
- fetch single-call unit dossiers with EEG permits and battery storage
- track registry updates and unit modifications since a specific date
- inspect daily SOAP request limits and remaining quotas
- filter electricity grid operators across federal states
Example prompts for the agent
- "List all solar installations registered in postcode 49074"
- "Retrieve technical and subsidy records for unit SEE966095906064"
- "Check current daily SOAP quota usage for the MaStR account"
How to install MaStR MCP Server
Platform CLI
claude mcp add --env MASTR_USER=<MASTR_USER> --env MASTR_TOKEN=<MASTR_TOKEN> --transport stdio mastr-mcp-server -- uvx mastr-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mastr-mcp-server <command>
Platform CLI
codex mcp add mastr-mcp-server --env MASTR_USER=<MASTR_USER> --env MASTR_TOKEN=<MASTR_TOKEN> -- uvx mastr-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mastr-mcp-server <command>
Config file
{
"mcpServers": {
"mastr-mcp-server": {
"command": "uvx",
"args": [
"mastr-mcp-server"
],
"env": {
"MASTR_USER": "<MASTR_USER>",
"MASTR_TOKEN": "<MASTR_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mastr-mcp-server <command>
Config file
{
"servers": {
"mastr-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"mastr-mcp-server"
],
"env": {
"MASTR_USER": "<MASTR_USER>",
"MASTR_TOKEN": "<MASTR_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mastr-mcp-server <command>
Platform CLI
gemini mcp add -e MASTR_USER=<MASTR_USER> -e MASTR_TOKEN=<MASTR_TOKEN> mastr-mcp-server uvx mastr-mcp-serverReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mastr-mcp-server <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MaStR MCP Server
How to install MaStR MCP Server in Claude Code?
Run claude mcp add --env MASTR_USER=<MASTR_USER> --env MASTR_TOKEN=<MASTR_TOKEN> --transport stdio mastr-mcp-server -- uvx mastr-mcp-server in your terminal. You must have Python 3.10 or higher installed.
What does MaStR MCP Server do?
It allows AI assistants to query Germany's official energy market registry directly. Agents can search generation assets, power consumers, gas facilities, and grid operators through public JSON or authenticated SOAP endpoints.
Does MaStR MCP Server require an account?
Not for basic use. Seven search tools operate publicly without credentials. Credentials are only required for the fourteen SOAP tools that pull full technical dossiers, catalog values, and quota metrics.
