Skip to main content
Glama
io.github.mohammad-abbasi-sh/autobahn-mcp

io.github.mohammad-abbasi-sh/autobahn-mcp

README.md
# autobahn-mcp ๐Ÿ›ฃ๏ธ

mcp-name: io.github.mohammad-abbasi-sh/autobahn-mcp

Unofficial **read-only** MCP server for **[verkehr.autobahn.de](https://verkehr.autobahn.de)** โ€” German Autobahn data from the official verkehr.autobahn.de API: roadworks, closures, warnings, truck/car parking and EV charging stations per motorway. No key, no login.

> Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with verkehr.autobahn.de.

## For AI agents

Add to your MCP client config (stdio):

```json
{
  "mcpServers": {
    "autobahn": {
      "command": "uvx",
      "args": ["autobahn-mcp==0.1.0"]
    }
  }
}
```

Or run locally: `python -m autobahn_mcp.server` (needs `mcp<2`, `httpx`).

## Tools

| Tool | Description |
|------|-------------|
| `autobahn_roadworks` | Roadworks on a motorway โ€” `road` (e.g. "A1"), `limit` 1..50 |
| `autobahn_closures` | Closures on a motorway โ€” `road` (e.g. "A1"), `limit` 1..50 |
| `autobahn_warnings` | Warnings on a motorway โ€” `road` (e.g. "A100"), `limit` 1..50 |
| `autobahn_parking` | Truck/car parking on a motorway โ€” `road` (e.g. "A1"), `limit` 1..50 |
| `autobahn_ev_charging` | EV charging stations on a motorway โ€” `road` (e.g. "A1"), `limit` 1..50 |
| `autobahn_health` | Reachability probe (ok / blocked / error) โ€” one polite request |

## Notes

- All data comes from the **official verkehr.autobahn.de API** (free, no key).
- The API's `reststop`, `traffic` and `webcam` services return empty arrays on every probed motorway right now (A1/A3/A7/A9/A100, verified 2026-11-10), so they are not exposed as tools; `parking_lorry` covers parking areas instead.
- Roadworks and closures can be numerous (A1 currently lists 261 roadworks) โ€” use `limit` to cap the output.

Tests: 19/19 green (13 offline + 6 live, 2026-11-10).

## Development

```bash
python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
.venv/bin/pip install -e .
.venv/bin/python -m pytest tests/ -q
```

## License

MIT

---

Built by [Mohammad Abbasi](https://github.com/mohammad-abbasi-sh) โ€” [Almanibama](https://almanibama.ir) ยท [mabbasi.ir](https://mabbasi.ir)

TDQS

A3.6/5.0

Scored across 6 tools

Disambiguation5/5

Each tool maps to a single distinct data category on the Autobahn API: roadworks, closures, warnings, parking, EV charging, and a standalone health probe. There is no plausible way to confuse one with another, and the health tool is clearly separated as a non-listing diagnostic.

Naming Consistency5/5

All six tools follow an identical pattern: the `autobahn_` prefix plus a snake_case domain noun (roadworks, closures, warnings, parking, ev_charging, health). The convention is uniform and predictable, and the shared parameter signature (road, limit) reinforces it.

Tool Count5/5

Six tools is a tight, well-scoped set for a single-source road data server, with each tool earning its place as a separate endpoint. No redundant or speculative tools inflate the surface.

Completeness4/5

The surface covers the main Autobahn dataset categories (roadworks, closures, warnings, parking, EV charging) plus a connectivity check, which is solid lifecycle-free read coverage. Minor gaps remain: no tool to list valid road identifiers/reference data, and no webcam or general traffic-flow/charging-detail endpoint.