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_*).

See TOOLS.md for full input schemas, parameter details, and response examples.

---

Example prompts

Try these in any MCP-enabled client:

• "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."

---

Coverage

• Cities: 6 (Girne, İskele, Lefkoşa, Gazimağusa, Güzelyurt, Lefke)
• Districts: 100+
• Universities: 7 indexed (YDÜ, DAÜ, GAÜ, UKÜ, LAÜ, BAÜ, AKÜ) — surfaced via area_near_university in v2.0
• Currency: GBP primary; TRY/USD/EUR conversion in util_convert_price (v2.0)
• Tool descriptions: EN
• Listing data fields: TR + EN (additional language tools planned for v2.1)

---

Architecture

The Evlek MCP server runs as a hosted endpoint at https://evlek.app/api/mcp. It speaks the Model Context Protocol over Streamable HTTP (JSON-RPC 2.0), spec version 2025-11-05, and complies with the Anthropic Registry v1.2 spec.

This repository contains:

• server.json — Anthropic Registry manifest
• TOOLS.md — Full tool reference (JSON schemas + examples)
• examples/ — Configuration files for Claude Desktop, Cursor, Continue, VS Code
• examples/clients/ — Reference open-source thin clients (Python + TypeScript) under MIT
• CONTRIBUTING.md — How to file issues and propose docs improvements

The full server implementation (database schemas, API routes, AI prompt engineering, listing pipeline) is hosted at evlek.app and remains proprietary. This repository focuses on documentation, the Anthropic Registry manifest, and integration examples.

Security model

Per OWASP MCP Top 10:

• Per-IP rate limit: 60 req/min
• Global rate limit: 500 req/min (Supabase/Vercel guard)
• Hard timeout: 30 seconds per request
• Input validation: Zod schemas, every tool
• Output sanitization: Indirect prompt-injection defense (8-pattern regex)
• Response size caps: Max 10 results per query
• Database access: Supabase anon key + Row Level Security
• Error containment: No stack traces leaked
• Observability: Sentry per-tool spans + breadcrumbs + duration tracking

See evlek.app/security for the full disclosure policy.

---

Roadmap

• v1.0 — 3 tools (search, price index, market overview)
• 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

---

Status

• MCP version: 1.2.0 (live)
• Endpoint: https://evlek.app/api/mcp
• Anthropic Registry: app.evlek/mcp-server — isLatest: true
• Health: evlek.app/status
• Documentation: evlek.app/mcp

---

Contributing

This server is operated by Evlek. The hosted implementation is proprietary, but this repository (manifest + docs + examples + reference clients) is open under MIT.

Documentation issues and PRs are welcome — typo fixes, clarifications, additional client examples, translations of the README. For bugs against the hosted server, open an issue with the server-bug label and include your prompt, the tool called, and the response (with PII redacted).

See CONTRIBUTING.md for details.

---

License

MIT — see LICENSE.

The hosted Evlek service (web app, mobile app, listing data, AI prompts, database schemas) is proprietary and not covered by this license.

Trademark notice: "Evlek" is a trademark of Onur Dokuzoğlu. The MIT license covers source code only — it does not grant rights to use the "Evlek" name, logo, or branding except as described in this README. To request brand usage permission, contact [email protected].

---

Links

• Web: evlek.app
• iOS: App Store
• Android: Internal Test (closed beta)
• MCP endpoint: https://evlek.app/api/mcp
• MCP documentation: evlek.app/mcp
• Anthropic Registry: app.evlek/mcp-server
• Model Context Protocol: modelcontextprotocol.io
• Contact: [email protected]

---

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