plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "mutalaa",
  "version": "0.1.1",
  "description": "Research Turkish law, tax legislation and case law through primary sources, including legislation, legislative rationales, Yarg\u0131tay, Dan\u0131\u015ftay, AYM and G\u0130B private tax rulings, with source links and citations.",
  "author": {
    "name": "Hasan Burak Ta\u015fy\u00fcrek",
    "email": "admin@hbglobal.dev",
    "url": "https://mutalaa.tr"
  },
  "homepage": "https://mutalaa.tr",
  "repository": "https://github.com/hburaktasyurek/mutalaa-plugin",
  "license": "MIT",
  "keywords": [
    "turkish-law",
    "legal-research",
    "public-law",
    "private-law",
    "legislation",
    "case-law",
    "legislative-rationales",
    "legal-interpretation",
    "academic-research",
    "regulatory-compliance",
    "mevzuat",
    "kanun",
    "i\u00e7tihat",
    "gerek\u00e7e",
    "emsal-karar",
    "yargitay",
    "danistay",
    "aym",
    "gib",
    "tax-law",
    "m\u00fctalaa",
    "mutalaa",
    "hukuk",
    "t\u00fcrk-hukuku",
    "vergi",
    "mali-mevzuat",
    "ictihat",
    "yarg\u0131tay",
    "dan\u0131\u015ftay",
    "\u00f6zelge"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "M\u00fctalaa: Hukuk, Vergi, \u0130\u00e7tihat",
        "shortDescription": "Turkish law, tax & case law",
        "longDescription": "M\u00fctalaa supports Turkish law (hukuk), tax and fiscal legislation (vergi ve mali mevzuat), and case law (i\u00e7tihat) research. Search legislation (mevzuat), legislative rationales, public court decisions including Yarg\u0131tay, Dan\u0131\u015ftay and Constitutional Court (AYM) decisions, and Turkish Revenue Administration (G\u0130B) private tax rulings (\u00f6zelge). Read and compare primary source texts, legal concepts, provisions, judicial reasoning and administrative interpretations with source links and citations.\n\nUse it to study a legal subject, map the rules governing an activity or relationship, examine how a provision is interpreted and applied, or investigate a specific document. It supports professional and academic research, legal education, and source research for legal opinions, pleadings, contracts, regulatory compliance assessments and organizational decisions. Research can address substantive and procedural rules, requirements and exceptions, powers and jurisdiction, rights and obligations, liability, sanctions and remedies.\n\nResearch spans civil and commercial law, companies, enforcement and insolvency, employment and social security, consumer protection, property, family and inheritance, criminal law, public administration, taxation, constitutional law and other Turkish legal subjects represented in the available sources.\n\nSearch legislation by topic, title, number or Official Gazette details. Sources include laws, decree-laws, presidential decrees, regulations, communiqu\u00e9s and available repealed instruments. Read full texts or specific articles, inspect chapter and article structures, search within legislation, and retrieve general or article-level legislative rationales where available. Distinguish legislative rationales from enacted provisions.\n\nFind public court decisions by legal issue and, where supported, court or chamber, date, and case or decision number. Sources include Yarg\u0131tay civil and criminal chambers, Dan\u0131\u015ftay, regional appellate civil courts, first-instance civil courts, the kanun yarar\u0131na bozma collection and Constitutional Court (AYM) constitutional review and individual applications. Read and compare the facts, reasoning and outcomes of decisions alongside the relevant legislation. Research G\u0130B private rulings as administrative tax interpretations tied to their facts and period.\n\nConnect a M\u00fctalaa account and keep research inputs anonymous. M\u00fctalaa provides legal information and source research; legal representation, submitting applications and access to private UYAP files are outside its scope. Foreign-law-only research and searches of regional criminal appellate or regional administrative courts are outside this release. Coverage depends on the available sources; exhaustive coverage, historical versions and instant updates are not guaranteed.",
        "developerName": "Hasan Burak Ta\u015fy\u00fcrek",
        "category": "Education & Research",
        "capabilities": [
          "Research legislation, articles and rationales",
          "Find and compare Turkish court decisions",
          "Research G\u0130B private tax rulings"
        ],
        "defaultPrompt": [
          "Find the current wording of article 347 of the Turkish Code of Obligations.",
          "Find and read a Turkish court decision about rent adjustment.",
          "Find a G\u0130B private ruling about VAT on rental income."
        ],
        "websiteURL": "https://mutalaa.tr",
        "supportURL": "https://mutalaa.tr/legal",
        "privacyPolicyURL": "https://mutalaa.tr/legal",
        "termsOfServiceURL": "https://mutalaa.tr/legal",
        "logo": "./assets/mutalaa-icon.png",
        "composerIcon": "./assets/mutalaa-icon.png"
      },
      "onboardingSkill": "./skills/mutalaa-baslangic/SKILL.md",
      "review": {
        "demo_recording_url": "https://drive.google.com/file/d/1v7M2HnER_Rt7dEKG8bqfBmjhzLVpUD07/view?usp=drivesdk",
        "commerce": false,
        "commerce_description": "No purchases, subscription sales, checkout or upgrade prompts are provided by this release.",
        "test_cases": {
          "positive": [
            {
              "description": "Retrieve a specified article from the correct Turkish statute using returned source identifiers. Start in a new chat with the four bundled skills and a connected test account.",
              "prompt": "6098 say\u0131l\u0131 T\u00fcrk Bor\u00e7lar Kanunu'nun 347. maddesinin g\u00fcncel metnini ve kaynak ba\u011flant\u0131s\u0131n\u0131 getir.",
              "tools_triggered": "mevzuat_ara, mevzuat_maddesi_getir",
              "expected_behavior": "Search with numara=6098 and the KANUN type; verify the returned title and number. Pass the returned identifier as mevzuat_kimligi and request madde=347. Read any relevant continuation pages. Quote or summarize only the retrieved text with its statute, article and source URL. Do not claim historical-version coverage or invent an identifier. A source/auth/quota failure must be reported and does not count as a successful run."
            },
            {
              "description": "Find and read a public Yarg\u0131tay decision without broadening a narrow document request to unrelated courts.",
              "prompt": "Kira bedelinin uyarlanmas\u0131 hakk\u0131nda bir Yarg\u0131tay karar\u0131 bul; olay\u0131n\u0131, gerek\u00e7esini ve sonucunu kaynakla \u00f6zetle.",
              "tools_triggered": "yargitay_karari_ara, belge_getir",
              "expected_behavior": "Use a short anonymous query about kira bedelinin uyarlanmas\u0131. Select a relevant Yarg\u0131tay result, pass its unchanged id as belge_kimligi and read the relevant reasoning and disposition, including continuation pages when necessary. Report only metadata actually returned and distinguish the facts, reasoning and outcome. Link the public source; a search snippet alone is insufficient."
            },
            {
              "description": "Research the requested administrative court and preserve its identity in the answer.",
              "prompt": "\u0130dari i\u015flemlerde hukuki g\u00fcvenlik ilkesi hakk\u0131nda bir Dan\u0131\u015ftay karar\u0131 bul ve ilgili gerek\u00e7eyi kaynakla a\u00e7\u0131kla.",
              "tools_triggered": "danistay_karari_ara, belge_getir",
              "expected_behavior": "Search Dan\u0131\u015ftay with anonymous legal concepts about hukuki g\u00fcvenlik. Read a relevant returned decision using its id, including relevant continuation pages. Explain the supported reasoning and cite the source with available court/date/reference metadata. Do not substitute a regional administrative court or treat an incidental reference as a separate decision."
            },
            {
              "description": "Find a G\u0130B private ruling and distinguish an administrative view from a court decision.",
              "prompt": "\u0130\u015fyeri kiralama i\u015flemlerinde KDV tevkifat\u0131 hakk\u0131nda bir G\u0130B \u00f6zelgesi bul ve metnindeki g\u00f6r\u00fc\u015f\u00fc kaynakla a\u00e7\u0131kla.",
              "tools_triggered": "gib_ozelge_ara, belge_getir",
              "expected_behavior": "Search with a short query about i\u015fyeri kiralama KDV tevkifat\u0131, inspect a relevant result and read its text with the returned id. Give the available institution, date, ruling number and public source URL. Identify it as a G\u0130B private ruling whose facts and tax period matter, not a universally binding court judgment."
            },
            {
              "description": "Activate the general research workflow for a colloquial Turkish legal question, then use legislation and relevant case law.",
              "prompt": "T\u00fcrkiye'de bir ma\u011fazadan ald\u0131\u011f\u0131m ay\u0131pl\u0131 \u00fcr\u00fcn i\u00e7in hangi se\u00e7imlik haklar\u0131m var? Mevzuatla a\u00e7\u0131kla ve ilgili bir karar g\u00f6ster.",
              "tools_triggered": "mevzuat_ara, mevzuat_maddesi_getir, yargitay_karari_ara, belge_getir",
              "expected_behavior": "Load the general research skill and its legislation/case-law flows from the bundle. Verify the relevant consumer statute, read the applicable article text, then find and read a relevant Yarg\u0131tay decision. Explain general rights supported by those texts and their limits with source links. Ask one outcome-changing question if needed; do not assume missing facts or send identifying information. A clarification alone does not demonstrate completion of the full positive workflow."
            }
          ],
          "negative": [
            {
              "description": "Foreign-law-only request. No M\u00fctalaa research tools should run. Explain the Turkish-law scope and avoid presenting Turkish sources as New York law.",
              "prompt": "Yaln\u0131z New York eyalet hukukuna g\u00f6re kira s\u00f6zle\u015fmemdeki fesih haklar\u0131n\u0131 ara\u015ft\u0131r; T\u00fcrk hukukunu kullanma."
            },
            {
              "description": "Technical support without a legal question. No M\u00fctalaa research tools should run; ordinary technical assistance can continue outside this plugin.",
              "prompt": "Python kodumdaki ModuleNotFoundError hatas\u0131n\u0131 nas\u0131l d\u00fczeltebilirim?"
            },
            {
              "description": "Private case-file access is unsupported. No M\u00fctalaa research tools should run, no UYAP login details should be requested and no private file access should be claimed. Offer anonymous public-source research only as a separate next step.",
              "prompt": "UYAP hesab\u0131ma girip bana ait \u00f6zel dava dosyas\u0131ndaki dilek\u00e7eleri ve duru\u015fma tutanaklar\u0131n\u0131 indir."
            }
          ]
        }
      },
      "publication": {
        "countries": [],
        "release_notes": "Listing metadata update only. Updated the display name to M\u00fctalaa: Hukuk, Vergi, \u0130\u00e7tihat; revised the English subtitle and opening description; added relevant Turkish discovery terms and brand spellings; and aligned the Turkish listing translation. The bundled skills, references, MCP endpoint and connection configuration are byte-for-byte unchanged from the original 0.1.0 submission ZIP. This package introduces no tool or authentication changes.",
        "translations": {
          "tr-TR": {
            "subtitle": "Hukuk, mali mevzuat ve i\u00e7tihat",
            "description": "M\u00fctalaa ile T\u00fcrk hukukunu, vergi ve mali mevzuat\u0131, i\u00e7tihatlar\u0131, yasama gerek\u00e7elerini ve G\u0130B \u00f6zelgelerini ara\u015ft\u0131r\u0131n. Mevzuat\u0131, Yarg\u0131tay ve Dan\u0131\u015ftay i\u00e7tihatlar\u0131n\u0131, AYM kararlar\u0131n\u0131 ve di\u011fer desteklenen kaynaklardaki yay\u0131mlanm\u0131\u015f kararlar\u0131 bulun. Birincil kaynaklar\u0131 okuyun; hukuki kavram ve kurumlar\u0131 inceleyin; h\u00fck\u00fcmleri, yarg\u0131sal gerek\u00e7eleri ve idari yorumlar\u0131 kaynak metinleri ve ba\u011flant\u0131lar\u0131yla kar\u015f\u0131la\u015ft\u0131r\u0131n.\n\nBir hukuk konusunu \u00f6\u011frenmek, bir faaliyet veya ili\u015fkiye uygulanan d\u00fczenlemeleri belirlemek, bir h\u00fckm\u00fcn yorumunu ve uygulanmas\u0131n\u0131 incelemek ya da belirli bir belgeyi ara\u015ft\u0131rmak i\u00e7in kullan\u0131l\u0131r. Mesleki ve akademik ara\u015ft\u0131rmay\u0131, hukuk e\u011fitimini, hukuki m\u00fctalaa, dilek\u00e7e ve s\u00f6zle\u015fme haz\u0131rl\u0131\u011f\u0131na y\u00f6nelik kaynak incelemesini, mevzuata uyum de\u011ferlendirmelerini ve kurumsal kararlar\u0131n hukuki dayanaklar\u0131n\u0131n ara\u015ft\u0131r\u0131lmas\u0131n\u0131 destekler. Maddi hukuk ve usul kurallar\u0131, ko\u015fullar ve istisnalar, g\u00f6rev ve yetki, hak ve y\u00fck\u00fcml\u00fcl\u00fckler, sorumluluk, yapt\u0131r\u0131mlar ve ba\u015fvuru yollar\u0131 ara\u015ft\u0131r\u0131labilir.\n\nMedeni hukuk, bor\u00e7lar ve ticaret hukuku, \u015firketler, icra ve iflas, i\u015f ve sosyal g\u00fcvenlik, t\u00fcketici, e\u015fya, aile ve miras, ceza, idare, vergi ve anayasa hukuku ile mevcut kaynaklarda yer alan di\u011fer T\u00fcrk hukuku konular\u0131n\u0131 kapsar.\n\nMevzuat\u0131 konu, ba\u015fl\u0131k, numara veya Resm\u00ee Gazete bilgileriyle bulun. Kanunlar, kanun h\u00fckm\u00fcnde kararnameler, Cumhurba\u015fkanl\u0131\u011f\u0131 kararnameleri, y\u00f6netmelikler, tebli\u011fler ve kaynakta sunulan m\u00fclga d\u00fczenlemeler \u00fczerinde \u00e7al\u0131\u015f\u0131n. Tam metinleri veya belirli maddeleri okuyun; b\u00f6l\u00fcm ve madde yap\u0131s\u0131n\u0131 inceleyin; metin i\u00e7inde aray\u0131n; kaynakta varsa genel gerek\u00e7e ve madde gerek\u00e7elerine ula\u015f\u0131n. Yasama gerek\u00e7eleri ile y\u00fcr\u00fcrl\u00fc\u011fe giren h\u00fck\u00fcmlerin niteli\u011fini ayr\u0131 de\u011ferlendirin.\n\nYay\u0131mlanm\u0131\u015f kararlar\u0131 hukuki konuya ve desteklenen kaynaklarda mahkeme veya daire, tarih, esas ya da karar numaras\u0131na g\u00f6re bulun. Yarg\u0131tay hukuk ve ceza daireleri, Dan\u0131\u015ftay, hukuk istinaf\u0131, ilk derece hukuk, kanun yarar\u0131na bozma koleksiyonu ve AYM norm denetimi ile bireysel ba\u015fvuru kaynaklar\u0131 desteklenir. Kararlar\u0131n olay\u0131n\u0131, gerek\u00e7esini ve sonucunu ilgili mevzuatla birlikte okuyup kar\u015f\u0131la\u015ft\u0131r\u0131n. G\u0130B \u00f6zelgelerini, olaya ve d\u00f6neme ba\u011fl\u0131 idari vergi yorumlar\u0131 olarak ara\u015ft\u0131r\u0131n.\n\nM\u00fctalaa hesab\u0131n\u0131zla ba\u011flan\u0131n ve ara\u015ft\u0131rma girdilerini anonim tutun. M\u00fctalaa hukuki bilgi ve kaynak ara\u015ft\u0131rmas\u0131 sunar; avukatl\u0131k hizmeti, ba\u015fvuru yapma ve \u00f6zel UYAP dosyalar\u0131na eri\u015fim kapsam d\u0131\u015f\u0131ndad\u0131r. Yaln\u0131z yabanc\u0131 hukuk ara\u015ft\u0131rmas\u0131, ceza istinaf\u0131 ve b\u00f6lge idare karar aramas\u0131 bu s\u00fcr\u00fcmde desteklenmez. Kapsam eri\u015filebilen kaynaklara ba\u011fl\u0131d\u0131r; eksiksiz kapsam, ge\u00e7mi\u015f s\u00fcr\u00fcmler ve an\u0131nda g\u00fcncelleme garantisi sunulmaz."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}