Kira — Romanian rentals MCP server

kira-mcp

<!-- mcp-name: io.github.Cezart3/kira-mcp -->

Ask your AI to find you a flat to rent in Romania — any city, town or commune.

An MCP server (and a CLI) that searches storia.ro, publi24.ro and lajumate.ro live, merges the results, removes duplicates and non-rentals, and reads the ad text for the things the site filters don't give you: heating type, parking, private owner vs agency, and walking distance to a place you care about.

Works with Claude (Code & Desktop), Cursor, VS Code, Windsurf, Gemini CLI, Codex and any other MCP client. Also usable as a plain CLI.

🇷🇴 Ghid în română

"Find me a 2-room flat in Cluj under 500 €, own boiler, with parking,

max 20 minutes on foot from UMF."

$ kira search Brasov --rooms 2 --max-price 500 --heating centrala_proprie --limit 3
Brașov, Brașov — 10 matching, showing 3
  storia: ok (74 fetched, 374 on site)
  publi24: ok (24 fetched)
  lajumate: ok (56 fetched, 382 on site)

 1. Studio Maurer Villas partial mobilat
    500 EUR | 2 cam | 45 mp | heating: centrala_proprie | parking: included
    Tractorul, Brasov, Brasov
    https://www.storia.ro/ro/oferta/studio-maurer-villas-partial-mobilat-IDIPoX
 2. Apartament pe 2 niveluri, 62 mp, zona Faget-Tractorul
    400 EUR | 2 cam | 62 mp | heating: centrala_proprie
    ...

Why

Romanian rental sites each cover part of the market, their filters are thin, and the details that decide a viewing — centrală proprie or termoficare? is the parking spot included or "posibilitate de parcare în zonă"? — live in free text. kira-mcp does the tab-juggling and the reading, so an agent can answer the question you actually asked.

Features

Wikidata. Diacritics optional, common shortcuts understood (cluj, tg mures, buc), ambiguous names resolved (Floresti, Prahova).

• All of Romania: 3,181 localities (municipii, orașe, comune) from

two sites shows once, with alsolistedon).

• 3 sites in parallel, deduplicated across sites (the same flat posted on

private owner, keywords.

• Filters: price (EUR; RON converted), rooms, heating, parking,

(centralaproprie / termoficare), parking (included, likelyincluded, area_possible, none), rooms, surface, floor, street. When a filter needs it, the full ad is read, not just the snippet.

• Text extraction tuned on real Romanian ads: heating

OpenStreetMap, with a Google Maps directions link.

• Walking distance from any place (near="UMF"), geocoded with

The user contacts the owner on the original site.

• Drops non-rentals: sale ads, parking-only ads, hotel-style short stays.
• Parking spots search (search_parking).
• Privacy: phone numbers and e-mails are redacted from returned text.

Quick start (5 minutes)

Step 1 — install uv (once)

kira-mcp runs through uv, which downloads it and its Python on first use. Nothing else to install.

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• Windows (PowerShell):

curl -LsSf https://astral.sh/uv/install.sh | sh

• macOS / Linux:

Close and reopen the terminal, then check: uvx --version.

Step 2 — connect it to your AI

Shortened. The full README is on GitHub.