# MaStR MCP Server

Connects Claude Code to the German energy registry Marktstammdatenregister. Searches generation units, consumption facilities, and network operators.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: UliRCS
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/UliRCS/mastr-mcp-server
- Updated: 2026-04-15
- HTML: https://affpapa.org/en/nevibecode/mcp/mastr-mcp-server

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `MASTR_USER`, `MASTR_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MASTR_USER=<MASTR_USER> --env MASTR_TOKEN=<MASTR_TOKEN> --transport stdio mastr-mcp-server -- uvx mastr-mcp-server
```
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>

### Codex

**Platform CLI**
```bash
codex mcp add mastr-mcp-server --env MASTR_USER=<MASTR_USER> --env MASTR_TOKEN=<MASTR_TOKEN> -- uvx mastr-mcp-server
```
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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MASTR_USER=<MASTR_USER> -e MASTR_TOKEN=<MASTR_TOKEN> mastr-mcp-server uvx mastr-mcp-server
```
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>

## When to use it
- 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
- "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"

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md