CIAN MCP server
CIAN MCP Server
An MCP server for searching Moscow apartment listings on CIAN: filters, price history and rental yield estimates
- 0 ★ on the repository
- Last commit
Extended access
Why this level
- Starts an HTTP server that reads CIAN's internal API through cloudscraper
- Searches apartments and price history and publishes nothing
Install
- Works in
- Services
Manual install
uv sync && uv run python server.pyLocal run; the server listens on http://localhost:8080/mcp.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Starts an HTTP server that reads CIAN's internal API through cloudscraper
- Searches apartments and price history and publishes nothing
This is third-party code. Review the repository files before installing.
What it does
The server talks to CIAN's internal API through cloudscraper and gives an agent four tools: apartment search by district or administrative area with price, room count and floor filters, the full price history for a specific listing, a rental yield and payback estimate, and clearing the in-memory cache. Results are cached in the process's memory to speed up repeated queries and reset on restart. It runs locally via uv run or in Docker and listens over HTTP on its own port.
Who it is for. For people searching for an apartment in Moscow or evaluating real estate as an investment who want to do it through an agent.
Good fit when
- You want to filter apartments by district and budget in one request
- You want to see how a specific listing's price has changed over time
- You want a rough rental yield and payback estimate to compare options
Not a fit when
- You need search outside Moscow: the district data in the project only covers Moscow
- You need a precise financial estimate: the yield calculation is simplified, not full investment analysis
- You need an official CIAN API: the server uses the site's internal, undocumented interface
Example request
Find one-bedroom apartments on CIAN inside the Third Ring Road for up to 12 million rublesMCP
- Transport
- http
- Authentication
- not required
Limitations
The project has a single author, no license, and is marked in the README as private, use at your own discretion. The server depends on CIAN's internal API, which can change without notice and break it. The cache is in-memory only and does not survive a restart. District data is limited to Moscow and the Moscow region.
How to disable. Stop the server process or container and remove it from your MCP client config.
FAQ
Do I need a CIAN API key?
No, the server talks to the site's internal API through cloudscraper without a separate key.
Can the server run in Docker?
Yes, the repository has a Dockerfile, built with docker build -t cian-mcp . and run with docker run -p 8080:8080 cian-mcp.
Discussion
No questions or reviews yet.
Related
All Cian toolsA Go CLI and MCP server for CIAN apartment search, with saved searches that track changes, favorites and price history
CIAN apartment search MCP server
cian-mcp
A local MCP server for apartment search on CIAN through a real, authorized browser session rather than bypassing the site's protection
Not a tool for an agent but a ready Telegram bot on Pydantic AI and Claude: searches and dedupes real, non-fake housing listings in Miass
watermarkless (zigansh1n)
watermarkless
Watermark cleaning for photos for an agent: Avito and Cian profiles, automatic mark search and a custom mask, LaMa model run locally
An MCP server for Kaiten: cards, comments, spaces and boards with control over response verbosity
Yandex Disk MCP server for Claude.ai
MCP Yandex Disk Server
A small read-focused MCP server for Yandex Disk: folder listings, file search, download links and public links
README in short
The English README covers the project structure, stack (Python, FastMCP, cloudscraper, Docker), four tools, local launch via uv and Docker, health check and MCP endpoints. It separately notes the project depends on CIAN's internal API and is meant for personal use or lightweight deployment.