OVapi MCP Server

An MCP (Model Context Protocol) server that proxies the Dutch OVapi public transport APIs, with fuzzy stop search powered by Postgres.

Tools

Coverage

KV78turbo feed only: Dutch bus, tram, metro, ferry. Operators include GVB (Amsterdam), HTM (The Hague), RET (Rotterdam), Qbuzz, Connexxion (CXX), Arriva (ARR), EBS, Keolis, and regional concessions.

NS intercity/sprinter trains are not included — they run on their own Reisinformatie API, which this server doesn't proxy.

Data freshness & nulls

• Realtime vs planned. status = PLANNED means the vehicle hasn't yet reported — expected equals planned, delay_seconds is 0. DRIVING/ARRIVED/PASSED carry live updates; these are typically within 30 seconds of the vehicle's actual position. OFFROUTE and CANCEL surface operational disruptions.
• Commonly-null fields. platform, wheelchair_accessible, and number_of_coaches are realtime-enriched and often null for PLANNED departures. wheelchair_accessible="UNKNOWN" upstream is collapsed to null in the lean shape; number_of_coaches=0 is likewise reported as null. coord is null when upstream emits its sentinel coordinate (a stop lacks a real location) — roughly 20% of stops.
• Status enum. Upstream emits PLANNED | DRIVING | ARRIVED | PASSED | CANCEL | OFFROUTE verbatim (note: CANCEL, not CANCELLED). mode is lowercase upstream TransportType: bus | tram | metro | boat. Ferries appear as "boat"; lines accepts "ferry" as an input alias only.
• Line-filter ambiguity. When get_departures is called with a line filter and a stop returns an empty list, the response cannot distinguish "line does not serve this stop" from "line serves it but has no upcoming departures". Use search_stops + lines to check static coverage if that matters.
• Rate limits. None are documented by upstream; stops and lines are effectively static, so callers can cache search_stops and lines results. get_departures and journey should be treated as live.
• Verbose escape hatch. Every tool that returns a lean shape accepts verbose: true to pass the raw upstream body through unchanged — useful when debugging field mapping or pulling upstream fields we don't surface in the lean shape. Filters still apply in verbose mode.

Usage with Claude Desktop

Add to your Claude Desktop MCP config:

{
  "mcpServers": {
    "ovapi": {
      "type": "sse",
      "url": "https://ovapi-mcp-server.pqapp.dev/sse"
    }
  }
}

Then ask Claude things like:

• "What are the next departures from Amsterdam Centraal?"
• "Find stops within 400 m of 52.3676, 4.9041"
• "Sh

... View full README on GitHub