Ajan erişimi

Yapay zekâ ajanları için su hukuku verisi

MCP ucu · 11 salt-okunur araç · JSON-RPC 2.0 · kimlik doğrulama yok.

Özet

Su Haritası, yapay zekâ ajanları ve geliştiriciler için MCP (Model Context Protocol) ucu sunar: https://suharitasi.com/mcp. Uç salt-okunur; mevzuat maddesi, emsal karar, havza/il verisi, kısıt kaydı, su riski, baraj, uydu ve tahmin araçlarını JSON-RPC 2.0 ile döner. Kimlik doğrulama gerekmez; yanıtlar yayımlı resmî kaynaklardan derlenir, hukuki görüş değildir.

Uç noktası

POST https://suharitasi.com/mcp — MCP Streamable HTTP, JSON-RPC 2.0.GET aynı yolda sunucu kartını (araç ve kaynak listesi) döner. Oturum gerekmez; yanıtlar application/json gelir.

curl -s https://suharitasi.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"mevzuat_sorgu",
                 "arguments":{"kelime":"isletme sahasi","limit":2}}}'

→ {"jsonrpc":"2.0","id":1,"result":{
     "content":[{"type":"text","text":"…"}],
     "isError":false}}

Araçlar (11)

Araçlar yalnız yayımlı açık veriyi okur; hiçbir alan üretilmez. Kaynak okunamazsa araç hata döner, uydurma yanıt vermez.

MCP araç adı, işlevi ve parametreleri (inputSchema).
Araç	İşlev	Parametreler
`havza_sorgu`	Türkiye su havzası künyesi: yağış alanı, yüzey suyu potansiyeli, yeraltısuyu beslenimi/işletme rezervi ve NHYP bağlantısı. Havza numarası veya adıyla arar.	`sorgu` (string, zorunlu) — Havza no (ör. 01) veya ad (ör. Ergene)
`il_sorgu`	Bir ilin bağlı olduğu DSİ bölge müdürlüğü, havzalar ve su/kanalizasyon idaresi. İl adıyla arar.	`il` (string, zorunlu) — İl adı (ör. Adana)
`mevzuat_sorgu`	Su mevzuatı maddelerini resmî metniyle arar (167, 831, 2886, 2942, 5393, 5686, 6200, YAS Tüzüğü, Su Tahsisleri Yön.). Kelime, kanun kısaltması veya madde numarasıyla.	`kelime` (string) — Arama kelimesi (metin içinde) `kanun` (string) — Kanun kısaltması (ör. 167, YAS Tüzüğü) `limit` (integer) — En çok kaç kayıt (varsayılan 5, en çok 20)
`emsal_sorgu`	Resmî karar arama sunucusunda doğrulanmış su hukuku emsal kararlarını arar (künye, karar tarihi, karar metninden dava konusu alıntısı, resmî metin ve karar sayfası bağlantısı). Konu, merci veya yılla.	`kelime` (string) — Konu/özet içinde arama `merci` (string) — Daire (ör. 8. Daire) `yil` (integer) — Karar yılı `limit` (integer) — En çok kaç kayıt (varsayılan 5, en çok 20)
`sozluk_sorgu`	Su hukuku/yönetimi sözlüğünde terim arar (terim + mevzuat kaynağı).	`kelime` (string, zorunlu) — Terim `limit` (integer)
`kisit_sorgu`	Resmî Gazete işletme sahası / su tahsisine kapatma-kısıt kayıtlarını il veya kelimeyle arar (tarih + kaynak bağlantısı).	`il` (string) — İl adı `kelime` (string) — Saha/durum içinde arama `limit` (integer)
`islem_sorgu`	İdari su işlemlerini arar: hangi işlem için hangi kurum, hangi mevzuat dayanağı ve başvuru kanalı.	`kelime` (string, zorunlu) — İşlem adı/dayanak `limit` (integer)
`su_riski_sorgu`	Su Riski Endeksi: il veya havza için puan, kategori ve bileşenler (GRACE, baraj, YAS, tahsis, yüzey suyu). Şeffaf bileşik göstergedir; resmî sınıflama değildir.	`il` (string) `havza` (string)
`baraj_sorgu`	Baraj doluluğu (EPİAŞ, günlük): ülke ortalaması ya da havza ortalaması, ölçüm tarihi, baraj sayısı ve 30 günlük değişim. Ortalama tanımı: son ölçüm gününde bildiren barajların basit ortalaması.	`havza` (string) — Havza adı (ör. Gediz); boş bırakılırsa ülke ortalaması ve bütün havzalar
`uydu_sorgu`	Uydu (GRACE/GRACE-FO) su depolama eğilimi: havza için son 5 yılın eğimi (cm/yıl) ve sınıfı; ya da Türkiye aylık anomali serisinin son ayları. Değişim verisidir, mutlak su miktarı değildir.	`havza` (string) — Havza adı; boşsa bütün havzalar `turkiye_ay` (integer) — Türkiye serisinden son kaç ay (en çok 60)
`tahmin_sorgu`	İstatistiksel projeksiyon: havza için 6 aylık uydu su depolama ve 30/60 günlük baraj doluluğu tahmini, olası bantlarıyla. ÖLÇÜM DEĞİLDİR; gerçekleşmesi garanti edilmez.	`havza` (string, zorunlu) — Havza adı (ör. Konya Kapalı)

İstemciye ekleme

Uzak (HTTP) MCP sunucusu destekleyen istemcilerde adres https://suharitasi.com/mcp, taşıma türü HTTP'dir; kimlik bilgisi gerekmez. Örnek (Claude Code):

claude mcp add --transport http su-haritasi https://suharitasi.com/mcp

Yapılandırma dosyası kullanan istemciler için genel biçim:

{
  "mcpServers": {
    "su-haritasi": { "type": "http", "url": "https://suharitasi.com/mcp" }
  }
}

Kaynaklar ve kullanım

Uç, sitenin açık veri çıktısını sunar (25 havza, 81 il, mevzuat maddeleri, resmî sunucuda doğrulanan emsal kararlar, kısıt kayıtları, su riski, baraj doluluğu, uydu eğilimi ve projeksiyon). Kullanım koşulları: lisans. Yanıtlar bilgilendirme amaçlıdır; hukuki görüş değildir. Geliştirici dokümantasyonu ve OpenAPI şeması için açık veri portalı; sözlük ve küratörlü bilgi bankası için veri sayfası.

Bu sayfa bilgilendirme amaçlıdır; somut bir uyuşmazlığa dair hukuki görüş veya tavsiye niteliği taşımaz.