Skip to main content

sg-eli-mcp

An MCP server for Singapore Statutes Online (SSO, sso.agc.gov.sg), the Attorney-General's Chambers' official portal for Singapore legislation. It browses, fetches, and cites Acts, with a verifiable citation on every response.

Part of the MateMatic eu-legal-mcp production line, extended into Asia alongside jp-eli-mcp. Same citation contract (a stable identifier + a human-readable citation + a source URL), adapted for a jurisdiction with no ELI and no public search API.

Scope. SSO's robots.txt disallows /search; discovery here is by browsing the current Acts listing (sg_list_acts, paginated), not by title or keyword query. Fetch a specific section (sg_get_provision) or the full text (sg_get_full_text, truncated for very large Acts). Every response carries a dataset_note.

Licence. SSO legislation is official public information published by the Singapore government. This connector relays it with attribution and a source_url, respects robots.txt (no /search calls), and does not cache more aggressively than a normal browser visit would.

The tools

Tool What it does
sg_list_acts Browse the current Acts, paginated (no keyword search - see Scope above).
sg_get_provision The text of one numbered section of an Act, by act_code and section number.
sg_get_full_text The full text of an Act (truncated at ~300,000 characters).
sg_coverage Declare what this connector covers, when each family was captured, and - explicitly - what it does NOT cover. Every gap carries a fallback.

Every response carries the contract: eli_uri (Singapore has no ELI - this is the durable SSO act URL, e.g. https://sso.agc.gov.sg/Act/CoA1967, see eli_note), human_readable_citation (the Act title as SSO itself renders it, e.g. Companies Act 1967), and source_url.

Install

Not yet on PyPI - install from source until the first release ships:

git clone https://github.com/matematicsolutions/sg-eli-mcp
cd sg-eli-mcp
pip install -e .

Once released, this will be uvx sg-eli-mcp.

Configuration via env:

  • SG_ELI_BASE_URL - default https://sso.agc.gov.sg
  • SG_ELI_CACHE_DIR - default ~/.matematic/cache/sg-eli
  • SG_ELI_AUDIT_DIR - default ~/.matematic/audit

No API key. SSO is keyless.

Configure (Claude Code / any MCP client)

{
  "mcpServers": {
    "sg-eli-mcp": { "command": "sg-eli-mcp" }
  }
}

Windows 11 with Smart App Control

Smart App Control blocks unsigned executables, which covers uvx.exe, pip.exe and the sg-eli-mcp.exe launcher that pip writes at install time. The python.exe and py.exe from the python.org installer are signed by the Python Software Foundation, so running the module through the interpreter works:

python -m pip install sg-eli-mcp
python -m sg_eli_mcp

pip.exe is blocked for the same reason, so install with python -m pip, not pip install. If python is not on PATH, use the Windows launcher: py -3 -m sg_eli_mcp.

{ "mcpServers": { "sg-eli-mcp": { "command": "python", "args": ["-m", "sg_eli_mcp"] } } }

Do not turn Smart App Control off to work around this - it cannot be re-enabled without reinstalling Windows.

Governance

  • Public data only - read-only against SSO; no client data leaves the machine.
  • Robots-compliant - never calls /search (disallowed by SSO's robots.txt); discovery uses only the allowed /Browse listing.
  • Audit log - every tool call appends one JSON line to ~/.matematic/audit/sg-eli-mcp.jsonl.
  • Vendor-neutral - talks only to sso.agc.gov.sg; no LLM provider, no telemetry.
  • Verifiable citations - every response is independently checkable via source_url.

See CONSTITUTION.md and DISCOVERY.md.

Tests

pip install -e ".[dev]"
pytest tests/test_instructions_drift.py -v   # offline
pytest tests/test_smoke.py -v                # hits live SSO

Licence

Apache-2.0. © Matematic Solutions / Wieslaw Mazur.

Metadata

Release files for sg-eli-mcp 0.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sg-eli-mcp 0.3.3
File Size Uploaded
sg_eli_mcp-0.3.3.tar.gz 26.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sg-eli-mcp 0.3.3
File Interpreter ABI Platform
sg_eli_mcp-0.3.3-py3-none-any.whl Python 3 none any Details

Total release size: 50.0 kB

Release files / sg_eli_mcp-0.3.3.tar.gz

Download URL sg_eli_mcp-0.3.3.tar.gz
Size 26.0 kB
Tags Source
SHA-256 checksum
How to use checksums
dc17ee6bad65ea7b6511339caf693e9e60ee4f313c475ad3432b71b9afeb289e
BLAKE2b-256 checksum
How to use checksums
695386167cac8578e3ecf775046c61baac171241d80784a3e2bad916e23edf67
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / sg_eli_mcp-0.3.3-py3-none-any.whl

Download URL sg_eli_mcp-0.3.3-py3-none-any.whl
Size 24.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a2742cad75767ffa43656b045531bf5b1f18a21db37ccdfb3a91502f862ba1b7
BLAKE2b-256 checksum
How to use checksums
f54d717d67b4f04cb7b1d994607d478140cef52b9ca31640312178ffed33bed4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

0.3.3 This release

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page