sg-connectors

By Lobang Scout — practical, evidence-backed connectors for Singapore SMEs.

Free, no-auth MCP connectors that let Claude reach the Singapore data surfaces an SME actually uses. Closing the gap our evaluation kept hitting: most of those surfaces have no connector.

Tools

`sg-company-lookup`

`sg-onemap`

sgverify — the same core from a shell

Not everything wants an MCP session. The entity-verification primitives also ship as a CLI, so any repo or script can use them:

sgverify uen 53498049W                      # one entity, ACRA open data
sgverify sweep 160046 --unit "#01-886"      # EVERY entity ever at one premises
sgverify prs "D&N" --board TCM              # registered practitioners at a place
sgverify prs 小红 --language chi              # Chinese place names need --language chi

Add --json to any of them for machine-readable output.

`sweep` is the one with no equivalent elsewhere. It reads ACRA collection 2 (block, level, unit, SSIC) rather than the thin consolidated dataset, and returns dead entities deliberately: a churn of short-lived businesses at one shop unit reads very differently from a single long tenancy, and that history is invisible from a UEN lookup.

Give sweep the full #01-886 form. A bare 886 matches that unit number on every level, which in an HDB block silently mixes unrelated premises.

Cost: collection 2 is sharded alphabetically across 27 datasets and an address sweep cannot know which letters it needs, so one sweep is ~27 requests and about 80 seconds unauthenticated. Set DATAGOV_API_KEY to lift the 4-requests/10s limit.

`prs` answers a question no other free Singapore source does: is a registered healthcare professional attached to this premises? It searches MOH's register by Name of Place of Practice, which is what lets you go from a business to a person.

The control-query contract

A nil from a scraped register is worthless unless the pipeline is known to be working. MOH PRS will happily return a page shell that looks exactly like "no records found" — during development that silently produced false negatives that would have shipped as findings. So prs:

• asserts a result marker on every response, raising PrsUnreadableResponse when

absent rather than reporting an absence, and

• re-runs a known-good control query after any nil, raising PrsControlFailed rather

than handing back an unverified empty result.

Controls deliberately do not run on non-nil results. A response carrying records is self-validating, so a control there buys no information and doubles the request count against a host that rate-limits hard.

Exit codes: 2 = nil could not be verified, 3 = the search did not actually run. Neither means "nobody is registered here".

Honest scope

These are built on free government open data. Be clear about the limits:

Company / UEN (ACRA open dataset):

• Returns: UEN, entity name, type, registration status, UEN issue date, street name,

postal code, issuance agency.

• Monthly snapshot — not real-time. A struck-off entity may still show Registered.
• No officers, directors, shareholders, financials, paid-up capital, SSIC activity,

or full address. Those need the paid ACRA Business Profile API (Corppass + EIQ) or a ~S$5.50 Bizfile profile.

• validate_uen confirms format only — ACRA's check-letter algorithm is undisclosed.

Address (OneMap):

• Singapore addresses only. Returns block, road, building, full address, postal code,

WGS84 lat/long, and SVY21 x/y.

• The Search API is free; OneMap may require a free token in future (set ONEMAP_TOKEN).

For anything statutory or real-time, verify at the source (Bizfile, OneMap). These connectors are for fast, free first-pass lookup — not the system of record.

Install

Into Claude via uvx (no clone needed)

Add to your .mcp.json (or your plugin's). Runs straight from this repo:

{
  "mcpServers": {
    "sg-company-lookup": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Lobang-Scout/sg-connectors", "sg-company-lookup"],
      "env": { "DATAGOV_API_KEY": "${DATAGOV_API_KEY}" }
    },
    "sg-onemap": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/Lobang-Scout/sg-connectors", "sg-onemap"]
    }
  }
}

Local clone (development)

python3.12 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/sg-company-lookup    # or: .venv/bin/sg-onemap

Optional: raise the rate limit (company lookup)

Without a key, data.gov.sg allows 4 requests / 10s. A free API key lifts this to 20/10s. export DATAGOV_API_KEY=... before launching Claude. Request a key at guide.data.gov.sg.

UEN formats (what validate_uen checks)

Tests

.venv/bin/python -m pytest -q

Network is mocked in tests — no live calls in CI.

Data sources & licence

• Company data: ACRA via data.gov.sg, under the

Singapore Open Data Licence.

• Address data: OneMap (Singapore Land Authority).

This connector is an independent tool, not affiliated with or endorsed by ACRA, SLA, or GovTech. Code under MIT (see LICENSE).