mcp-singapore

# 🇸🇬 Singapore MCP

Open-source Model Context Protocol servers, tools, prompts, resources, skills, and a CLI for
Singapore public data and services.

Built and maintained in Singapore by [Olano](https://olano.ai).

> Singapore MCP is an independent community project. It is not affiliated with, endorsed by, or an
> official product of the Singapore Government or any government agency. “Official” below describes
> an upstream data source, not this software.

## What ships

The monorepo separates provider access, reusable analysis, and user-facing workflows. Install the
aggregate server for the complete experience or a focused executable when you only need one
provider.

| Package                  | Role                                                                                                                      | Credentials                           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| `@olano/mcp-singapore`   | Aggregate server: every provider, catalog, insight, rail, finance, analytics, prompt, resource, and cross-agency workflow | Depends on the selected tool          |
| `@olano/mcp-datagov`     | data.gov.sg catalog, metadata, rows, and real-time feeds                                                                  | Optional data.gov.sg key              |
| `@olano/mcp-onemap`      | OneMap address search, reverse geocoding, and routing                                                                     | OneMap token                          |
| `@olano/mcp-lta`         | LTA DataMall bus arrivals, traffic, parking, and taxi feeds                                                               | LTA DataMall Account Key              |
| `@olano/mcp-weather`     | Forecasts, temperature, rainfall, and PSI                                                                                 | Optional data.gov.sg key              |
| `@olano/mcp-catalog`     | Curated Singapore datasets, 27 ACRA entity shards, and SingStat tables                                                    | Optional data.gov.sg key              |
| `@olano/mcp-insights-sg` | Prompt discovery, semantic routing, period-aware comparisons, and derived public-data insights                            | Depends on the routed source          |
| `@olano/mcp-rail-sg`     | MRT/LRT stations, codes, lines, exits, interchanges, and nearest-location tools                                           | None; OneMap token for address lookup |
| `@olano/mcp-finance-sg`  | Official mortgage reference-rate history and transparent local mortgage calculations                                      | Optional data.gov.sg key              |
| `@olano/mcp-analytics`   | Deterministic local statistics, comparisons, correlations, and text sparklines                                            | None                                  |
| `@olano/mcp-core`        | Shared transport, safe HTTP client, caching, retries, and MCP result helpers                                              | None                                  |
| `@olano/sg-cli`          | Search, inspect, route, and invoke the complete suite from a terminal                                                     | Depends on the selected tool          |

Focused stdio/HTTP executables are available for the aggregate, data.gov.sg, OneMap, LTA, weather,
and rail packages. The other packages are reusable registration libraries composed by the aggregate
server.

## Quick start

### MCP over stdio

```bash
npx -y @olano/mcp-singapore
```

Add it to a client that accepts the common `mcpServers` format:

```json
{
  "mcpServers": {
    "singapore": {
      "command": "npx",
      "args": ["-y", "@olano/mcp-singapore"],
      "env": {
        "DATA_GOV_SG_API_KEY": "optional-data-gov-key",
        "ONEMAP_TOKEN": "your-onemap-token",
        "LTA_DATAMALL_API_KEY": "your-lta-account-key",
        "OLANO_SG_CACHE_DIR": "/absolute/path/to/olano-sg-cache"
      }
    }
  }
}
```

Remove credentials you do not use and never commit real values. The server starts without any
credential; only tools that require one will return a missing-credential error.

### Smaller server-side tool profiles

The aggregate defaults to `all`. To reduce the tool definitions sent to a model, select a focused
production profile without losing MCP prompts or resources:

```bash
npx -y @olano/mcp-singapore --profile mobility
OLANO_SG_PROFILE=property npx -y @olano/mcp-singapore
```

The stable profiles are `mobility`, `property`, `business`, `economy`, `civic`, and `finance`.
`singapore_tool_profiles` is always available and returns each profile's prefix contract, exact live
tool count, and optional tool-name inventory. The same definitions power `olano-sg profiles` and
`olano-sg profile <name>`. An unknown profile fails at startup instead of silently falling back to
`all`.

### MCP over Streamable HTTP

```bash
npx -y @olano/mcp-singapore --transport http --host 127.0.0.1 --port 3000
```

The MCP endpoint is `http://127.0.0.1:3000/mcp`. Localhost is the default bind address. Add TLS,
authentication, request limits, and operational monitoring before exposing it to a network.

Focused servers use the same flags:

```bash
npx -y @olano/mcp-rail-sg --transport http --port 3001
npx -y @olano/mcp-weather --transport http --port 3002
```

### CLI

The npm package is `@olano/sg-cli`; its executable is `olano-sg`.

```bash
npx -y @olano/sg-cli list
npx -y @olano/sg-cli search rail
npx -y @olano/sg-cli examples
npx -y @olano/sg-cli examples property
npx -y @olano/sg-cli ask "Compare recent HDB resale prices in Bedok"
npx -y @olano/sg-cli datasets economy
npx -y @olano/sg-cli prompts
npx -y @olano/sg-cli tool weather_two_hour_forecast '{}'
npx -y @olano/sg-cli setup claude property
npx -y @olano/sg-cli doctor claude property
```

`ask` and its `query` alias use a deterministic local router. They recommend tools, extract obvious
arguments, and report missing inputs; they do not send the question to an external model or silently
execute the recommendation. Use `tool` for an explicit invocation.

### Claude Code plugins

This repository is also the installable Claude Code marketplace `olano`:

```text
/plugin marketplace add olano-ai/mcp-singapore
/plugin install olano-singapore-property@olano
```

Choose the complete `olano-singapore` plugin or a focused `property`, `mobility`, `business`,
`economy`, `civic`, or `finance` plugin. Each plugin starts the matching MCP profile automatically
and bundles focused Agent Skills. Optional API values are declared as sensitive Claude Code user
configuration. See [Claude Code plugins](docs/claude-code.md) for the complete matrix, CLI setup,
credential handling, updates, and validation.

### Codex and OpenAI plugins

The same repository is also an installable Codex plugin marketplace. Add it once, then use
`/plugins` to choose the complete plugin or a focused `property`, `mobility`, `business`, `economy`,
`civic`, or `finance` plugin:

```bash
codex plugin marketplace add olano-ai/mcp-singapore
```

Each repository plugin bundles focused Agent Skills and launches the matching local MCP profile.
Optional credentials are inherited from `DATA_GOV_SG_API_KEY`, `ONEMAP_TOKEN`, and
`LTA_DATAMALL_API_KEY`; no credential is stored in the plugin files. See
[Codex and OpenAI plugins](docs/openai-plugins.md) for the matrix and installation details.

Focused skills are also prepared for review in OpenAI's public Plugins Directory. Public
skills-only listings do not include the local stdio server: install from this repository when you
want the skills and MCP together.

## Example questions

Ask these in an MCP client, or use `olano-sg examples [category]` to browse the packaged prompt
catalog. Results depend on upstream coverage and any credentials shown above.

### Companies and ACRA

- “Find the official public ACRA records matching `Olano` and show the UEN and entity status.”
- “Look up this exact UEN across all ACRA shards; make any match uncertainty explicit.”
- “Compare monthly business formations and cessations, then calculate net formations.”
- “How have formations changed for two SSIC sectors over matched periods?”

### HDB and private property

- “Show recent 4-room HDB resale transactions in Bedok and calculate the median and quartiles.”
- “Compare HDB resale price per square metre between Tampines and Jurong East.”
- “Find HDB carparks whose address contains `Bishan` and group them by carpark type.”
- “Show bounded private-property transaction evidence for a project or district.”
- “Build a property-area brief for Queenstown with OneMap location context.”

The first example is a single MCP operation. `hdb_resale_stats` applies the exact town and flat-type
filters, selects the latest available matching month by default, returns the transaction rows, and
calculates the range, median, Q1, Q3, and price per square metre inside the server:

```bash
npx -y @olano/sg-cli tool hdb_resale_stats '{"town":"BEDOK","flatType":"4 ROOM"}'
```

Use `latestMonths`, `startMonth`, or `endMonth` to choose a different period. A direct dataset
download is not required. This operation is available in the aggregate server's `all` and
`property` profiles; it is not part of the focused `@olano/mcp-datagov` row-reader package.

### COE, buses, roads, parking, and taxis

- “What is the latest Category B COE premium, quota, number of bids, and bid-to-quota ratio?”
- “Show the last 12 Category A bidding exercises and changes from the prior premium.”
- “When are the next buses arriving at this bus stop?”
- “List current traffic incidents and nearby traffic-camera images.”
- “Show live LTA carpark availability and taxi availability.”

### MRT and LRT

- “What are the MRT/LRT codes and line connections for Paya Lebar?”
- “List every station on the Thomson-East Coast Line.”
- “Which offici