LTS MCP Server

A Model Context Protocol server that provides Philippine License to Sell (LTS) verification data to LLMs. Built on Cloudflare Workers with Supabase.

Public, read-only, no authentication required. Data sourced from the Department of Human Settlements and Urban Development (DHSUD) License to Sell registry and cross-referenced with published real estate projects on REN.PH.

Why This Exists

Philippine real estate developers are required by law to obtain a License to Sell (LTS) from DHSUD before marketing or selling condominium units, subdivision lots, and other real estate projects. Buyers can check whether a project has a valid LTS, but the official verification process involves navigating government websites and manually looking up records.

This MCP server makes that data queryable by any LLM. Ask your AI assistant "Does [project name] have a valid License to Sell?" and get an answer backed by DHSUD records.

Tools

| Tool | Description | |------|-------------| | lts_search | Search across DHSUD records and published projects by name, LTS number, developer, or city | | lts_queue | Browse the DHSUD verification queue with filters (status, region, expiry, score) | | lts_project | Get the complete LTS picture for a project (by UUID or name) | | lts_stats | System-wide statistics: queue pipeline health and project LTS counts | | lts_check | Check if a specific LTS number exists in the system | | lts_filters | Get available regions and cities for filtering |

Tool Details

lts_search is the universal entry point. It searches both the DHSUD verification queue (scraped records) and the REN.PH projects database simultaneously. Use this when you have a project name, developer name, LTS number, or city and want to find everything related.

lts_queue gives access to the raw DHSUD scrape data. Each record represents an LTS entry from DHSUD's registry, with match status indicating whether it has been linked to a project in the REN.PH database. Supports filtering by match status, region, minimum match score, text search, and expiring-soon windows.

lts_project returns the full LTS picture for a single project: all LTS records with computed fields (is_expired, days_until_expiry), a summary with counts (verified, expired, expiring soon), and the primary LTS number. Accepts either a project UUID or a project name for fuzzy lookup.

lts_stats returns two sections: queue stats from the verification pipeline (total records, pending, auto-matched, manual-matched, no-match, expired, expiring soon) and project LTS stats (total records, verified, expired, expiring within 30 days, projects with active LTS).

lts_check verifies whether a specific LTS number exists. Returns whether it was found in the DHSUD queue, in the verified project LTS table, or both, along with the full record details.

lts_filters returns distinct regions and cities available in the verification queue. Use this before calling lts_queue with region or city filters to get valid values. Optionally pass a region to get only cities within that region.

Response Format

All data responses are wrapped in a standard metadata envelope:

{
  "_meta": {
    "source": "Department of Human Settlements and Urban Development (DHSUD)",
    "source_url": "https://dhsud.gov.ph/",
    "dataset": "License to Sell (LTS) Registry",
    "last_synced": "2026-03-04"
  },
  "data": { ... }
}

Error responses (isError: true) are returned as plain text without wrapping.

Paginated Responses

Tools that return lists (lts_search, lts_queue) use a standard pagination wrapper:

| Field | Type | Description | |-------|------|-------------| | items | array | The result records | | total | number | Total matching records | | limit | number | Page size used | | offset | number | Current offset | | hasMore | boolean | Whether more results exist |

LTS Status Values

| Status | Meaning | |--------|---------| | verified | LTS confirmed valid by verification process | | unverified | LTS exists but not yet verified | | expired | LTS past its expiry date | | none | Project has no LTS on record |

Match Status Values (Queue)

| Status | Meaning | |--------|---------| | pending | DHSUD record awaiting review | | auto_matched | Automatically linked to a project | | manual_matched | Manually linked by a reviewer | | no_match | No matching project found | | skipped | Skipped during review | | new_project | Record suggests a new project not yet in the database |

Connect

Add to your MCP client configuration:

{
  "mcpServers": {
    "lts": {
      "url": "https://lts.godmode.ph/mcp"
    }
  }
}

Quick test

curl -X POST https://lts.godmode.ph/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "lts_check",
      "arguments": { "ltsNumber": "HLURB-LTS-0001-2024" }
    }
  }'

Data Sources

| Source | Description | |--------|-------------| | DHSUD LTS Registry | Scraped License to Sell records: LTS numbers, project names, developers, cities, issue/expiry dates | | REN.PH | Published real estate project database with verified LTS linkages |

The DHSUD verification queue contains scraped records from DHSUD's public registry. These records are matched against REN.PH's project database using a combination of exact LTS number matching, project name matching, and fuzzy scoring. Verified matches are stored in the project_lts table with full provenance.

Last synced: March 4, 2026.

Security

This is a public, read-only endpoint. The Supabase connection uses an anon key (not a service role key), and all data access is enforced through Row Level Security (RLS) policies:

• projects: only published projects are visible
• project_lts: all verified/public LTS records are visible
• lts_verification_queue: all DHSUD public data is visible

Even if the Worker is compromised, the attacker can only read what RLS allows. No write operations are exposed.

What is a License to Sell?

Under Philippine law (PD 957 and BP 220), real estate developers must secure a License to Sell (LTS) from DHSUD before offering any subdivision lot, condominium unit, or similar real estate project for sale to the public. The LTS confirms that the project has been reviewed for compliance with zoning, land use, environmental, and development standards.

Buying from a project without a valid LTS is one of the most common risks in Philippine real estate. This MCP server makes that verification accessible to AI assistants, chatbots, and any MCP-compatible application.

Related Projects

Part of a suite of Philippine public data MCP servers:

• PSGC MCP - Philippine Standard Geographic Code data
• LTS MCP (this repo) - DHSUD License to Sell verification
• PH Holidays MCP - Coming soon
• BSP Bank Directory MCP - Coming soon

All servers are free, public, and read-only. Data pulled from official Philippine government sources.

Development

npm install
npm run cf-typegen
npm run dev

cf-typegen generates worker-configuration.d.ts (gitignored) with Cloudflare runtime types. Run it once after cloning and again after changing wrangler.jsonc.

Dev server starts at http://localhost:8787. Connect your MCP client to http://localhost:8787/mcp.

Testing

npm test            # run all tests
npm run test:watch  # watch mode

88 tests across 4 suites covering sanitization (PostgREST filter injection), utility functions, response formatting, and query logic with mock Supabase clients.

Deployment

Before first deploy, set the Supabase secrets:

npx wrangler secret put SUPABASE_URL
npx wrangler secret put SUPABASE_ANON_KEY

Then deploy:

npm run deploy

Type Generation

After changing wrangler.jsonc:

npm run cf-typegen

Contributing and Issues

Found a data discrepancy or a project with incorrect LTS status? Open an issue. DHSUD data is scraped periodically and matched against the REN.PH database. Mismatches, missing records, and edge cases in the matching pipeline are tracked through issues.

If data looks stale, open an issue and it will be refreshed ahead of the next scheduled sync.

Built by

Aaron Zara - Fractional CTO at Godmode Digital

Built REN.PH, a programmatic real estate platform with 60,000+ structured pages covering every Philippine province, city, and barangay. The LTS MCP came out of needing to make DHSUD license verification accessible to AI agents, because buyers deserve to know if a project is licensed before they sign anything.

For enterprise SLAs, custom integrations, or other PH data sources: godmode.ph

License

MIT