{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_m7athbneps55","handle":"bss-mcp","url":"https://wellknown.network/agents/bss-mcp","links":{"self":"https://wellknown.network/agents/bss-mcp/record.json","html":"https://wellknown.network/agents/bss-mcp","markdown":"https://wellknown.network/agents/bss-mcp/record.md","api":"https://wellknown.network/api/v1/agents/bss-mcp","status":"https://wellknown.network/api/v1/agents/bss-mcp/status","claim":"https://wellknown.network/agents/bss-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bss-mcp/claim.json","badge":"https://wellknown.network/agents/bss-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/bss-mcp/history","tools":"https://wellknown.network/api/v1/agents/bss-mcp/tools"},"ard":{"identifier":"urn:air::server:bss-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bss-mcp","summary":"MCP server for the Basic Supply Service (BSS) — read-only debug tools","description":"# bss-mcp\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n![Python Versions (officially) supported](https://img.shields.io/pypi/pyversions/bss-mcp.svg)\n![Pypi status badge](https://img.shields.io/pypi/v/bss-mcp)\n![Unittests status badge](https://github.com/Hochfrequenz/bss-mcp/workflows/Unittests/badge.svg)\n![Coverage status badge](https://github.com/Hochfrequenz/bss-mcp/workflows/Coverage/badge.svg)\n![Linting status badge](https://github.com/Hochfrequenz/bss-mcp/workflows/Linting/badge.svg)\n![Black status badge](https://github.com/Hochfrequenz/bss-mcp/workflows/Formatting/badge.svg)\n\n> [!WARNING]\n> This project is being discontinued in favor of a server-side MCP API.\n\nAn [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.\n\nRequires **Python 3.11+**.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `get_ermittlungsauftraege` | List investigation orders (`limit`, `offset`; `limit=0` uses the server default) |\n| `get_ermittlungsauftraege_by_malo` | Investigation orders for a Marktlokation ID |\n| `get_aufgabe_stats` | Task status statistics across all Aufgaben types |\n| `get_all_ermittlungsauftraege` | Fetches all investigation orders by iterating pages (`package_size` controls page size, default 100) |\n\n## Installation\n\n```bash\npip install bss-mcp\n```\n\nFor use with [Claude Desktop](https://claude.ai/download) or another MCP client, `pipx` installs the server as a standalone executable:\n\n```bash\npipx install bss-mcp\n```\n\n## Configuration\n\nSet 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):\n\n| Variable | Required | Description |\n|---|---|---|\n| `BSS_URL` | Yes | Base URL of the BSS server, e.g. `https://basicsupply.example.de/` |\n| `BSS_AUTH_TY…","publisher":null,"homepage":null,"repository":null,"version":"0.2.2","license":"MIT","protocols":["mcp"],"tags":["basicsupply","bss","mcp"],"pricing":null,"endpoints":[{"url":"pypi:bss-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"code.debugging","name":"Debugging","confidence":0.802,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"bss-mcp","registry":"pypi","observedAt":"2026-11-02T23:25:20.686Z","publishedAt":"2026-08-19T07:32:07.688293Z","latestVersion":"0.2.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bss-mcp","url":"https://pypi.org/project/bss-mcp/","firstSeenAt":"2026-09-09T10:27:57.424Z","fetchedAt":"2026-11-02T23:23:09.030Z","normalizedAt":"2026-11-02T23:23:09.030Z"}]},"firstSeenAt":"2026-09-09T10:27:57.424Z","updatedAt":"2026-11-02T23:25:20.686Z"}