İçeriğe geç

Koduna REST, ajanına MCP.

Aynı anahtar, aynı kredi. İkisinin arkasında aynı motor çalışıyor.

REST

Açık
$ curl -X POST "$ADRESKIT/v1/address/resolve" \
  -H "authorization: Bearer ak_live_…" \
  -H "content-type: application/json" \
  -d '{"q":"kadikoy istanbul moda cad 14"}'

{
  "il": "İstanbul",
  "ilce": "Kadıköy",
  "yol": "Moda Caddesi",
  "binaNo": "14",
  "guven": 0.85,
  "duzeltmeler": ["cad → Caddesi"]
}

$ADRESKIT = https://xacw6yute6famacx6a7tjafkfq0hqmug.lambda-url.eu-central-1.on.aws

Hata her uçta aynı biçimde: {"hata": "…"} ve anlamlı bir HTTP durum kodu.

MCP

Açık

Kurulacak paket yok: MCP adresi ve API anahtarı yeter. 99 araç, REST'le aynı kredi. Araç listesi ücretsiz; kredi yalnız araç çağrısında düşer.

Terminalde bir kez çalıştır:

claude mcp add --transport http adreskit https://xacw6yute6famacx6a7tjafkfq0hqmug.lambda-url.eu-central-1.on.aws/mcp \
  --header "Authorization: Bearer ak_live_…"

Tüm projelerde kullanmak için komuta --scope user ekle.

Araçlar: adres_coz, adres_toplu_coz, adres_ayristir, posta_kodu_ilce, plaka_il, barkod_kontrol, adres_listesi, ters_geokod, mesafe, sokak_tamamla, iban_dogrula, iban_toplu_dogrula, iban_bankalar, kur_listesi, kur_cevir, kur_ecb, nobetci_eczane, akaryakit_fiyat, son_depremler, ibb_trafik, ibb_otopark, ibb_hava_kalitesi, ibb_metro_durum, ibb_nokta_ara, altin_fiyati, baraj_doluluk, hava_durumu, vergi_dairesi_bul, tufe, kira_artis_orani, enerji_tarifesi, universite_listesi, program_ara, sinav_takvimi, avukatlik_ucreti, noter_ucreti, ilac_ara, gecis_ucreti, okul_ara, vergi_parametreleri, gelir_vergisi_hesapla, kdv_hesapla, mtv_hesapla, bordro_hesapla, tazminat_hesapla, asgari_ucret, trafik_cezasi, trafik_cezasi_indirim, harc, tapu_harci, emlak_vergisi, damga_vergisi, veraset_vergisi, hal_fiyat, resmi_gazete, tckn_dogrula, vkn_dogrula, telefon_dogrula, kargo_takip, takip_no_tani, kargo_etiketi, teslim_tahmini, is_gunu_ekle, namaz_vakitleri, hicri_tarih, kvkk_maskele, cayma_hakki, fatura_suresi, il_bilgi, nufus, il_ilceler, alan_kodu, bolge_listesi, yaziyla, slug, adres_ayni_mi, adres_kisaltma, turkce_sirala, ad_normalize, turkce_ek, tarih_ayristir, turkcelestir, metin_ayikla, desi, test_verisi_uret, resmi_tatiller, gun_bilgisi, is_gunu_say, futbol_ligler, futbol_takimlar, futbol_puan_durumu, futbol_fikstur, futbol_sonuclar, futbol_gol_kralligi, futbol_mac, futbol_form, futbol_h2h, futbol_olasilik, futbol_xg.

npm paketleri

Yakında

İkisi de yazıldı, henüz npm'de yayımlanmadı; aşağıdaki komutlar bugün çalışmaz. O güne kadar REST'i doğrudan, MCP'yi yukarıdaki kurulumla kullan.

adreskit TypeScript SDK

Her uç için tipli metot, sıfır bağımlılık, fetch üstünde. Node 18+, tarayıcı, Workers, Deno ve Bun.

npm i adreskit

import { Adreskit } from 'adreskit';
const ak = new Adreskit({ anahtar: process.env.ADRESKIT_ANAHTAR });
await ak.adres.cozumle({ adres: 'cankaya ankara kızılay mah' });

adreskit-mcp MCP köprüsü

Claude Desktop, Cursor ve Windsurf için yerel stdio köprüsü; mcp-remote gerekmez. Araç tanımları sunucuda durur, paket güncellenmeden yeni araçlar görünür.

{
  "mcpServers": {
    "adreskit": {
      "command": "npx",
      "args": [
        "-y",
        "adreskit-mcp"
      ],
      "env": {
        "ADRESKIT_ANAHTAR": "ak_live_…"
      }
    }
  }
}