Evlek MCP Server

> AI-native property discovery for North Cyprus (KKTC). Built on the Model Context Protocol — works in Claude, ChatGPT, Gemini, Cursor, and any MCP-compatible client.

The Evlek MCP server gives AI agents structured, real-time access to North Cyprus property data — search active listings, compare cities, estimate rental yield, look up KKTC legal procedures, get district profiles, and more. All data is sourced live from evlek.app.

---

Why Evlek MCP

- AI-first. Built for agentic workflows from day one — not retrofitted on a legacy listing API.
- Multilingual. Property data in TR, EN, RU, DE, AR (currently exposed via tool descriptions in EN).
- Verified listings only. Every listing on Evlek passes KYC verification — no ghost ads, no fake agents.
- Built for the region. Optimized for the 6 cities of North Cyprus (Lefkoşa, Girne, Gazimağusa, İskele, Güzelyurt, Lefke) and 100+ districts.
- Production-grade. OWASP MCP Top 10 compliant — Zod input validation, output sanitization, rate limiting (60/min/IP, 500/min global), Sentry observability.

---

Quick start

Claude Desktop

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "evlek": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://evlek.app/api/mcp"]
    }
  }
}

Restart Claude Desktop. The "evlek" server appears in the tools list.

Cursor / VS Code (GitHub Copilot)

Cursor: Settings → Model Context Protocol → Add Server. VS Code: .vscode/mcp.json.

{
  "mcpServers": {
    "evlek": {
      "url": "https://evlek.app/api/mcp"
    }
  }
}

MCP Inspector (test before installing)

npx @modelcontextprotocol/inspector https://evlek.app/api/mcp

Direct API (cURL)

curl -X POST https://evlek.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

More configs: examples/

---

Available tools (v1.2.0 — 9 tools)

| # | Tool | What it does |
|---|------|--------------|
| 1 | search_listings | Search active listings by city, type (sale/rent/daily), bedrooms, price range. Returns up to 10 with title, price, location, direct link. |
| 2 | get_price_index | Aggregated avg/median/min/max prices per city + top districts (Evlek Price Index). |
| 3 | get_market_overview | High-level market overview — avg rent/sale prices, rental yields, hot zones, key facts (taxes, foreign ownership). |
| 4 | compare_cities | Compare 2-4 North Cyprus cities side-by-side with prices, listing counts, top districts, automatic verdict. |
| 5 | get_yield_estimate | Estimate gross/net annual rental yield for a property given purchase price + city + bedrooms. |
| 6 | get_legal_info | Authoritative info on koçan types, foreign purchase rules, taxes, residence permit, PTP (Permission to Purchase) process. |
| 7 | suggest_neighborhood | Given a buyer persona (retiree, investor, student, family, digital_nomad, vacation), return matched neighborhoods with rationale. |
| 8 | compare_properties | Compare 2-4 active listing UUIDs side-by-side with price-per-m², area, bedrooms, automatic value insight. |
| 9 | get_district_profile | 360° district profile — sale/rent stats, £/m², bedroom breakdown, estimated yield, persona match. |

> v2.0 roadmap (Q2 2026): 6 additional tools — find_near_university, analyze_ruhsat, calculate_mortgage, calculate_acquisition_cost, convert_price, search_blog. With namespace prefixes (prop_, market_, area_, legal_, util_).

- "Find 2-bedroom flats for rent in Girne under £500/month."
- "What's the median sale price per square meter in Lefkoşa?"
- "Compare İskele and Famagusta for investment — which has higher rental yield?"
- "Show me studios in Gazimağusa near DAÜ."
- "What koçan type is safest for a foreign buyer in North Cyprus?"
- "I'm a retiree looking at North Cyprus — which neighborhoods fit?"
- "Estimate the rental yield on a £150,000 2+1 in Girne."

- [x] v1.0 — 3 tools (search, price index, market overview)
- [x] v1.2 — 9 tools (added compare_cities, yield_estimate, legal_info, suggest_neighborhood, compare_properties, district_profile)
- [ ] v2.0 (Q2 2026) — 15 tools, namespace prefixes, +6 new (mortgage, acquisition_cost, near_university, analyze_ruhsat, convert_price, blog_search)
- [ ] v2.1 (Q3 2026) — Additional micro-MCPs: evlek-poi-mcp (POI + coast distance), evlek-agent-mcp (B2B agent finder)
- [ ] v3.0 (Q4 2026) — get_market_pulse_30day, get_construction_status, find_emergency_short_term
- [ ] Vision (2027) — Multimodal search_by_image, auth-gated tools (favorites, viewing requests, contact reveal), webhook subscriptions

Built in North Cyprus by an architect, not a software firm. Powered by Anthropic Claude, Supabase, Vercel, and the Model Context Protocol.*