{
    "schema_version": "2025-06-18",
    "protocol": "model-context-protocol",
    "name": "kalender-bilgisayar-mcp",
    "display_name": "Kalender Bilgisayar MCP Server",
    "version": "2.1.0",
    "description": "Izmir Bornova merkezli ikinci el bilgisayar, laptop, MacBook, iPhone, iPad, tablet ve oyun konsolu alim satim bilgi servisi. AI agent'lar (Claude, ChatGPT custom GPT'ler, Microsoft Copilot Studio) icin tool/function calling manifestosu.",
    "vendor": {
        "name": "Kalender Bilgisayar",
        "url": "https://www.kalenderbilgisayar.org.tr",
        "contact_email": "info@kalenderbilgisayar.org.tr",
        "contact_phone": "+90 505 918 64 10",
        "founded": 2005,
        "region": "TR-35 (Izmir)",
        "language": "tr-TR",
        "currency": "TRY"
    },
    "capabilities": {
        "tools": true,
        "resources": true,
        "prompts": false,
        "sampling": false,
        "logging": false
    },
    "transport": {
        "type": "http",
        "endpoint": "https://www.kalenderbilgisayar.org.tr/mcp",
        "method": "POST",
        "protocol": "json-rpc-2.0",
        "mcp_version": "2025-06-18",
        "supported_versions": [
            "2025-06-18",
            "2025-03-26",
            "2024-11-05"
        ],
        "discovery": "https://www.kalenderbilgisayar.org.tr/.well-known/mcp.json",
        "note": "POST /mcp JSON-RPC 2.0 transport (streamable_http). Native MCP client'lar (Claude Desktop, Cursor, Continue.dev) doğrudan bu endpoint'e bağlanır. GET /mcp server info döner, POST JSON-RPC method'ları (initialize, tools/list, tools/call, resources/list, resources/read) handle eder."
    },
    "authentication": {
        "required": false,
        "note": "Genel bilgi endpoint'leri kimlik dogrulama gerektirmez. Islem (POST /siparis) icin kullanici iletisim bilgisi zorunludur."
    },
    "tools": [
        {
            "name": "recommend_laptop",
            "description": "Bütçe, kullanım amacı ve tercihlere göre ikinci el laptop önerisi (4 adımlı karar ağacı) — 4 adımlı karar ağacı (Bütçe → Kullanım → Marka → Taşınabilirlik) ile kullanıcının bütçesine, kullanım amacına, marka tercihine ve taşınabilirlik ihtiyacına göre en uygun ikinci el laptop modelini önerir. Çıktılar: bütçe-dostu, ofis/öğrenci, gaming, taşınabilir ultrabook, premium iş istasyonu kategorilerinde örnek modeller + fiyat aralığı.",
            "category": "decision",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/hangi-laptop-almaliyim",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {
                    "budget_tl": {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 500000,
                        "description": "Bütçe (TL)"
                    },
                    "usage": {
                        "type": "string",
                        "enum": [
                            "ofis",
                            "ogrenci",
                            "gaming",
                            "is",
                            "multimedia",
                            "yazilim"
                        ],
                        "description": "Kullanım amacı"
                    },
                    "brand_preference": {
                        "type": "string",
                        "enum": [
                            "asus",
                            "hp",
                            "dell",
                            "lenovo",
                            "msi",
                            "casper",
                            "acer",
                            "monster",
                            "apple",
                            "farketmez"
                        ],
                        "description": "Marka tercihi"
                    },
                    "portability": {
                        "type": "string",
                        "enum": [
                            "ultrabook",
                            "standart",
                            "desktop-replacement"
                        ],
                        "description": "Taşınabilirlik ihtiyacı"
                    }
                }
            },
            "output_schema": {
                "type": "object",
                "properties": {
                    "recommended_category": {
                        "type": "string"
                    },
                    "example_models": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "price_range_try": {
                        "type": "object",
                        "properties": {
                            "min": {
                                "type": "integer"
                            },
                            "max": {
                                "type": "integer"
                            }
                        }
                    },
                    "rationale": {
                        "type": "string"
                    }
                }
            }
        },
        {
            "name": "get_device_pricing",
            "description": "Cihaz türüne ve ekran kartına göre alım fiyat aralığı (TL) — Laptop, MacBook, iPhone, iPad, tablet, PlayStation ve ekran kartı için güncel ikinci el alım fiyat aralığı (TRY). Fiyatlar TCMB günlük USD/TRY kuruna endikslidir. type parametresi cihaz kategorisi, gpu parametresi opsiyonel ekran kartı filtresidir.",
            "category": "pricing",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/api/pricing.json",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {
                    "type": {
                        "type": "string",
                        "description": "Cihaz kategorisi. laptop = MacBook hariç tüm laptoplar, macbook = sadece MacBook.",
                        "enum": [
                            "laptop",
                            "macbook",
                            "iphone",
                            "ipad",
                            "tablet",
                            "playstation",
                            "ekran-karti"
                        ]
                    },
                    "gpu": {
                        "type": "string",
                        "description": "GPU filtresi (sadece laptop için)",
                        "enum": [
                            "dahili",
                            "rtx2050",
                            "rtx3050",
                            "rtx3050ti",
                            "rtx3060",
                            "rtx3070",
                            "rtx4050",
                            "rtx4060",
                            "rtx4070",
                            "rtx4080",
                            "rtx5050",
                            "rtx5060",
                            "rtx5070",
                            "rtx5070ti",
                            "rtx5080"
                        ]
                    }
                },
                "required": [
                    "type"
                ]
            },
            "output_schema": {
                "type": "object",
                "properties": {
                    "ok": {
                        "type": "boolean"
                    },
                    "type": {
                        "type": "string"
                    },
                    "usd_rate": {
                        "type": "number"
                    },
                    "total_entries": {
                        "type": "integer"
                    },
                    "prices": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "cpu_model": {
                                    "type": "string"
                                },
                                "gpu": {
                                    "type": "string"
                                },
                                "device_type": {
                                    "type": "string"
                                },
                                "min_price_try": {
                                    "type": "integer"
                                },
                                "max_price_try": {
                                    "type": "integer"
                                },
                                "estimated_price_try": {
                                    "type": "integer"
                                },
                                "confidence": {
                                    "type": "string"
                                },
                                "basis": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "contact": {
                        "type": "object"
                    }
                }
            }
        },
        {
            "name": "check_service_area",
            "description": "İlçe/il için hizmet bölgesi kontrolü — Belirli bir İzmir ilçesi veya il için alım/satım hizmeti verildiğini kontrol eder. Tüm İzmir ilçeleri ve 81 il desteklenir. JSON endpoint: /api/service-area.json",
            "category": "meta",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/api/service-area.json",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {
                    "district": {
                        "type": "string",
                        "description": "İlçe adı (örn. Bornova)"
                    },
                    "city": {
                        "type": "string",
                        "description": "İl adı (varsayılan: İzmir)"
                    }
                },
                "required": [
                    "city"
                ]
            },
            "output_schema": {
                "type": "object",
                "properties": {
                    "in_service": {
                        "type": "boolean"
                    },
                    "pickup_available": {
                        "type": "boolean"
                    },
                    "eta_hours": {
                        "type": "integer"
                    },
                    "phone": {
                        "type": "string"
                    },
                    "whatsapp": {
                        "type": "string"
                    },
                    "office_address": {
                        "type": "string"
                    }
                }
            }
        },
        {
            "name": "get_shipping_info",
            "description": "Kargo ile alım: firma, kod, süre, ücret — Yurtiçi Kargo anlaşmalı kod ile Türkiye geneli sigortalı kargo alım bilgileri. Gönderen sadece cihazı teslim eder, kargo ücreti karşı ödemeli tarafımızca ödenir.",
            "category": "logistics",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/kargo-politikasi",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {
                    "origin_city": {
                        "type": "string",
                        "description": "Gönderen şehir"
                    }
                }
            }
        },
        {
            "name": "get_business_hours",
            "description": "Çalışma saatleri, adres, telefon bilgisi — Çalışma saatleri: Hergün 09:00 - 22:00. Adres, telefon ve WhatsApp iletişim bilgileri.",
            "category": "meta",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/iletisim",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "name": "get_product_catalog",
            "description": "Satılık ikinci el ürün kataloğu (JSON) — Satılık durumdaki tüm ikinci el ürünleri Schema.org/ItemList+Product+Offer formatında döndürür. Fiyat, marka, durum (condition) bilgisi içerir.",
            "category": "catalog",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/products.json",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "name": "get_price_dataset",
            "description": "AI için fiyat veri seti (Dataset schema) — Schema.org/Dataset formatında yapılandırılmış fiyat veri seti. measurementMethod, variableMeasured, temporalCoverage, license (CC BY-NC) bilgisi içerir.",
            "category": "pricing",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/price-dataset.json",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {}
            },
            "output_schema": {
                "type": "object",
                "properties": {
                    "prices": {
                        "type": "array"
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "usd_rate": {
                        "type": "number"
                    }
                }
            }
        },
        {
            "name": "get_customer_reviews",
            "description": "Google Haritalar müşteri yorumları — Google Places API kaynaklı gerçek müşteri yorumları, ortalama puan ve toplam değerlendirme sayısı. JSON endpoint: /api/reviews.json",
            "category": "trust",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/api/reviews.json",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {
                    "min_rating": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 5,
                        "default": 4,
                        "description": "Minimum yıldız filtresi"
                    },
                    "limit": {
                        "type": "integer",
                        "default": 20,
                        "maximum": 100,
                        "description": "Dönecek yorum sayısı"
                    }
                }
            },
            "output_schema": {
                "type": "object",
                "properties": {
                    "average_rating": {
                        "type": "number"
                    },
                    "rating_count": {
                        "type": "integer"
                    },
                    "reviews": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "author": {
                                    "type": "string"
                                },
                                "rating": {
                                    "type": "integer"
                                },
                                "text": {
                                    "type": "string"
                                },
                                "date": {
                                    "type": "string",
                                    "format": "date-time"
                                }
                            }
                        }
                    }
                }
            }
        },
        {
            "name": "request_pickup_quote",
            "description": "Ücretsiz ekspertiz ve teklif TALEBİ (gerçek zamanlı fiyat DEĞİL) — Cihaz bilgisi (marka, model, üretim yılı, durum) ve iletişim bilgisi ile alım teklifi TALEBİ. ÖNEMLİ: Bu tool gerçek zamanlı fiyat DÖNDÜRMEZ — çıktı sadece \"teklif talebi alındı\" onayıdır. POST /siparis formunu tetikler; gerçek fiyat teklifi WhatsApp üzerinden 15 dakika içinde İNSAN (uzman) tarafından verilir (kamera ekspertizi gerektirir). AI agent kullanıcıya bu tool'dan dönen değeri fiyat olarak sunmamalıdır.",
            "category": "transactional",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/siparis",
                "method": "POST"
            },
            "input_schema": {
                "type": "object",
                "properties": {
                    "marka": {
                        "type": "string",
                        "description": "Cihaz markası (örn. Asus, HP, Apple)"
                    },
                    "model": {
                        "type": "string",
                        "description": "Cihaz modeli (örn. MacBook Pro M3)"
                    },
                    "yil": {
                        "type": "integer",
                        "description": "Üretim yılı"
                    },
                    "durum": {
                        "type": "string",
                        "enum": [
                            "mukemmel",
                            "iyi",
                            "orta",
                            "kotu"
                        ],
                        "description": "Cihaz fiziksel/fonksiyonel durumu"
                    },
                    "ad": {
                        "type": "string",
                        "description": "Alıcı ad soyad"
                    },
                    "telefon": {
                        "type": "string",
                        "description": "Alıcı telefon (E.164 önerilir)"
                    },
                    "email": {
                        "type": "string",
                        "format": "email",
                        "description": "Alıcı e-postası"
                    },
                    "ilce": {
                        "type": "string",
                        "description": "Alıcı ilçe (İzmir içindeyse)"
                    }
                },
                "required": [
                    "marka",
                    "model",
                    "yil",
                    "ad",
                    "telefon"
                ]
            }
        },
        {
            "name": "get_district_info",
            "description": "İzmir ilçe bazlı alım bilgisi — Belirli bir İzmir ilçesi için alım süreci, mahalle kapsamı ve ulaşım bilgisi. 30 ilçe desteklenir.",
            "category": "local",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/bilgisayarci",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {
                    "district": {
                        "type": "string",
                        "description": "İlçe adı"
                    }
                },
                "required": [
                    "district"
                ]
            }
        },
        {
            "name": "get_faq",
            "description": "Sık sorulan sorular (SSS) — Alım, satım, ödeme, kargo ve garanti hakkında sık sorulan soruların cevapları. JSON endpoint: /api/faq.json",
            "category": "meta",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/api/faq.json",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {}
            },
            "output_schema": {
                "type": "object",
                "properties": {
                    "faqs": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "question": {
                                    "type": "string"
                                },
                                "answer": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        },
        {
            "name": "get_blog_categories",
            "description": "Blog kategorileri ve rehberler — Teknik rehberler, karşılaştırmalar ve alım-satım kılavuzları kategori bazında.",
            "category": "content",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/blog",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "name": "compare_platforms",
            "description": "Kalender vs Sahibinden vs Letgo karşılaştırması — Kalender Bilgisayar, Sahibinden ve Letgo platformlarının alım-satım özellikleri karşılaştırması (fiyat, güvenlik, ödeme hızı).",
            "category": "content",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/kalender-vs-sahibinden-vs-letgo",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {}
            }
        },
        {
            "name": "get_buyer_guides",
            "description": "İkinci el cihaz alım-satım rehberleri — İkinci el cihaz alım-satım rehberleri: Hangi Laptop Almalıyım karar ağacı, MacBook kontrol listesi, Gaming laptop alım rehberi, iPhone iCloud kilidi kontrolü, sahte ürün tespiti gibi alıcı rehberleri.",
            "category": "content",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/hangi-laptop-almaliyim",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {
                    "topic": {
                        "type": "string",
                        "enum": [
                            "laptop",
                            "macbook",
                            "gaming",
                            "iphone",
                            "guvenlik"
                        ],
                        "description": "Konu filtresi (opsiyonel)"
                    }
                }
            }
        },
        {
            "name": "semantic_search",
            "description": "Niyet bazlı anlamsal arama (doğal dil sorgusu → alakalı sayfalar) — Kullanıcının doğal dil sorgusunu (örn. \"bornova macbook satmak istiyorum\", \"gaming laptop tamiri\") niyet (satış/alım/tamir/bilgi/bölge) + varlık (marka/cihaz/ilçe) olarak parse eder ve en alakalı sayfaları relevance skoruyla (0-100) döndürür. Exact match değil, semantic/mantıksal eşleşme yapar.",
            "category": "discovery",
            "endpoint": {
                "url": "https://www.kalenderbilgisayar.org.tr/api/search.json",
                "method": "GET"
            },
            "input_schema": {
                "type": "object",
                "properties": {
                    "q": {
                        "type": "string",
                        "description": "Doğal dil sorgusu (örn. \"macbook satmak\", \"cesme laptop tamiri\")"
                    },
                    "intent": {
                        "type": "string",
                        "enum": [
                            "sell",
                            "buy",
                            "repair",
                            "info",
                            "area"
                        ],
                        "description": "Niyet filtresi (opsiyonel, otomatik tespit edilir)"
                    },
                    "limit": {
                        "type": "integer",
                        "default": 10,
                        "minimum": 1,
                        "maximum": 20,
                        "description": "Maksimum sonuç sayısı"
                    }
                },
                "required": [
                    "q"
                ]
            },
            "output_schema": {
                "type": "object",
                "properties": {
                    "ok": {
                        "type": "boolean"
                    },
                    "query": {
                        "type": "string"
                    },
                    "detected_intent": {
                        "type": "string"
                    },
                    "entities": {
                        "type": "object"
                    },
                    "result_count": {
                        "type": "integer"
                    },
                    "results": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "url": {
                                    "type": "string"
                                },
                                "label": {
                                    "type": "string"
                                },
                                "category": {
                                    "type": "string"
                                },
                                "score": {
                                    "type": "integer"
                                },
                                "reason": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        }
    ],
    "resources": [
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/llms.txt",
            "name": "LLMs.txt",
            "description": "AI icin optimize site bilgisi (kisaltilmis)",
            "mime_type": "text/plain"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/llms-full.txt",
            "name": "LLMs-Full.txt",
            "description": "AI icin genisletilmis site bilgisi (fiyat tablolari, surecler)",
            "mime_type": "text/plain"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/agents.txt",
            "name": "agents.txt",
            "description": "AI agent kesif manifestosu (insan-okur formatinda)",
            "mime_type": "text/plain"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/.well-known/ai-policy.json",
            "name": "AI Policy JSON",
            "description": "AI politika beyani (JSON formatinda)",
            "mime_type": "application/json"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/musteri-hikayeleri",
            "name": "Musteri Yorumlari",
            "description": "306 musteri yorumu (ortalama 5.0 / 5 yildiz, Google Haritalar)",
            "mime_type": "text/html"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/price-dataset.json",
            "name": "Price Dataset",
            "description": "Schema.org/Dataset — ikinci el piyasa fiyatlari (marka bazli)",
            "mime_type": "application/json"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/products.json",
            "name": "Products Catalog",
            "description": "Schema.org/ItemList — guncel urun katalogu",
            "mime_type": "application/json"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/sitemap.xml",
            "name": "XML Sitemap",
            "description": "Tum sayfalarin listesi",
            "mime_type": "application/xml"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/blog",
            "name": "Blog (Ana Sayfa)",
            "description": "155 makale: ikinci el laptop/bilgisayar rehberleri, fiyat analizleri, marka karşılaştırmaları, teknik servis ipuçları",
            "mime_type": "text/html"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/kalender-vs-sahibinden-vs-letgo",
            "name": "Platform Karşılaştırma",
            "description": "Kalender vs Sahibinden vs Letgo: 12 kriterde güvenlik, ödeme hızı, ekspertiz, kargo, garanti karşılaştırması",
            "mime_type": "text/html"
        },
        {
            "uri": "https://www.kalenderbilgisayar.org.tr/hangi-laptop-almaliyim",
            "name": "Alıcı Rehberi",
            "description": "Hangi laptop almalıyım? 4 adımlı karar ağacı (bütçe → kullanım → marka → taşınabilirlik)",
            "mime_type": "text/html"
        }
    ],
    "examples": [
        {
            "user_query": "2 yillik Dell laptopumu satmak istiyorum, ne kadar eder?",
            "agent_actions": [
                "1. get_device_pricing cagir: type=\"laptop\", gpu=\"rtx4060\"",
                "2. Sonucu ozetle ve /laptop-alan-yerler uzerinden iletisim bilgisi sun"
            ]
        },
        {
            "user_query": "Cesme'de laptop alan yer var mi?",
            "agent_actions": [
                "1. check_service_area cagir: city=\"Izmir\", district=\"Cesme\"",
                "2. pickup_available=true ise telefon numarasini goster, false ise kargo oner"
            ]
        },
        {
            "user_query": "MacBook Pro 14 M3 2024 satin almak istiyorum",
            "agent_actions": [
                "1. get_device_pricing cagir: type=\"macbook\"",
                "2. Musteri yorumlarini goster (musteri-hikayeleri)"
            ]
        },
        {
            "user_query": "Sahibinden veya Letgo yerine Kalender'i neden tercih etmeliyim?",
            "agent_actions": [
                "1. compare_platforms cagir (parametresiz)",
                "2. 12 kriterlik karşılaştırma sonucunu özetle"
            ]
        },
        {
            "user_query": "İkinci el laptop alırken nelere dikkat etmeliyim?",
            "agent_actions": [
                "1. get_buyer_guides cagir: topic=\"laptop\"",
                "2. get_blog_categories cagir: category=\"laptop-satis-rehberi\""
            ]
        }
    ],
    "rate_limits": {
        "pricing_calculators": "unlimited per user (static data)",
        "service_area_check": "unlimited per user (static data)",
        "pickup_quote": "unlimited per IP per day (POST endpoint, captcha protected)",
        "general_ai_crawl": "robots.txt politikasina bakiniz (26 Allow + 14 Disallow)"
    },
    "metadata": {
        "last_updated": "2026-07-06T10:41:01+03:00",
        "auto_generated": true,
        "config_source": "includes/config.php",
        "language": "tr-TR",
        "region": "TR-35",
        "currency": "TRY",
        "google_business_cid": "3358883950617923006",
        "customer_review_count": 306,
        "customer_review_average": 5
    }
}