MTV Hesaplama: API ve MCP

MTV Hesaplama için REST ve MCP başvurusu: girdi alanları, sınırlar, çıktılar, örnek istek ve gerçek yanıt. Ücretsiz, kayıt yok.

Kimlik: tax.motor-vehicle.tr
Sürüm: 1.0.0
Erişim: Ücretsiz
Araç sayfası: MTV Hesaplama
Şema: GET /api/v1/tools/tax.motor-vehicle.tr

Girdiler

Alan	Tür	Sınırlar	Varsayılan	Açıklama
`year` (zorunlu)	integer	≥ 2.005, ≤ 2.100		Vergi yılı
`vehicle`	string	car \| motorcycle \| minibus \| panelVan \| bus \| truck	car	Taşıt türü
`motor`	string	combustion \| electric	combustion	Motor
`engine`	string	upTo1300 \| from1301to1600 \| from1601to1800 \| from1801to2000 \| from2001to2500 \| from2501to3000 \| from3001to3500 \| from3501to4000 \| over4000	from1301to1600	Motor silindir hacmi
`power`	number	> 0, ≤ 2.000		Elektrik motoru gücü (kW) · Ruhsattaki azami güç (kW).
`motorcycleEngine`	string	from100to250 \| from251to650 \| from651to1200 \| over1200	from100to250	Motor silindir hacmi
`panelVanEngine`	string	upTo1900 \| over1900	upTo1900	Motor silindir hacmi
`seats`	string	upTo25 \| from26to35 \| from36to45 \| over45	upTo25	Oturma yeri
`weight`	string	upTo1500 \| from1501to3500 \| from3501to5000 \| from5001to10000 \| from10001to20000 \| over20000	upTo1500	Azami toplam ağırlık
`modelYear` (zorunlu)	integer	≥ 1.900, ≤ 2.101		Model yılı · Ruhsattaki model yılı. Taşıt model yılında 1 yaşındadır.
`registration`	string	from2018 \| before2018	from2018	Türkiye’de ilk tescil
`registrationDate`	string			İlk tescil tarihi · Ruhsattaki ilk tescil tarihi. O yılın değer sınırları taşıtın satırını belirler; satır sonraki yıllarda değişmez.
`value`	number	> 0, ≤ 10.000.000.000		Taşıt değeri (KDV hariç) (TL) · İlk tescildeki satış bedeli: ÖTV dahil, KDV hariç. Faturada KDV matrahı olarak yazar.
`kaskoValue`	number	> 0, ≤ 10.000.000.000		Kasko değeri (TL) · Yılın Ocak ayı kasko değer listesindeki değer. Vergi bunun %5’ini aşarsa bir alt satır uygulanır; vergi dairesine başvuru gerekir.

Çıktılar

Alan	Tür	Açıklama
`tax`	number	Yıllık MTV (TL)
`installment`	number	Taksit (Ocak ve Temmuz) (TL)
`age`	number	Taşıtın yaşı
`row`	number	(I) sayılı tarife satırı
`firstYearTax`	number	Tescil yılında ödenecek MTV (TL)
`extraTax`	number	2023 ek MTV (bir defalık) (TL)

Örnek istek

curl -X POST https://hesaplayici.com/api/v1/tools/tax.motor-vehicle.tr/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"year":2026,"vehicle":"car","motor":"combustion","engine":"from1301to1600","motorcycleEngine":"from100to250","panelVanEngine":"upTo1900","seats":"upTo25","weight":"upTo1500","modelYear":2022,"registration":"from2018","registrationDate":"2022-05-10","value":650000},"locale":"tr"}'

Örnek yanıt

{
  "output": {
    "tax": 9012,
    "installment": 4506,
    "age": 5,
    "row": 6
  },
  "steps": [
    {
      "id": "age",
      "formula": "yaş = vergi yılı − model yılı + 1",
      "substitution": "yaş = 2026 − 2022 + 1",
      "value": 5
    },
    {
      "id": "row",
      "formula": "satır: taşıt değerinin 2022 değer sınırlarındaki yeri",
      "substitution": "1301–1600 cm³: taşıt değeri 650.000,00; 2022 değer sınırları 70.600,00 / 123.700,00 → satır 6",
      "value": 6
    },
    {
      "id": "tariff",
      "formula": "tarife tutarı: (I) sayılı tarife",
      "substitution": "satır 6, 4–6 yaş → 9.012,00",
      "value": 9012
    },
    {
      "id": "installment",
      "formula": "taksit = yıllık MTV / 2",
      "substitution": "taksit = 9.012,00 / 2",
      "value": 4506
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "dataVersion": "2026-01-01",
    "locale": "tr"
  },
  "citation": {
    "url": "https://hesaplayici.com/vergi/mtv-hesaplama",
    "title": "MTV Hesaplama"
  }
}