akakce-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AKAKCE_EMAIL | No | Akakçe account email for automated login. Used together with AKAKCE_PASSWORD for authenticated features. | |
| AKAKCE_COOKIE | No | Akakçe session cookie value, e.g. AAATLGST=... Used to enable authenticated account features. | |
| AKAKCE_PASSWORD | No | Akakçe account password for automated login. Used together with AKAKCE_EMAIL for authenticated features. | |
| FIREWORKS_API_KEY | No | Optional Fireworks API key used by akakce_llm_enrich for LLM enrichment. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| akakce_autocompleteA | Akakçe arama önerileri. Bir arama ifadesi için ürün/kategori önerilerini ve (varsa) ürün kodlarını döndürür. Kullanıcı tam ürün adını bilmiyorsa önce bununla doğru ifadeyi/kodu bul. |
| akakce_searchA | Akakçe'de ürün arar ve fiyatlı sonuç listesi döndürür. Her ürün: ad, marka, en düşük fiyat, satıcı sayısı, rating, ürün kodu (price/detail için kullan) ve ürün sayfası URL'i. Sayfalama (page) ve filtreleme (ctCode + filterIds, bunları akakce_search_filters'tan al) destekler. |
| akakce_search_filtersA | Bir arama ifadesi için uygulanabilir filtre gruplarını (marka, özellik, RAM, vb.) ve her filtrenin id'sini döndürür. Dönen filtre id'lerini akakce_search'e filterIds olarak vererek sonucu daraltabilirsin. |
| akakce_category_browseA | Bir kategori kodunu (ctCode) gezerek o kategorideki ürünleri ve hızlı filtreleri (quickFilters) döndürür. filterIds vererek daraltabilirsin. ctCode'u arama sonuçlarından/ürün URL'lerinden ya da akakce_search_filters çıktısından elde edebilirsin. |
| akakce_home_feedA | Akakçe ana sayfasının bileşenlerini (keşfet/slider kartları: aktüel ürünler, kampanyalar, koleksiyonlar vb.) ve yönlendirme URL'lerini döndürür. Giriş gerektirmez. |
| akakce_dealsA | Akakçe'de son yakalanan indirimleri (fiyatı yeni düşen ürünler) döndürür. Giriş gerektirmez. |
| akakce_product_pricesA | Bir veya daha fazla ürün kodu için Akakçe'deki en ucuz satıcıları (quickview) döndürür: fiyat, kargo, satıcı adı, son güncelleme ve satıcıya gidiş linki. Ürün kodlarını akakce_search / akakce_autocomplete sonuçlarından al. Birden çok kodu tek çağrıda ver (toplu). |
| akakce_quickviewA | Tek bir ürün kodu için en ucuz satıcı(ları) hızlıca döndürür (akakce_product_prices'ın tekli/hafif sürümü). Giriş gerektirmez. |
| akakce_product_detailA | Bir ürünün tam detayını döndürür: ad, marka, teknik özellikler, ortalama puan, en düşük/en yüksek fiyat ve TÜM satıcıların listesi (fiyat, kargo, satıcı puanı, teslimat, satıcıya direkt gidiş linki). Sadece ürün |
| akakce_price_historyA | Bir ürünün fiyat geçmişi grafiğini döndürür. Akakçe geçmişi yalnızca hazır bir grafik GÖRSELİ (PNG) olarak sunar — sayısal veri noktası yoktur. Sonuçta grafiğin doğrudan görüntü URL'i döner (kullanıcıya gösterilebilir). Sadece ürün |
| akakce_loginA | Akakçe hesabına giriş yapar ve oturumu (AAATLGST çerezi) ~/.config/akakce-mcp/session.json içine kaydeder. Giriş sonrası favoriler, fiyat alarmları ve bildirim tool'ları çalışır. Kimlik bilgilerini parametre vermezsen AKAKCE_EMAIL / AKAKCE_PASSWORD ortam değişkenleri kullanılır. Oturum ~1 yıl geçerlidir; tekrar giriş gerekmez. |
| akakce_logoutA | Kaydedilmiş Akakçe oturumunu siler (session.json). |
| akakce_account_infoA | Giriş yapılmış kullanıcının profil bilgisini döndürür (ad, e-posta, il/ilçe, bildirim sayısı). Giriş gerektirir. |
| akakce_favoritesA | Favori listelerini döndürür. |
| akakce_favorite_addB | Bir veya daha fazla ürünü favorilere (varsayılan listeye) ekler. Ürün kod(lar)ını ver. Giriş gerektirir. |
| akakce_favorite_removeA | Bir ürünü favori listesinden çıkarır. Ürün kodu (code) ve listId ver (listId'yi akakce_favorites'ten al). Giriş gerektirir. |
| akakce_price_alertsA | Kurulu fiyat alarmlarını listeler: ürün, hedef fiyat ve mevcut fiyat. Giriş gerektirir. |
| akakce_price_alert_setA | Bir ürün için fiyat alarmı kurar/günceller: fiyat hedef değere düşünce bildirim gelir. Ürün kodu ve hedef fiyat (TL) ver. Giriş gerektirir. |
| akakce_notificationsA | Fiyat düşüşü bildirimlerini döndürür (ürün, yeni fiyat, düşüş oranı, tarih). Giriş gerektirir. |
| akakce_llm_enrichA | Akakçe arama/fiyat sonuçlarını bir LLM ile yorumlar: özetler, normalize eder, karşılaştırır veya verilen talimata göre filtreler. SADECE Fire-Pass guard'lı Kimi K2.6 Turbo ile çalışır. FIREWORKS_API_KEY tanımlı değilse devre dışıdır. Girdi olarak diğer akakce_* tool'larından aldığın JSON'u (ürünler/satıcılar) ver. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 20 tools
Most tools target distinct Akakçe resources or workflows: search, category browsing, product detail, favorites, alerts, and account are clearly separated. The main overlap is price retrieval: akakce_product_prices, akakce_quickview, and akakce_product_detail all return seller/price data, though the descriptions distinguish bulk, single lightweight, and full-detail use cases.
All tools use the same akakce_ prefix and snake_case, making the set highly readable. However, the pattern mixes verb-noun forms (akakce_favorite_add) with noun-only forms (akakce_deals, akakce_quickview, akakce_notifications), which is a minor inconsistency rather than a serious problem.
Twenty tools is reasonable for a full shopping/price-comparison server spanning search, favorites, alerts, account, and notifications. Still, 20 falls in the heavy range, and a few tools such as akakce_quickview and akakce_llm_enrich feel like optional conveniences rather than essential surface area.
The server covers the main Akakçe workflows well: discovery, search/filtering, price lookup, product detail, price history, authentication, favorites, alerts, and notifications. Minor gaps remain around full favorite-list lifecycle management (no create/delete list) and alert lifecycle (no explicit alert deletion), but these are workaroundable.