@altronis/sgdata-mcp

A Singapore government data MCP server. 74 tools, 24 curated datasets, CLI mode, data visualization, cross-dataset queries, natural language queries. Covering ACRA + HDB + URA + COE + CPI + GDP + employment + IRAS + MAS FX + MOE + ECDA + tourism + retail + population + crime + health + energy + hawkers. Local SQLite cache. No API keys. Runs anywhere MCP runs.

@altronis/sgdata-mcp is an MCP server that lets Claude, Cursor, Continue, or any other MCP-compatible client query Singapore government open data directly from data.gov.sg — corporate registry, real estate, labour, prices, public services, capital flows, crime, health, demographics, energy, and more.

It runs as a local stdio process on your machine. No hosted backend, no API keys, no rate limits. First-time queries fetch straight from data.gov.sg; repeat queries hit a local SQLite cache at ~/.sgdata-mcp/sgdata.sqlite.

v0.3.2 highlights: Monthly business formations + cessations + net growth tools via SingStat Table Builder. Track month-by-month company creation vs closure for any SSIC industry. 74 tools total.

v0.3.1: Annual formation counts by industry via SingStat Table Builder.

v0.3.0: 8 new datasets, CLI mode, ASCII sparkline visualization, cross-dataset correlation queries, natural language query routing.

---

What you can ask Claude

Drop this server into Claude Desktop and you immediately unlock questions like:

• "Find all AI/ML companies (SSIC 62019) incorporated in Singapore in 2025."
• "What's the median resale price of 4-room HDB flats in Punggol over the last 6 months?"
• "What is the latest COE Category A premium, and how has it trended over 12 months?"
• "How many dengue cases were reported this week?"
• "What's Singapore's unemployment rate? Show me the trend."
• "Compare GDP growth vs crime rates over the last 5 years."
• "How many scam cases were recorded in 2024?"
• "What is Singapore's population and how fast is it growing?"
• "How much electricity did Singapore generate last month?"
• "Are birth rates declining? Show me the last 12 months."
• "What were Singapore's tourism receipts by component?"
• "Find hawker centres near Tampines."
• "Which CPI categories are running hottest vs headline inflation?"
• "Look up DBS Bank by UEN 196800306E."

Your model picks the right tool, fills in the filters, and returns structured rows. You never write a URL.

---

Quick start

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "sg-data": {
      "command": "npx",
      "args": ["-y", "@altronis/sgdata-mcp"]
    }
  }
}

Restart Claude Desktop. The 74 sg_* tools appear in the MCP tools menu.

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "sg-data": {
      "command": "npx",
      "args": ["-y", "@altronis/sgdata-mcp"]
    }
  }
}

Claude Code

claude mcp add sg-data -- npx -y @altronis/sgdata-mcp

CLI mode (new in v0.3.0)

Query Singapore data directly from the terminal — no MCP client needed:

# Natural language query
npx @altronis/sgdata-mcp query "What is Singapore's unemployment rate?"
npx @altronis/sgdata-mcp query "How many dengue cases this week?"
npx @altronis/sgdata-mcp query "Latest COE prices"

# Call a specific tool
npx @altronis/sgdata-mcp tool sg_crime_compare '{"year":"2024"}'
npx @altronis/sgdata-mcp tool sg_hawker_search '{"query":"bedok"}'

# List available tools and datasets
npx @altronis/sgdata-mcp list
npx @altronis/sgdata-mcp datasets

Standalone (kick the tyres)

# Run the MCP server directly
npx -y @altronis/sgdata-mcp

# Smoke-test via stdio
printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | npx -y @altronis/sgdata-mcp

---

What's in the box

Datasets (24)

#	Dataset	Agency	Tools
1	ACRA Corporate Entities (~2M+)	ACRA	3
2	HDB Resale Flat Prices (2017+)	HDB	2
3	COE Bidding Results	LTA	3
4	MOE Schools	MOE	3
5	HDB Carpark Information	HDB	3
6	GDP YoY Growth (quarterly)	SingStat	3
7	Consumer Price Index (monthly)	SingStat	3
8	MOM Median Gross Monthly Income	MOM	2
9	Employment by Sector (annual)	SingStat	3
10	URA Private Residential Transactions	URA	3
11	International Visitor Arrivals	STB	3
12	Retail Sales Index (monthly)	SingStat	3
13	MAS Exchange Rates (monthly avg)	MAS	3
14	IRAS Tax Collection (annual)	IRAS	3
15	ECDA Childcare & Kindergarten Centres	ECDA	3
16	Unemployment Rate (quarterly)	MOM	2
17	Population Indicators (annual)	SingStat	2
18	Infectious Disease Cases (weekly)	MOH	3
19	Electricity Generation (monthly)	EMA	2
20	Live-Births by Sex/Ethnicity (monthly)	SingStat	2
21	Crime Cases Recorded (annual)	SPF	3
22	Tourism Receipts (annual)	STB	2
23	Government Hawker Centres	NEA	2
24	Business Entity Formations & Cessations	ACRA/DOS	6

Plus 3 generic fallback tools, 1 visualization tool, 2 cross-dataset tools, and 1 natural language query tool. Total: 74 tools.

---

New in v0.3.0

Data visualization — sg_visualize

Generate ASCII sparkline charts and summary statistics from any time series. Returns sparklines, min/max/mean/latest, period-over-period change, and chart-ready JSON for frontend rendering.

SG Unemployment Rate (SA): ▁█████▄▄████
Latest: 2 % | Change: +0 (+0%) | Range: 1.8–2 | Mean: 1.97

Cross-dataset queries — sg_cross_dataset

Compare any two datasets side-by-side over time. Automatically aligns different time granularities (monthly, quarterly, annual):

{
  "dataset_a": "cpi_monthly",
  "dataset_b": "retail_sales",
  "limit": 5
}

Returns aligned rows with both values for correlation analysis.

Natural language queries — sg_ask

Ask questions in plain English — the tool routes to the right dataset automatically:

"What is Singapore's unemployment rate?" → sg_unemployment_latest
"How many dengue cases?" → sg_disease_latest
"COE prices" → sg_coe_latest
"Crime statistics" → sg_crime_latest

CLI mode — no MCP client needed

Query data directly from your terminal:

sgdata-cli query "Singapore population growth"
sgdata-cli tool sg_crime_compare '{"year":"2024"}'
sgdata-cli datasets

---

Tools (74)

Meta tools

Tool	Description
sg_ask	Natural language query — ask any question about Singapore data in plain English
sg_visualize	ASCII sparkline + summary stats + chart-ready JSON from any numeric series
sg_cross_dataset	Compare two datasets over time with automatic period alignment
sg_list_datasets	List all 24 curated datasets with IDs, names, and agencies

Generic tools — any data.gov.sg dataset

Tool	Description
sg_search_datasets	Full-text discovery across all data.gov.sg datasets
sg_dataset_schema	Column labels, agency, format for any dataset ID
sg_dataset_query	Query any dataset with filters, auto-downloads and caches

Curated dataset tools (67)

ACRA (3): sg_acra_search_entities, sg_acra_get_entity, sg_acra_formations_by_ssic

HDB Resale (2): sg_hdb_resale_search, sg_hdb_resale_stats

COE (3): sg_coe_latest, sg_coe_history, sg_coe_demand_supply

MOE Schools (3): sg_moe_search_schools, sg_moe_school_by_name, sg_moe_schools_near

HDB Carparks (3): sg_hdb_carpark_lookup, sg_hdb_carparks_by_address, sg_hdb_carparks_by_type

GDP (3): sg_gdp_latest, sg_gdp_history, sg_gdp_industry_compare

CPI (3): sg_cpi_latest, sg_cpi_history, sg_cpi_yoy

Income (2): sg_median_income_lookup, sg_median_income_history

Employment (3): sg_employment_by_sector, sg_employment_sector_history, sg_employment_growth

URA Property (3): sg_ura_private_txn_latest, sg_ura_private_txn_history, sg_ura_new_sale_pipeline

Visitor Arrivals (3): sg_visitors_latest, sg_visitors_history, sg_visitors_top_sources

Retail Sales (3): sg_retail_sales_latest, sg_retail_sales_history, sg_retail_sales_yoy

MAS FX (3): sg_fx_rate, sg_fx_history, sg_fx_basket

IRAS Tax (3): sg_iras_collection, sg_iras_collection_history, sg_iras_tax_mix

ECDA Childcare (3): sg_ecda_search_centres, sg_ecda_centres_near, sg_ecda_vacancy_summary

Unemployment (2): sg_unemployment_latest, sg_unemployment_history

Population (2): sg_population_latest, sg_population_history

Disease/Health (3): sg_disease_latest, sg_disease_trend, sg_disease_list

Electricity (2): sg_electricity_latest, sg_electricity_history

Births (2): sg_births_latest, sg_births_history

Crime (3): sg_crime_latest, sg_crime_history, sg_crime_compare

Tourism (2): sg_tourism_latest, sg_tourism_history

Hawker Centres (2): sg_hawker_search, sg_hawker_stats

Business Formations & Cessations (6): sg_formations_latest, sg_formations_history, sg_formations_compare, sg_formations_monthly, sg_cessations_monthly, sg_net_formations

---

Architecture

┌─────────────────┐    spawn    ┌──────────────────────┐
│ Claude Desktop  │ ──────────▶ │ sgdata-mcp (node)   │
│ /Cursor/Code    │ ◀── stdio ─▶│ runs on your machine │
└─────────────────┘             └──────┬───────────────┘
                                       │ HTTPS (first fetch only)
                                       ▼
                              api.data.gov.sg/v2/...
                                       │
                                       ▼
                            ~/.sgdata-mcp/sgdata.sqlite
                            (shared local SQLite cache)

---

Caching policy

• Location. ~/.sgdata-mcp/sgdata.sqlite by default.
• Override. Set SGDATA_MCP_CACHE_DIR=/custom/path.
• Refresh cadence. Per-dataset — daily for ECDA, weekly for HDB/COE/disease, monthly for ACRA/CPI/GDP/FX/retail/visitors/births/electricity, quarterly for MOE/URA/employment/unemployment, annually for IRAS/income/crime/population/tourism.
• Wipe. rm ~/.sgdata-mcp/sgdata.sqlite — next query rebuilds.
• Disk. ~480 MB with ACRA, under 20 MB without.

---

Comparison

	@altronis/sgdata-mcp	sgdata-mcp (by vdineshk)
Tools	74	5
Coverage	Corporate registry, real estate, prices, labour, tourism, FX, tax, public services, crime, health, demographics, energy	Real-time weather, traffic, carpark availability
CLI mode	Yes	No
Data visualization	Yes (sparklines + chart-ready JSON)	No
Cross-dataset queries	Yes	No
NL query routing	Yes	No
Caching	Yes (SQLite)	No
API keys	None	None

Both packages complement each other — install both for the full picture.

---

Disclaimer

This tool fetches and caches data from data.gov.sg. While we take care to preserve data integrity during ingestion, you should independently verify any data before making decisions based on it.

• Data accuracy. All data originates from Singapore government agencies via data.gov.sg. We do not alter source values, but column mappings, wide-to-long transformations, and caching may introduce discrepancies. Always cross-check critical figures against the official source.
• Not professional advice. This tool is not a substitute for professional financial, legal, medical, or policy advice. GDP figures, crime statistics, disease counts, property prices, and other data are provided for informational purposes only.
• Staleness. Cached data may be hours to weeks behind the source depending on the dataset's refresh window. Check ingestedAt timestamps if freshness matters.
• No warranty. This software is provided "as is" under the MIT licence, without warranty of any kind.

---

FAQ

Do I need an API key? No. data.gov.sg open datasets are public.

Where is the data stored? On your machine, in ~/.sgdata-mcp/sgdata.sqlite.

How often is data refreshed? Per-dataset, from daily to annually.

Is this production-ready? Yes. 74 tools, all tested against live data. File issues on GitHub if you hit anything sharp.

Can I add my own dataset? Yes — either use the generic tools for ad-hoc queries, or open a PR adding a handler under src/datasets/.

---

License

MIT

Attribution

Contains information from data.gov.sg under the Singapore Open Data Licence v1.0.

---

Contributing

Found a bug? Want a dataset added? Open an issue or PR on GitHub.