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

| Tool | Description | |------|-------------| | get_departures | Get real-time departures by stop name. Fuzzy-searches the database and fetches departures for matching stops. | | search_stops | Search for stops by name (e.g. "Amsterdam Centraal", "Schiphol"). Returns TPC codes, names, and coordinates. | | lines | List all public transport lines, or get details for a specific line. | | journey | Get journey/vehicle information including location data. |

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 near Schiphol"
• "Show me tram line 17 details"

Development

go test -v -race ./...   # run tests
go fmt ./...             # format
go vet ./...             # lint

Scrape CLI

The stop search database is populated by scraping all ~38K timing point codes from OVapi's /tpc/ endpoint:

DATABASE_URL=postgres://... go run ./cmd/scrape

Architecture

• Go with mcp-go for the MCP server
• Postgres with pg_trgm for fuzzy stop name search
• SSE transport for MCP communication
• Deployed on Runway

License

MIT