İhale MCP
This server provides a Model Context Protocol (MCP) interface for searching and analyzing Turkish public procurement data from EKAP and official government announcements from ilan.gov.tr.
Search EKAP tenders with rich filters: tender type, province, IKN year/number, date ranges, OKAS codes, authority IDs, and 17+ boolean filters (e-İhale, joint procurement, partial bids, foreign bidders, etc.)
Retrieve tender details for a specific tender ID, including characteristics, OKAS codes, authority info, process rules, and cancellation data
Fetch tender announcements (pre-announcement, tender notice, result notice, cancellation, etc.) with automatic HTML-to-Markdown conversion; result notices include parsed winner, contract amount, estimated cost, and bid counts
Find recent tenders from the last N days (1-30)
Search OKAS classification codes by keyword and item type (goods, services, construction)
Search Turkish government authorities/institutions (ministries, municipalities, universities) for filtering
Search tenders won by a specific bidder by scanning narrowed result announcements (with a required scope and safeguards)
Search Direct Procurements (Doğrudan Temin) with filters for year, number, type, status, scope, province, dates, authority, and e-price offer; also fetch DT details and look up authorities/parent authorities
Search official government ads on ilan.gov.tr across categories (real estate, vehicle, personnel, tender notices, legal notices, UYAP e-sales, etc.) with filters for city, price, publish date, and ad type
Get detailed ilan.gov.tr ad content with HTML-to-Markdown conversion, advertiser, location, and category info
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@İhale MCP search for construction tenders in Istanbul from last month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
İhale MCP: Türkiye Kamu İhaleleri için MCP Sunucusu
Bu proje, Türkiye'deki kamu ihalelerine (ekap.kik.gov.tr) erişimi kolaylaştıran bir FastMCP sunucusu oluşturur. Bu sayede, EKAP v2 portalından ihale arama, ihale detaylarını getirme ve ihale duyurularını Markdown formatında alma işlemleri, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları (örneğin Claude Desktop veya 5ire) ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.
🚀 5 Dakikada Başla (Remote MCP)
✅ Kurulum Gerektirmez! Hemen Kullan!
🔗 Remote MCP Adresi: https://ihale.surucu.dev/mcp
Claude Desktop ile Kullanım
Claude Desktop'ı açın
Settings → Connectors → Add Custom Connector
Bilgileri girin:
Name:
İhale MCPURL:
https://ihale.surucu.dev/mcp
Add butonuna tıklayın
Hemen kullanmaya başlayın! 🎉
🎯 Temel Özellikler
EKAP v2 portalına programatik erişim için standart bir MCP arayüzü.
Aşağıdaki yetenekler:
Detaylı İhale Arama: İhale adı/içeriği, IKN numarası, ihale türü, il, tarih aralıkları ve 17+ boolean filtre ile kapsamlı arama.
İhale Detayları: Belirli bir ihalenin tam detaylarını (özellikler, OKAS kodları, idare bilgileri, işlem kuralları) getirme.
İhale Duyuruları: İhale ile ilgili tüm duyuruları (Ön İlan, İhale İlanı, Sonuç İlanı vb.) otomatik HTML-to-Markdown dönüşümü ile getirme.
OKAS Kod Arama: Türk kamu alım sınıflandırma kodlarında arama yapma.
İdare Arama: Bakanlık, belediye, üniversite gibi kamu kurumlarını arama.
İlan.gov.tr Entegrasyonu: Resmi devlet ilanları, UYAP e-satış, icra/mahkeme satışları, kamu personel duyuruları ve tebligat aramalar.
İhale metinlerinin LLM'ler tarafından daha kolay işlenebilmesi için HTML'den Markdown formatına çevrilmesi.
Claude Desktop uygulaması ile kolay entegrasyon.
İhale MCP, 5ire gibi Claude Desktop haricindeki MCP istemcilerini de destekler.
🚀 Claude Haricindeki Modellerle Kullanmak İçin Çok Kolay Kurulum (Örnek: 5ire için)
Bu bölüm, İhale MCP aracını 5ire gibi Claude Desktop dışındaki MCP istemcileriyle kullanmak isteyenler içindir.
Python Kurulumu: Sisteminizde Python 3.11 veya üzeri kurulu olmalıdır. Kurulum sırasında "Add Python to PATH" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. Buradan indirebilirsiniz.
Git Kurulumu (Windows): Bilgisayarınıza git yazılımını indirip kurun. "Git for Windows/x64 Setup" seçeneğini indirmelisiniz.
uvKurulumu:Windows Kullanıcıları (PowerShell): Bir CMD ekranı açın ve bu kodu çalıştırın:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"Mac/Linux Kullanıcıları (Terminal): Bir Terminal ekranı açın ve bu kodu çalıştırın:
curl -LsSf https://astral.sh/uv/install.sh | sh
Microsoft Visual C++ Redistributable (Windows): Bazı Python paketlerinin doğru çalışması için gereklidir. Buradan indirip kurun.
İşletim sisteminize uygun 5ire MCP istemcisini indirip kurun.
5ire'ı açın. Workspace -> Providers menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
Tools menüsüne girin. +Local veya New yazan butona basın.
Tool Key:
ihalemcpName:
İhale MCPCommand:
uvx --from git+https://github.com/saidsurucu/ihale-mcp ihale-mcpSave butonuna basarak kaydedin.
Şimdi Tools altında İhale MCP'yi görüyor olmalısınız. Üstüne geldiğinizde sağda çıkan butona tıklayıp etkinleştirin (yeşil ışık yanmalı).
Artık İhale MCP ile konuşabilirsiniz.
⚙️ Claude Desktop Manuel Kurulumu
Ön Gereksinimler: Python,
uv, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.Claude Desktop Settings -> Developer -> Edit Config.
Açılan
claude_desktop_config.jsondosyasınamcpServersaltına ekleyin:{ "mcpServers": { "İhale MCP": { "command": "uvx", "args": [ "--from", "git+https://github.com/saidsurucu/ihale-mcp", "ihale-mcp" ] } } }Claude Desktop'ı kapatıp yeniden başlatın.
Not: EKAP v2, API isteklerini insan doğrulamasına (Cloudflare Turnstile) bağladı. İhale MCP bu doğrulamayı yerleşik tarayıcısıyla otomatik geçer; ek bir işlem gerekmez. Doğrulama çerezi yaklaşık 5 dakika geçerlidir; süresi dolunca ilk istek birkaç saniye daha uzun sürer.
🛠️ Kullanılabilir Araçlar (MCP Tools)
Bu FastMCP sunucusu LLM modelleri için aşağıdaki araçları sunar:
search_tenders: EKAP v2 portalında kapsamlı ihale arama yapar.Ana Parametreler:
search_text,ikn_year,ikn_number,tender_types,tender_date_start/end,announcement_date_start/endBoolean Filtreler:
e_ihale,ortak_alim_mi,kismi_teklif_mi,yabanci_isteklilere_izin_veriliyor_muve 13+ daha fazla filtreListe Filtreleri:
provinces,tender_statuses,tender_methods,okas_codes,authority_ids,proposal_types,announcement_typesArama Kapsamı:
search_in_title,search_in_announcement,search_in_tech_specvb. 11 farklı alanDöndürdüğü Değer: Sayfalanmış ihale listesi, toplam sonuç sayısı
search_okas_codes: OKAS (kamu alım sınıflandırma) kodlarında arama yapar.Parametreler:
search_term,kalem_turu(1=Mal, 2=Hizmet, 3=Yapım),limitDöndürdüğü Değer: OKAS kodları, açıklamaları ve kategorileri
search_authorities: Türk kamu kurumlarında arama yapar.Parametreler:
search_term,limitDöndürdüğü Değer: Kurum ID'leri, isimleri ve hiyerarşik bilgileri
get_recent_tenders: Son N gündeki ihaleleri getirir.Parametreler:
days(1-30),tender_types,limitDöndürdüğü Değer: Yakın tarihli ihale listesi
get_tender_announcements: Belirli bir ihalenin tüm duyurularını getirir.Parametreler:
tender_idDöndürdüğü Değer: Otomatik HTML-to-Markdown dönüştürülmüş ihale duyuruları
Sonuç İlanları için ek: Sonuç İlanı (tip 4) duyuruları ayrıca ayrıştırılmış bir
result_infonesnesi taşır:winner(yüklenici),contract_amount(sözleşme bedeli),estimated_cost(yaklaşık maliyet),bid_count,valid_bid_count,contract_date. Böylece istemcinin markdown'ı regex ile ayıklaması gerekmez.
search_tender_results_by_bidder: Bir firmanın kazandığı ihaleleri, daraltılmış bir kapsamdaki sonuç ilanlarını tarayarak bulur.Parametreler:
bidder_name(zorunlu),authority_ids/provinces/okas_codes(en az biri zorunlu),date_start,date_end,tender_types,max_tendersDöndürdüğü Değer:
matches(İKN, yüklenici, sözleşme bedeli, yaklaşık maliyet, teklif sayısı),match_count,scanned_tenders⚠️ Bu bir taramadır, tam indeks değildir. EKAP'ın metin arama indeksi sonuç ilanlarını kapsamaz; kazanan adı orada aranamaz. Bu nedenle bir firmanın kazandığı tüm ihaleleri listelemek mümkün değildir. Kapsam daraltılmadan (idare/il/OKAS) araç çalışmaz; kapsam
max_tenders'ı aşarsa sessizce kesmek yerine gerçek kapsam büyüklüğüyle hata döner.Kısmi teklifli ihalelerde her kısım ayrı kayıt olarak döner (
announcement_index).
get_tender_details: Belirli bir ihalenin kapsamlı detaylarını getirir.Parametreler:
tender_idDöndürdüğü Değer: İhale özellikleri, OKAS kodları, idare bilgileri, işlem kuralları ve otomatik markdown'a çevrilmiş duyuru özetleri
search_ilan_ads: İlan.gov.tr'de resmi devlet ilanlarında arama yapar.Parametreler:
search_text,city_plate,ad_type_filter,ad_source_filter,publish_date_min/max,price_min/maxİlan Türleri: İCRA, İHALE, TEBLİGAT, PERSONEL
İlan Kaynakları: UYAP (E-SATIŞ icra/mahkeme satışları), BIK (Basın İlan Kurumu)
Döndürdüğü Değer: Resmi devlet ilanları, kategori bilgileri, şehir sayıları
get_ilan_ad_detail: Belirli bir ilan için detaylı bilgileri getirir.Parametreler:
ad_idDöndürdüğü Değer: İlan başlığı, otomatik HTML-to-Markdown çevrilmiş içerik, ilan veren kurum bilgileri, lokasyon, kategoriler
🧩 Doğrudan Temin (Direct Procurement – Doğrudan Temin) Araçları
Doğrudan Temin ekranındaki filtrelerle uyumlu ek MCP araçları:
search_direct_procurements: Doğrudan Temin listesi (Direct Procurement list).Önemli Parametreler (English with Türkçe):
year (Yıl),dt_no / dt_number (DT No / DT Sayı)dt_type (Tür): 1=Goods (Mal), 2=Construction (Yapım), 3=Service (Hizmet), 4=Consultancy (Danışmanlık)e_price_offer (E‑Fiyat Teklifi)→eihale=true/falsestatus_id/status_text (Durum): 202=Doğrudan Temin Duyurusu Yayımlanmış, 3=Teklifler Değerlendiriliyor, 4=Doğrudan Temin Sonuçlandırıldı, 5=Sonuç Bilgileri Gönderildi, 15=Sonuç Duyurusu Yayımlanmışdate_start/date_end (Teklif tarihi)→dtTarihiBaslangic/Bitisprovince_plate/province_name (İl)scope_id/scope_text (Kapsam): 101=4734, 102=İstisna, 103=Kapsam Dışıauthority_id (İdare ID token)(idareAra’dan),parent_authority_code (Bağlı Olduğu Üst İdare / ustIdareKod)
Not: Bazı filtreler (Durum/Kapsam/İdare) oturum gerektirebilir. Gerekirse
cookies(Çerez) header değeri verilebilir; istemci ayrıca otomatik ısınma (warm‑up) yapar.
get_direct_procurement_details: DT detayları (Details) –dogrudanTeminId (E10)+idareId (E11)ile.search_direct_procurement_authorities: İdare (Authority) araması; dönentoken,search_direct_procurementsiçindeauthority_idolarak kullanılır.search_direct_procurement_parent_authorities: Üst İdare (Parent Authority) araması; dönentoken,parent_authority_code (ustIdareKod)olarak kullanılır.
Örnek (Examples)
search_direct_procurements(
dt_type=1, # Goods (Mal)
province_name="Antalya", # İl adı
status_text="Doğrudan Temin Duyurusu Yayımlanmış",
date_start="2025-09-01",
date_end="2025-09-11"
)
# İdare ara → token’ı listede kullan
search_direct_procurement_authorities("antalya")
# => take authorities[0].token as authority_id
search_direct_procurements(
authority_id="<EIdareToken>",
parent_authority_code="44|07", # Bağlı Olduğu Üst İdare (ustIdareKod)
year=2025, dt_number=1493227
)Related MCP server: Taiwan Tender MCP
İhale Türleri
1 - Mal: Malzeme ve ekipman alımları
2 - Yapım: İnşaat ve altyapı projeleri
3 - Hizmet: Hizmet sözleşmeleri
4 - Danışmanlık: Danışmanlık hizmetleri
Örnek Kullanımlar
EKAP v2 İhaleleri
Pazar Araştırması: Belirli sektör veya bölgelerdeki fırsatları takip etme
Uygunluk İzleme: Mevzuata uygunluk için ihale duyurularını takip etme
İş Zekası: Kamu harcama modellerini ve trendlerini analiz etme
Bildirim Sistemleri: Belirli ihale türleri için uyarı sistemleri kurma
Veri Analizi: Araştırma ve analiz için ihale verilerini çıkarma
İlan.gov.tr Resmi İlanları
UYAP E-SATIŞ Takibi: İcra dairesi ve mahkeme satışlarını izleme
Personel Duyuruları: Kamu personel alım ilanlarını takip etme
Tebligat İzleme: Resmi tebligat ve duyuruları takip etme
Belediye İhaleleri: Yerel yönetim ihale ilanlarını izleme
Emlak Satışları: Kamu kurumlarının emlak satış ilanları
Yeni Özellikler
✅ 17+ Boolean Filtre: e-İhale, ortak alım, kısmi teklif, yabancı katılım vb. ✅ Liste Filtreleri: İller, ihale durumları, usulleri, OKAS kodları, idare ID'leri ✅ Arama Kapsamı Kontrolü: IKN, başlık, duyuru, teknik şartname vb. alanlarda arama ✅ İdare Arama: 72,000+ kamu kurumunda arama (bakanlık, belediye, üniversite) ✅ İhale Duyuruları: Otomatik HTML-to-Markdown dönüşümü ile tam duyuru metinleri ✅ Kapsamlı İhale Detayları: Tüm ihale metadata'sı, özellikler, kurallar bir arada ✅ İlan.gov.tr Entegrasyonu: 20,000+ resmi devlet ilanı aramalar ✅ UYAP E-SATIŞ: 46,000+ icra/mahkeme satış ilanlarına özel erişim ✅ İlan Detayları: Otomatik HTML-to-Markdown dönüşümü ile tam ilan içerikleri ✅ Çoklu İlan Türü: İCRA, İHALE, TEBLİGAT, PERSONEL kategorileri
API Hız Limitleri
Bu sunucu EKAP portalının hız limitlerini gözetir. Üretim kullanımı için aşağıdakileri göz önünde bulundurun:
API çağrılarını azaltmak için istek önbellekleme
Üstel geri çekilme ile yeniden deneme mantığı
Yüksek hacimli kullanım için istek sırası
📜 Lisans
Bu proje MIT Lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.
Sorumluluk Reddi
Bu, Türk hükümetinin EKAP portalı ile resmi olmayan bir entegrasyondır. Kullanıcılar portalın hizmet şartlarına ve geçerli düzenlemelere uymakla yükümlüdür. Yazarlar Türk hükümeti veya EKAP portalı ile bağlantılı değildir.
Available Tools
12 toolsget_direct_procurement_detailsC
Get Direct Procurement (Doğrudan Temin) details (dtDetayGetir) using tokens.
Inputs: dogrudan_temin_id (required), idare_id (required), cookies. Returns: object
get_ilan_ad_detailB
Get detailed information for a specific advertisement from ilan.gov.tr.
Returns: title, content (HTML and Markdown), advertiser info, location, categories, filters, hit count, and other advertisement metadata.
Inputs: ad_id (required). Returns: object
get_recent_tendersB
Get recent tenders from last N days. Convenience function for recent tender activity.
Inputs: days, limit, tender_types. Returns: object
get_tender_announcementsC
Get all announcements for a tender with HTML-to-Markdown conversion.
Returns: Ön İlan, İhale İlanı, Sonuç İlanı, İptal İlanı, etc.
Inputs: tender_id (required). Returns: object
get_tender_detailsB
Get comprehensive tender details with HTML-to-Markdown conversion.
Returns: basic info, characteristics, OKAS codes, authority details, process rules, announcements summary, cancellation info if applicable.
Inputs: tender_id (required). Returns: object
search_authoritiesB
Search Turkish government authorities/institutions.
Find ministries, municipalities, universities for tender filtering. Search in Turkish for best results.
Inputs: limit, search_term. Returns: object
search_direct_procurement_authoritiesC
Search authorities (İdare) for Direct Procurement (idareAra). Use returned 'token' as idareId.
Inputs: cookies, search_term. Returns: object
search_direct_procurement_parent_authoritiesB
Search parent authorities (Üst İdare) via ustIdareAra. Pass returned 'token' to parent_authority_code (ustIdareKod).
Inputs: cookies, search_term. Returns: object
search_direct_procurementsB
Search Direct Procurements (Doğrudan Temin) via EKAP (YeniIhaleAramaData.ashx, metot=dtAra). Returns: dt_no, title, authority, type, due_datetime, announcement_date, province_plate, has_announcement, has_document.
Inputs: authority_id, cookies, date_end, date_start, +16 more. Returns: object
search_ilan_adsA
Search Turkish government announcements and advertisements on ilan.gov.tr.
Returns: public announcements, tender notices, real estate sales, notifications, government job postings, legal notices, UYAP e-sales, and other official advertisements.
Categories include: Emlak, İhale Duyuruları, Tebligat ve Duyurular, Kamu-Akademik Personel, İflas Hukuku Davaları, Vasıta, UYAP E-SATIŞ (icra/mahkeme satışları), etc.
Sources: BIK (Basın İlan Kurumu), UYAP (E-SATIŞ icra/mahkeme satışları)
Inputs: ad_type_filter, category, city_plate, current_page, +9 more. Returns: object
search_okas_codesB
Search OKAS procurement classification codes.
Item types: 1=Goods, 2=Service, 3=Construction Search in Turkish descriptions for best results.
Inputs: kalem_turu, limit, search_term. Returns: object
search_tendersC
Search Turkish government tenders from EKAP v2 portal.
Tender types: 1=Mal, 2=Yapım, 3=Hizmet, 4=Danışmanlık Provinces: Use plate numbers (6=Ankara, 34=İstanbul, 35=İzmir) IKN format: YEAR/NUMBER, dates: YYYY-MM-DD
Inputs: alt_yuklenici_calistirilabilir_mi, alternatif_teklif_verilebilir_mi, announcement_date_end, announcement_date_filter, +47… Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have distinct purposes targeting specific resources like tenders, direct procurements, authorities, or advertisements, with clear boundaries. However, some overlap exists between search_tenders and get_recent_tenders, which could cause confusion as both relate to tender listings, though descriptions help differentiate them by recency versus comprehensive search.
Tool names follow a highly consistent verb_noun pattern throughout, such as get_direct_procurement_details, search_authorities, and get_tender_details. All tools use snake_case with clear, descriptive names, making them predictable and easy to understand for agents.
With 12 tools, the server is well-scoped for its domain of Turkish government procurement and announcements. Each tool serves a specific function, such as searching, retrieving details, or filtering, covering key aspects without being overly broad or sparse, which is appropriate for this complex domain.
The tool set provides comprehensive coverage for searching and retrieving information on tenders, direct procurements, authorities, advertisements, and classification codes, supporting core workflows. A minor gap exists in update or action-oriented tools, such as submitting bids or managing notifications, but agents can work around this with the available read-focused operations.
Maintenance
Related MCP Connectors
Resmî Kamu İhale Bülteni (EKAP) üzerinden CAPTCHA'sız/girişsiz ihale ilanı arşivleme ve arama,…
Search EU, UK and US public tenders, look up award history, and get alerts on new matches.
Search EU public tenders from TED and national portals by CPV code, country, buyer or value.
Open public tenders and awards: EU TED, US SAM.gov, UK Find a Tender, AusTender.
Related MCP Servers
- AlicenseBqualityCmaintenanceProvides AI models with access to Ukrainian government procurement data from Prozorro, enabling search and retrieval of tender information by organization, date range, and other criteria.19 npm12ISC
- FlicenseAqualityNot gradedmaintenanceEnables users to search and retrieve detailed information about Taiwan government procurement tenders through the Government Electronic Procurement System API. It supports searching tenders by keyword, category code, date, and government unit.6-
- FlicenseAqualityDmaintenanceEnables searching and analyzing Polish public procurement tenders from BZP and TED, including filtering, tender details and timelines, offers and contract values, buyer/contractor profiles, CPV code lookup, and regional statistics, with optional AI-summary endpoints.121-
- AlicenseNot gradedqualityDmaintenanceEnables searching and analyzing government tenders, contract awards, and pre-tender pipelines from 21 official sources, with tools for tender search, award intelligence, and detailed notice retrieval.MIT