vnbdigital-mcp

MCP server for accessing the vnbdigital.de database of German distribution grid operators (Verteilnetzbetreiber, VNB).

Built on top of the vnbdigital-client library, which also ships a standalone CLI and can be used directly as a Python library in your own code. This repository adds an MCP interface on top, making the data available to AI assistants and agents via the Model Context Protocol (MCP).

Looking for the Python library or CLI? Head over to vnbdigital-client.

Tools

vnbdigital.de lookups

BDEW register lookups (bdew-codes.de)

Note: Company names in the BDEW register do not always match those on vnbdigital.de. Use both sources together for cross-referencing.

Installation

Prerequisites

• Python ≥ 3.12
• uv

Install dependencies

uv sync

Start the server (development)

uv run vnbdigital-mcp
# or
uv run python -m vnbdigital_mcp.server

Test with MCP Inspector

uv run mcp dev src/vnbdigital_mcp/server.py

Configuration in VS Code / Claude Desktop

Add the server to your MCP configuration (.vscode/mcp.json or claude_desktop_config.json):

Install from PyPI (recommended):

{
  "servers": {
    "vnbdigital": {
      "command": "bash",
      "args": [
        "-l",
        "-c",
        "uvx vnbdigital-mcp"
      ]
    }
  }
}

Install from GitHub (latest unreleased):

{
  "servers": {
    "vnbdigital": {
      "command": "bash",
      "args": [
        "-l",
        "-c",
        "uvx --from git+https://github.com/the78mole/vnbdigital-mcp.git vnbdigital-mcp"
      ]
    }
  }
}

Local development (workspace checkout):

{
  "servers": {
    "vnbdigital": {
      "command": "bash",
      "args": [
        "-l",
        "-c",
        "uv --directory ${workspaceFolder} run vnbdigital-mcp"
      ]
    }
  }
}

Note: bash -l loads the login shell profile, which ensures uvx/uv are found in ~/.local/bin without any additional env configuration.

Environment Variables

Example Queries

Operator by ID

Known example IDs:
- 179  → ESTW - Erlanger Stadtwerke AG
- 180  → Stadtwerke Eschwege GmbH
- 99   → Stadtwerke Bramsche GmbH

Operators for a location

get_nsp_operator and get_msp_operator accept either a 5-digit postcode or a "lat,lon" coordinate string:

get_nsp_operator("97816")              # by postcode
get_nsp_operator("49.998037,9.58033")  # by coordinates

BDEW lookup

bdew_lookup_by_company_code(660188)          # → A&A Stromallianz GmbH
bdew_lookup_by_market_code("9903445000000")  # → same company, one market function
bdew_get_market_function_detail(141)         # → address/contact for that market function

Local Development

# Set up project environment
uv sync

# Linting & formatting
uv run ruff format .
uv run ruff check --fix .

# Tests
uv run pytest

Related Projects

License

MIT