Singapore LTA DataMall MCP Server

🚌 Access Singapore's real-time transport data through AI assistants — bus arrivals, train crowding, traffic incidents, and more!

This is an enhanced fork of arjunkmrm/lta-mcp, rebuilt for self-hosted VPS deployment with zero-friction onboarding — no API key required to get started!

✨ Features

• 🔑 No API Key Required — Start using immediately with the server's default quota
• 🌐 Remote Access — Connect from any MCP client via HTTPS (not just local stdio)
• 🚀 One-Line Setup — Just add the URL to your MCP client config
• 📊 Real-Time Data — Bus arrivals, train crowding, traffic incidents, carpark availability
• 🔄 Auto-Deployment — Push to GitHub, automatically deploys to VPS

🚀 Quick Start

Step 1: Add to Your MCP Client

Copy this configuration to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "lta-datamall": {
      "transport": "streamable-http",
      "url": "https://mcp.techmavie.digital/ltadatamallsg/mcp"
    }
  }
}

Cursor/Windsurf (MCP settings):

{
  "lta-datamall": {
    "transport": "streamable-http",
    "url": "https://mcp.techmavie.digital/ltadatamallsg/mcp"
  }
}

Step 2: Start Asking!

Once configured, you can ask your AI assistant things like:

• "When is the next bus arriving at Marsiling Mall?" (the AI will look up the bus stop code automatically)
• "When is bus 143 arriving at bus stop 83139?"
• "How crowded is the North-South Line right now?"
• "Are there any train service disruptions?"
• "Show me traffic incidents on the expressways"
• "What's the carpark availability near Orchard?"

🔑 Using Your Own API Key (Optional)

By default, this server uses a shared LTA DataMall API key for convenience. To avoid rate limiting during heavy usage, you can register your own key via the MCP Key Service:

1. Visit mcpkeys.techmavie.digital and register your LTA DataMall API key
2. You'll receive a usr_XXXXXXXX key
3. Use it in your MCP client config:

{
  "mcpServers": {
    "lta-datamall": {
      "transport": "streamable-http",
      "url": "https://mcp.techmavie.digital/ltadatamallsg/mcp/usr_YOUR_KEY_HERE"
    }
  }
}

Alternatively, use the query parameter format: /mcp?api_key=usr_YOUR_KEY_HERE

Note: Registering an LTA API key is optional even with the key service — you can register without one and still use the server's default quota.

How to Get Your Own LTA DataMall API Key

1. Visit LTA DataMall
2. Click "Request for API Access" and fill in the provided form, then hit Submit button.
3. Once approved, find your API key in the email sent to you.
4. Register it at mcpkeys.techmavie.digital

🛠️ Available Tools

This MCP server provides 8 tools for accessing Singapore transport data:

Tool Details

🔍 bus_stop_search

Search for bus stop codes by name, road, or landmark. Use this to find the 5-digit bus stop code needed for bus_arrival.

The bus stop database (~5,500 stops) is loaded on first search and cached for 24 hours.

🚌 bus_arrival

Get real-time bus arrival information for any bus stop in Singapore.

🚇 station_crowding

Check how crowded MRT/LRT stations are right now.

📈 station_crowd_forecast

Get predicted crowding levels for the next few hours.

Supported Train Lines:

🚨 train_alerts

Get current train service alerts (no parameters required).

🅿️ carpark_availability

Get real-time carpark availability across Singapore (no parameters required).

⏱️ travel_times

Get estimated travel times on expressways (no parameters required).

🚧 traffic_incidents

Get current road incidents (no parameters required).

🔄 What's Changed from Original

This fork introduces major improvements over the original repository:

Key Changes

1. New HTTP Server (src/http-server.ts)

   • Express-based server with Streamable HTTP transport
   • Session management for concurrent users
   • Health check endpoint for monitoring

2. Zero-Friction Onboarding

   • Server provides default API quota
   • Users can start immediately without registration
   • Optional personal API key via MCP Key Service

3. Bus Stop Search (src/bus-stops-cache.ts)

   • Look up bus stop codes by name, road, or landmark
   • Lazy-loaded cache of all ~5,500 Singapore bus stops
   • No more web searching for bus stop codes

4. MCP Key Service Integration (src/utils/key-service.ts)

   • Centralized credential management via usr_xxx keys
   • Per-request server/transport isolation for key-service users
   • 60-second cache with request deduplication

5. Production Infrastructure

   • Docker + Docker Compose configuration
   • Nginx reverse proxy setup
   • GitHub Actions auto-deployment
   • Health checks and graceful shutdown
   • Firebase analytics with dashboard

🖥️ API Endpoints

🏠 Self-Hosting Guide

Want to host your own instance? Here's what you need:

Prerequisites

• VPS with Docker & Docker Compose
• Nginx with SSL (Let's Encrypt)
• Your own LTA DataMall API key

Deployment Files

Environment Variables

GitHub Secrets (for auto-deployment)

Set these in your repository settings:

• VPS_HOST — Your VPS IP address
• VPS_USERNAME — SSH username
• VPS_SSH_KEY — Private SSH key
• VPS_PORT — SSH port (usually 22)
• LTA_API_KEY — Your LTA DataMall API key
• KEY_SERVICE_URL — MCP Key Service resolve endpoint (optional)
• KEY_SERVICE_TOKEN — Bearer token for key service (optional)

📄 License

MIT License — See LICENSE file for details.

🙏 Credits

• Original MCP server by @arjunkmrm
• Data provided by LTA DataMall
• Enhanced by @hithereiamaliff