MCP server for searching Turkish businesses, places and mosques via KolayKaydet.com.tr's directory (580K+ businesses, 90K+ mosques across all 81 provinces).
Four tools with complete Zod schemas and Turkish descriptions. All tools are read-only search/list operations with proper parameter validation (min/max on limit). Naming follows verb_noun pattern (search_*, get_*, list_*). Descriptions are substantive (100-200 chars) and explain data source and result format. However, output schemas are not formally documented, responses are JSON.stringify'd without explicit field definitions. Parameter descriptions are good but lack format guidance (e.g., no regex for slug format). No error recovery guidance in descriptions. Missing tool annotations (readOnlyHint) despite all being read-only.
Bir işletmenin KolayKaydet.com.tr slug'ına göre tam detaylarını getirir (search_companies sonucundaki url'in son parçası).
KolayKaydet.com.tr veritabanındaki tüm şehirleri, kayıtlı işletme sayısına göre azalan sırada listeler.
Türkiye genelinde 580.000+ işletme arasında ada, şehre ve/veya kategoriye göre arama yapar. KolayKaydet.com.tr veritabanını kullanır; her sonuç canlı bir profil sayfası linki içerir.
Türkiye genelinde 90.000+ resmi cami kaydı arasında şehir/ilçeye ve niteliklere (tarihi, selatin, tekerlekli sandalye erişimi) göre arama yapar. Her sonuç canlı bir KolayKaydet.com.tr profil linki içerir.
Output schemas not formally documented. Tools return JSON.stringify'd results without explicit field definitions (name, slug, rating, reviews_count, etc.). LLMs cannot plan downstream operations or extract specific fields reliably.
Missing tool annotations. All four tools are read-only but lack readOnlyHint annotation. Agents cannot distinguish safe tools from destructive ones without explicit hints.
Parameter format constraints missing. 'slug' parameter in get_company_details lacks format guidance (e.g., 'lowercase-hyphenated, e.g. a101-mersin-turunclu'). LLMs may pass invalid formats.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 68 | 2026-07-28+ | v2 |
No error recovery guidance. get_company_details returns isError=true with generic 'İşletme bulunamadı.' but does not suggest alternatives (e.g., 'Try search_companies with partial name').
Pagination not implemented. search_companies and search_mosques cap results at 25 but do not return total_count or next_cursor. Large result sets cannot be paginated.