# Chope

> A Singapore property almanac. Resale HDB, condo, landed, and new launches. Singpass-verified ownership, reverse-search wishlists, demand register, HFE+TDSR clarity. Open to humans and to AI agents.

## What this site is

Chope is a property listing platform for Singapore. Every listing has a deeded owner verified via Singpass, a remaining-lease badge, and an inline mortgage check at the MAS 4.0% stress rate. Agents pay per push (one token) instead of an annual subscription. Buyers can post a wishlist and be pinged by owners or CEA-licensed agents with a matching unit.

Every human page resolves to a parallel JSON endpoint. Every tool is also an MCP server tool. The site is built to be read by agents acting on a user's behalf, not just by humans.

## For AI agents

- All read endpoints are GET, CORS open, cached 60-300s.
- Write endpoints (wishlists, ping) accept JSON body, return 201 with the canonical record.
- The MCP server at /mcp exposes the same surface as named tools.
- This file is the entry point; /llms-full.txt has sample payloads.

## Endpoints

- /api/listings.json — paginated resale + new-launch listings
- /api/listing/{id} — single listing with agent + demand block
- /api/wishlists.json — open buyer wishlists (GET) or post one (POST)
- /api/heatmap.json — per-block demand register
- /api/new-launches.json — active launches with PSF gap vs resale
- /api/search.json — text + filter search
- /api/agents.json — CEA-licensed agent directory
- /api/shadow.json — shadow inventory (units thinking of selling)
- /api/calc/hfe-tdsr — POST income + price; get max loan, downpayment, monthly at stress rate
- /.well-known/chope-mcp.json — MCP server discovery

## Human pages (also crawlable)

- / — almanac homepage with feature index
- /search — searchable listing grid
- /listing/{id} — full listing detail with JSON-LD RealEstateListing
- /guides/{area} — neighbourhood guides (toa-payoh, bishan, tampines, joo-chiat, queenstown)
- /compare?ids=a,b,c — side-by-side ledger
- /heatmap — full demand register
- /wishlist + /wishlist/new — reverse search
- /shadow — shadow inventory board
- /tools/hfe-tdsr — affordability calculator
- /tools/launch-vs-resale — launch vs resale comparator
- /agents — CEA agent pricing
- /agents/video — AI walkthrough studio
- /api — JSON endpoint ledger
- /mcp — MCP server connection guide

## Authentication

Read endpoints are open. Write endpoints (POST /api/wishlists.json) accept any user-agent in the current build; production gates them behind a Singpass-issued OIDC token or an agent-issued API key.

## Provenance

PSF benchmarks reference URA caveats. Lease decay follows the HDB published tenure curve. School catchments resolve against the live MOE primary school directory. CEA registration numbers verified via the public CEA register.