Skip to main content
kilid-mcp: unofficial Kilid (کیلید) Iranian real-estate MCP server that searches homes for sale and rent, price per square metre and agencies for Claude, Cursor and Copilot

kilid-mcp: Kilid (کیلید) real-estate MCP server for AI agents, homes for sale and rent in Iran

kilid-mcp is an unofficial, read-only MCP server that lets an AI agent search homes for sale and rent, read house prices per square metre and look up agencies on Kilid (کیلید, kilid.com), a large Iranian real-estate portal.
Its 8 tools search buy and rent listings with price, area, room and district filters, open one listing in full, read the median price per m² by city, district and neighborhood with a 12-month trend, rank neighborhoods by price, and find agencies.
No API key or account is needed; it works in Claude, Cursor, Copilot and any other MCP client.

PyPI Python CI License: PolyForm Noncommercial

For AI agents · Quick start · Tools · Limits · فارسی


For AI agents

  • What: unofficial MCP server (model context protocol) for kilid.com: cities and districts, listing search (sale and rental), listing detail, house-price statistics with a 12-month trend, neighborhood price ranking, agencies.
  • Install: uvx kilid-mcp or claude mcp add kilid -- uvx kilid-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none. Optional KILID_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
  • Access: read-only. It cannot log in, save listings, contact agencies or reveal phone numbers, so no confirmation is needed before calling any tool.
  • Tools: 8, all prefixed kl_. Typical sequence: kl_cities -> kl_districts -> kl_search_listings -> kl_listing; kl_price_stats and kl_neighborhood_prices for market levels; kl_agencies -> kl_agency.
  • Use when: the user wants apartments or houses for sale or rent in an Iranian city, what a square metre costs in a district, or the priciest neighborhoods.
  • Do not use when: the user needs advertiser phone numbers, sold-price records, or to publish an ad.
  • Output: compact JSON. Prices are Toman. Rentals return the deposit as price_toman and the monthly rent as rent_toman. Text is Persian.

Quick start

You need uv. No API key or account.

Claude Code:

claude mcp add kilid -- uvx kilid-mcp

Claude Desktop, Cursor, VS Code and other clients:

{
  "mcpServers": {
    "kilid": { "command": "uvx", "args": ["kilid-mcp"] }
  }
}

Example prompts:

  • "Find 2-bedroom flats to buy in Tehran between 60 and 100 m²."
  • "What is the median price per square metre in Tehran and in its first district?"
  • "Which Karaj neighborhoods are the most expensive?"
  • آپارتمان اجاره‌ای دو خوابه در شیراز پیدا کن.
  • قیمت هر متر خانه در ولنجک چقدر است؟

Real answer (17 Nov 2026): kl_price_stats(area="tehran") returned a median of 237,179,487 Toman per m² (period 1405-08, sample 433,751 listings), and منطقه 1 at 571,428,571 Toman per m².

Tools

Tool What it does
kl_cities Find a city id and slug by Persian name, with whether district data exists.
kl_districts List municipal districts or neighborhoods of a city with their ids and slugs.
kl_search_listings Search buy or rent listings by city, districts, property type, price, rent, area, rooms, sort and page.
kl_listing Read one listing: price, area, rooms, floor, facilities, description, map point and agency.
kl_price_stats Median price per m² for a city or area, its sub-areas and the 12-month trend.
kl_neighborhood_prices Rank a city's neighborhoods by median price per m², with a data-quality flag.
kl_agencies Search agencies registered on Kilid by name.
kl_agency Read one agency: address, district, location, active listings and agent count.

Limits

  • Prices are asking prices from listings, not sale records. year_change_pct is the site's own yoyPct field; the page itself shows a client-side figure that differs a little.
  • Featured (paid) listings can appear on top even when they fall outside the filters. rent_toman 0 means deposit only.
  • Advertiser phone numbers sit behind a reveal button on the site and are deliberately not returned.
  • Kilid is a Next.js site and several tools read data embedded in its server-rendered pages. If Kilid renames those props, a tool can come back empty until the server is updated.
  • Heavy use and rate limits were not probed. Requests run two at a time with a short cache. It answers from abroad and from Iran.

How it works

Kilid has no public API. The server calls the JSON routes the site's own pages use (/api/search, /api/listings, /api/regions, /api/provinces, /api/neighborhoods/finder, /api/agency/suggest) and reads the data embedded in its server-rendered pages (listing page one, listing detail, price reports, agencies). The routes were mapped in a real browser and every tool's output was checked in Chrome against the rendered kilid.com pages. Requests present Chrome's TLS fingerprint.

فارسی

kilid-mcp یک سرور MCP غیررسمی و فقط‌خواندنی است که به دستیار هوش مصنوعی اجازه می‌دهد آگهی‌های خرید و اجاره‌ی ملک، قیمت هر متر مربع خانه و بنگاه‌های املاک را در کیلید (kilid.com) جست‌وجو کند. هشت ابزار دارد: جست‌وجوی آگهی با فیلتر قیمت، متراژ، تعداد اتاق و محله، دیدن کامل یک آگهی، قیمت میانگین هر متر به‌تفکیک شهر و منطقه و محله، رتبه‌بندی محله‌ها و پیدا کردن بنگاه. کلید API یا حساب کاربری لازم نیست. نصب در Claude Code:

claude mcp add kilid -- uvx kilid-mcp

Development

uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline, saved fixtures
uv run python -m pytest -m live -q  # real kilid.com

Releases: bump the version in pyproject.toml and server.json, run uv lock, then push a v* tag; GitHub Actions publishes to PyPI and the MCP Registry.

Disclaimer

Unofficial and not affiliated with or endorsed by Kilid. It is read-only and uses the public pages and routes of kilid.com, which can change without notice.

Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). LinkedIn · GitHub · more servers in iran-mcp.

مجوز استفاده (License)

استفادهٔ شخصی و غیرتجاری رایگان است؛ برای استفادهٔ تجاری با سپهر رادمرد تماس بگیرید. Free for personal and non-commercial use; commercial use needs a license.

استفادهٔ شخصی و غیرتجاری رایگان است. استفاده در شرکت، محصول پولی یا پروژهٔ مشتری به مجوز تجاری نیاز دارد؛ از راه لینکدین یا گیت‌هاب با سپهر رادمرد تماس بگیرید. متن کامل: PolyForm Noncommercial 1.0.0. نسخه‌های پیش از 0.1.1 با مجوز MIT منتشر شده‌اند و همان مجوز را دارند.

Free for personal and non-commercial use under the PolyForm Noncommercial License 1.0.0. Using it in a company, a paid product or a client project needs a commercial license: contact Sepehr Radmard on LinkedIn or GitHub. Versions before 0.1.1 were released under MIT and stay under it.

Metadata

Release files for kilid-mcp 0.1.1

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

Source distribution (sdist)

Source distribution for kilid-mcp 0.1.1
File Size Uploaded Provenance Actions
kilid_mcp-0.1.1.tar.gz 390.3 kB With provenance Details for kilid_mcp-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kilid-mcp 0.1.1
File Interpreter ABI Platform Actions
kilid_mcp-0.1.1-py3-none-any.whl Python 3 none any Details for kilid_mcp-0.1.1-py3-none-any.whl

Total release size: 410.2 kB

Release files / kilid_mcp-0.1.1.tar.gz

Download URL kilid_mcp-0.1.1.tar.gz
Size 390.3 kB
Tags Source
SHA-256 checksum
How to use checksums
ae4fc6f4d1f25732be876a999ccd146d73d68d7a1684f2c32b17a20ec2de9324
BLAKE2b-256 checksum
How to use checksums
3382364c86fd5972ba9d4e0f9ac0bd6f070299e2d32ac0c2585e1d836ce894ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Release files / kilid_mcp-0.1.1-py3-none-any.whl

Download URL kilid_mcp-0.1.1-py3-none-any.whl
Size 19.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9fc0c094676d60df7c4f7dd9643bd7dc7bf0aa7bdb3dd4dbb335c6d8a01d6e81
BLAKE2b-256 checksum
How to use checksums
44a68a1dfb8107c005d8149acc65256212d12c3e809d842c7ecbe7912985a5ce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

Security for kilid-mcp 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for kilid_mcp-0.1.1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files Full provenance

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