Search Zameen.com property listings and return normalized JSON cards.

Use city names like "islamabad", "lahore", "karachi". purpose: sale|rent. property_type: homes|houses|flats|plots|commercial|rooms. Badge filters (verified_only, agent_tier e.g. "titanium", exclude_promoted, max_price_pkr) apply AFTER parsing over up to 3 result pages - these can express things Zameen's own UI cannot (e.g. verified listings only). min_beds/min_area_marla/keywords/sort are native site filters. Example: search_properties(city="lahore", purpose="sale", property_type="houses", min_beds=4, verified_only=True, agent_tier="titanium", max_price_pkr=200000000).

Fetch full details for ONE Zameen.com property listing.

Accepts a full Property URL or a bare numeric listing id such as "54646556". Read-only; never contacts the agent or modifies anything.

List verified city slugs and property types usable by search_properties.

Create a named local watchlist from search criteria (stored on disk).

Watches are re-checked later with check_watch; 'seed_with_current' runs the search once now so only NEW listings get reported in future checks. Nothing is saved to your Zameen account — this is a local file.

Re-run a saved watch's search and report NEW listings since last check.

Read-only against Zameen; the only state kept is the local id list.

Delete a local watchlist by name.

List local watchlists with their criteria and last-check times.

Draft (NOT send) a polite inquiry message to a listing's agent.

Fetches the listing's details and composes a ready-to-send text for you to paste into WhatsApp/email or read out on a call. This tool NEVER sends anything to anyone — contacting the agent is deliberately a human action.

Report whether an authenticated Zameen session is loaded.

Auth is optional: searches work anonymously; a session (created via 'python -m zameen_mcp.login') rides your cookies for personalized pages. No password is ever stored by this server.