MCP server for the Basic Supply Service (BSS) — read-only debug tools
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"bss-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# bss-mcp [](LICENSE)       > [!WARNING] > This project is being discontinued in favor of a server-side MCP API. An [MCP](https://modelcontextprotocol.io/) server wrapping [`bssclient`](https://github.com/Hochfrequenz/bssclient.py), exposing read-only BSS investigation-order data to AI assistants (e.g. Claude Desktop) for debugging. Requires **Python 3.11+**. ## Tools | Tool | Description | |---|---| | `get_ermittlungsauftraege` | List investigation orders (`limit`, `offset`; `limit=0` uses the server default) | | `get_ermittlungsauftraege_by_malo` | Investigation orders for a Marktlokation ID | | `get_aufgabe_stats` | Task status statistics across all Aufgaben types | | `get_all_ermittlungsauftraege` | Fetches all investigation orders by iterating pages (`package_size` controls page size, default 100) | ## Installation ```bash pip install bss-mcp ``` For use with [Claude Desktop](https://claude.ai/download) or another MCP client, `pipx` installs the server as a standalone executable: ```bash pipx install bss-mcp ``` ## Configuration Set environment variables or place them in a `.env` file in the working directory from which the MCP server is launched (for Claude Desktop this is typically the user's home directory): | Variable | Required | Description | |---|---|---| | `BSS_URL` | Yes | Base URL of the BSS server, e.g. `https://basicsupply.example.de/` | | `BSS_AUTH_TY…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.