API & AI Integration Reference

⚡ Overview & Base URL

All SingaNow APIs are served over HTTPS, return UTF-8 JSON payloads with standard HTTP response status codes, and allow cross-origin requests (CORS). No API keys or registration tokens are required for public endpoints.

SingaNow natively implements the Universal Tool Calling Protocol (UTCP) v1.0.1. Unlike proxy-based architectures that introduce wrapper processes and network hops, UTCP allows autonomous AI agents to discover declarative JSON manuals and invoke tools directly via high-speed native HTTP with 0ms proxy tax.

curl -s -X POST "https://singanow.com/utcp/tools/get_singapore_bus_arrivals" \
  -H "Content-Type: application/json" \
  -d '{"bus_stop_code": "01012"}'

SingaNow provides a production-grade Model Context Protocol (MCP) server enabling AI agents (Claude Desktop, Cursor, Windsurf, LangChain, OpenAI) to discover and execute real-time Singapore transit, environment, traffic, and ACRA registry tools directly via Server-Sent Events (SSE) or stateless JSON-RPC 2.0.

{
  "mcpServers": {
    "singanow": {
      "url": "https://singanow.com/mcp/sse"
    }
  }
}

Copy-paste ready tool definitions compatible with OpenAI Function Calling, Anthropic Claude Tools, Google Gemini, and LangChain. For formal RFC Draft 2020-12 JSON response schemas, see llms-full.txt:

[
  {
    "type": "function",
    "function": {
      "name": "get_singapore_bus_arrivals",
      "description": "Fetch live arrival times, crowding status (SEA: Seats Available, SDA: Standing Available, LSD: Limited Standing), vehicle deck type (SD/DD/BD), and wheelchair accessibility for the next 3 arriving buses at any 5-digit Singapore bus stop.",
      "parameters": {
        "type": "object",
        "properties": {
          "bus_stop_code": {
            "type": "string",
            "description": "5-digit zero-padded Singapore Bus Stop Code (e.g. '01012', '09048', '67009')."
          },
          "service_no": {
            "type": "string",
            "description": "Optional specific bus service number to filter (e.g. '190', '65', '10')."
          }
        },
        "required": ["bus_stop_code"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "plan_singapore_bus_journey",
      "description": "Plan a public bus journey in Singapore between any two locations. Resolves 5-digit stop codes, GPS lat/lng coordinates, or landmark/stop names. Returns direct and 1-transfer itineraries with duration, stop count, and live arrival times for the first boarding leg.",
      "parameters": {
        "type": "object",
        "properties": {
          "origin": {
            "type": "string",
            "description": "Starting location: 5-digit bus stop code (e.g. '01012'), coordinates ('1.2968,103.8525'), or landmark/road name ('Victoria St', 'City Hall')."
          },
          "destination": {
            "type": "string",
            "description": "Destination location: 5-digit bus stop code (e.g. '09048'), coordinates ('1.3045,103.8331'), or landmark/road name ('Orchard Stn', 'Tang Plaza')."
          }
        },
        "required": ["origin", "destination"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "find_nearby_singapore_bus_stops",
      "description": "Find closest public bus stops from GPS coordinates in Singapore, sorted by walking distance with calling bus services.",
      "parameters": {
        "type": "object",
        "properties": {
          "latitude": {
            "type": "number",
            "description": "WGS84 Latitude between 1.15 and 1.48 (e.g. 1.2968)."
          },
          "longitude": {
            "type": "number",
            "description": "WGS84 Longitude between 103.58 and 104.05 (e.g. 103.8525)."
          },
          "radius_km": {
            "type": "number",
            "description": "Search radius in km (default 1.2, max 10.0)."
          },
          "limit": {
            "type": "integer",
            "description": "Maximum number of bus stops to return (default 20, max 50)."
          }
        },
        "required": ["latitude", "longitude"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "search_singapore_bus_stops",
      "description": "Search Singapore bus stops by road name, landmark name, or 5-digit stop code.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Search term (e.g. 'Orchard', 'Bedok Int', 'Victoria St', '01012')."
          },
          "limit": {
            "type": "integer",
            "description": "Max results to return (default 30, max 100)."
          }
        },
        "required": ["query"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_bus_service_details",
      "description": "Retrieve full route details, operating operators, directions, and ordered stop sequences for a specific Singapore bus service.",
      "parameters": {
        "type": "object",
        "properties": {
          "service_no": {
            "type": "string",
            "description": "Bus service number (e.g. '190', '65', '14', '960e')."
          }
        },
        "required": ["service_no"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_bus_route_stops",
      "description": "Retrieve the sequential list of bus stops, cumulative kilometer distance, and weekday/weekend operating timetables for a bus line and direction.",
      "parameters": {
        "type": "object",
        "properties": {
          "service_no": {
            "type": "string",
            "description": "Bus service number (e.g. '65')."
          },
          "direction": {
            "type": "integer",
            "enum": [1, 2],
            "description": "Direction 1 (outbound) or 2 (inbound). Default: 1."
          }
        },
        "required": ["service_no"]
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_planned_bus_changes",
      "description": "Retrieve scheduled future bus route diversions, road closures, and route adjustments across Singapore.",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_weather",
      "description": "Retrieve live Singapore weather: 2-hour regional nowcast across 47 towns, 24-hour national forecast with sub-day periods, 4-day outlook, and live station readings (temperature, humidity, wind, rainfall).",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_environment_air_quality",
      "description": "Get real-time Singapore 24-hour PSI air quality ratings, 1-hour PM2.5 readings across 5 regions (North, South, East, West, Central), and current UV index with hourly trend.",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_traffic_cameras",
      "description": "Retrieve live expressway traffic camera image snapshot URLs and coordinates across all major expressways (PIE, CTE, AYE, BKE, etc.) and Malaysia border checkpoints (Woodlands Causeway, Tuas Second Link).",
      "parameters": {
        "type": "object",
        "properties": {}
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_carpark_availability",
      "description": "Check live parking lot vacancy and distance across 2,600+ HDB, URA, and LTA shopping mall carparks in Singapore.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Filter by carpark code (e.g. 'ACB'), mall/building name (e.g. 'Suntec', 'Orchard'), or estate."
          },
          "lat": {
            "type": "number",
            "description": "User GPS latitude for nearby distance ranking."
          },
          "lng": {
            "type": "number",
            "description": "User GPS longitude for nearby distance ranking."
          },
          "radius": {
            "type": "number",
            "description": "Search radius in km (0.1 to 15.0 km, default 1.5)."
          },
          "agency": {
            "type": "string",
            "enum": ["ALL", "HDB", "LTA", "URA"],
            "description": "Filter by agency. Default: 'ALL'."
          },
          "lot_type": {
            "type": "string",
            "enum": ["ALL", "C", "Y", "H"],
            "description": "Vehicle type: 'C' (Cars), 'Y' (Motorcycles), 'H' (Heavy). Default: 'ALL'."
          }
        }
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "get_singapore_ev_charging_points",
      "description": "Search real-time EV charging stations and live plug availability across SP Mobility, CDG ENGIE, Charge+, Shell Recharge, Tesla Superchargers, and HDB hubs in Singapore.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Station name, shopping mall, operator, or 6-digit postal code (e.g. 'Orchard', 'Tesla', '529510')."
          },
          "operator": {
            "type": "string",
            "enum": ["ALL", "SP_MOBILITY", "CDG_ENGIE", "CHARGE_PLUS", "SHELL", "TESLA", "KEPPEL_VOLT", "TOTALENERGIES", "GO_CITY_ENERGY"],
            "description": "Filter operator network."
          },
          "speed": {
            "type": "string",
            "enum": ["ALL", "ULTRA_FAST", "FAST_DC", "AC_NORMAL"],
            "description": "Filter charging speed tier: ULTRA_FAST (>=120kW), FAST_DC (50-100kW), AC_NORMAL (7.4-22kW)."
          },
          "connector": {
            "type": "string",
            "enum": ["ALL", "CCS2", "TYPE2", "TESLA"],
            "description": "Filter plug connector type."
          },
          "lat": {
            "type": "number",
            "description": "GPS latitude for nearby distance ranking."
          },
          "lng": {
            "type": "number",
            "description": "GPS longitude for nearby distance ranking."
          },
          "radius": {
            "type": "number",
            "description": "Search radius in km (0.1 to 25.0 km, default 2.5)."
          },
          "available_only": {
            "type": "boolean",
            "description": "Set to true to only return stations with at least 1 currently available plug."
          }
        }
      }
    }
  },
  {
    "type": "function",
    "function": {
      "name": "search_singapore_acra_entity",
      "description": "Search Singapore registered companies, businesses, LLPs, societies, and healthcare institutions across ACRA regulatory registries by entity name or UEN.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Company name or UEN (e.g. 'DBS Bank', 'Grab', '201812345A')."
          },
          "page": {
            "type": "integer",
            "description": "Page number (24 entities per page, default: 1)."
          }
        },
        "required": ["query"]
      }
    }
  }
]

💻 Code Integration Examples

// Modern TypeScript / JavaScript Fetch Examples
const BASE_URL = "https://singanow.com/api";

// 1. Fetch Real-Time Bus Arrivals
async function getBusArrivals(busStopCode: string, serviceNo?: string) {
  const url = new URL(`${BASE_URL}/bus/arrival`);
  url.searchParams.set("stop", busStopCode);
  if (serviceNo) url.searchParams.set("service", serviceNo);
  const res = await fetch(url.toString());
  return res.json();
}

// 2. Fetch Live EV Charging Stations
async function getEVStations(query = "Orchard", operator = "ALL") {
  const url = new URL(`${BASE_URL}/ev`);
  if (query) url.searchParams.set("query", query);
  if (operator !== "ALL") url.searchParams.set("operator", operator);
  const res = await fetch(url.toString());
  return res.json();
}

// 3. Fetch Nearby Parking Vacancy
async function getCarparksNearGPS(lat: number, lng: number, radius = 1.5) {
  const url = new URL(`${BASE_URL}/carparks`);
  url.searchParams.set("lat", String(lat));
  url.searchParams.set("lng", String(lng));
  url.searchParams.set("radius", String(radius));
  const res = await fetch(url.toString());
  return res.json();
}

// 4. Plan Public Bus Journey
async function planBusJourney(from: string, to: string) {
  const url = new URL(`${BASE_URL}/bus/plan`);
  url.searchParams.set("from", from);
  url.searchParams.set("to", to);
  const res = await fetch(url.toString());
  return res.json();
}

// Example usage:
const evData = await getEVStations("Orchard");
console.log(`Found ${evData.total} EV stations. Available plugs: ${evData.summary.totalAvailable}`);

import requests

BASE_URL = "https://singanow.com/api"

def get_bus_arrivals(stop_code: str, service_no: str = None):
    params = {"stop": stop_code}
    if service_no:
        params["service"] = service_no
    resp = requests.get(f"{BASE_URL}/bus/arrival", params=params, timeout=10)
    resp.raise_for_status()
    return resp.json()

def get_ev_stations(query: str = "Orchard", operator: str = "ALL"):
    params = {"query": query, "operator": operator}
    resp = requests.get(f"{BASE_URL}/ev", params=params, timeout=10)
    resp.raise_for_status()
    return resp.json()

def get_carparks(query: str = "Suntec"):
    resp = requests.get(f"{BASE_URL}/carparks", params={"query": query}, timeout=10)
    resp.raise_for_status()
    return resp.json()

def search_acra(query: str):
    resp = requests.get(f"{BASE_URL}/acra", params={"q": query}, timeout=10)
    resp.raise_for_status()
    return resp.json()

def plan_bus_journey(origin: str, destination: str):
    params = {"from": origin, "to": destination}
    resp = requests.get(f"{BASE_URL}/bus/plan", params=params, timeout=10)
    resp.raise_for_status()
    return resp.json()

# Test
if __name__ == "__main__":
    ev = get_ev_stations("Orchard")
    print(f"Found {ev['total']} EV stations ({ev['summary']['totalAvailable']} plugs available)")
    for st in ev["stations"]:
        print(f" - {st['name']} ({st['operator_name']}): {st['available']}/{st['total_plugs']} plugs [{st['status']}]")

# 1. EV Charging Stations & Live Plug Availability
curl -s "https://singanow.com/api/ev?query=Orchard" | jq .

# 2. Carpark Lot Availability & Vacancy
curl -s "https://singanow.com/api/carparks?query=Orchard" | jq .

# 3. Live Bus Arrivals at Hotel Grand Pacific
curl -s "https://singanow.com/api/bus/arrival?stop=01012" | jq .

# 4. ACRA Corporate UEN Search
curl -s "https://singanow.com/api/acra?q=Singtel" | jq .

# 5. Live Weather & Regional Forecasts
curl -s "https://singanow.com/api/weather" | jq .

# 6. Air Quality PSI & PM2.5
curl -s "https://singanow.com/api/environment" | jq .

# 7. Nearby Bus Stops from GPS coordinates
curl -s "https://singanow.com/api/bus/nearby?lat=1.2968&lng=103.8525" | jq .

# 8. Plan Bus Transit Journey
curl -s "https://singanow.com/api/bus/plan?from=01012&to=09048" | jq .