API ir MCP dokumentacija
Bazinis adresas: https://apibase.lt/api/vardai/v1/. Atsakymai – JSON (UTF-8). Raktas siunčiamas antraštėje X-Api-Key: vl_… (arba Authorization: Bearer vl_…). Nemokamą raktą su 500 užklausų gausite čia. OpenAPI aprašas: openapi.json.
Linksniai: GET /linksniai
Parametrai: vardas, pavarde (nebūtina), lytis = v | m (nebūtina – nustatoma pagal vardą ir pavardę). Arba viena eilutė pilnas=Jonas Petraitis (paskutinis žodis – pavardė). 1 užklausa.
curl -H "X-Api-Key: vl_…" "https://apibase.lt/api/vardai/v1/linksniai?vardas=Kęstutis&pavarde=Petraitis"
{"vardas":"Kęstutis","pavarde":"Petraitis","lytis":"v","lytis_nustatyta":"vardas",
"linksniai":{
"vardininkas":{"vardas":"Kęstutis","pavarde":"Petraitis","pilnas":"Kęstutis Petraitis"},
"kilmininkas":{"vardas":"Kęstučio","pavarde":"Petraičio","pilnas":"Kęstučio Petraičio"},
"naudininkas":{… "pilnas":"Kęstučiui Petraičiui"},
"galininkas":{… "pilnas":"Kęstutį Petraitį"},
"inagininkas":{… "pilnas":"Kęstučiu Petraičiu"},
"vietininkas":{… "pilnas":"Kęstutyje Petraityje"},
"sauksmininkas":{… "pilnas":"Kęstuti Petraiti"}},
"kreipinys":{"vardu":"Kęstuti","pilnas":"Kęstuti Petraiti",
"oficialus":"Gerbiamas pone Petraiti","laba_diena":"Laba diena, Kęstuti"},
"dalys":[…],"pastabos":[],"likutis":499}
Kreipinys: GET /kreipinys
Tie patys parametrai, atsakyme – tik kreipinys ir pastabos. 1 užklausa.
curl -H "X-Api-Key: vl_…" "https://apibase.lt/api/vardai/v1/kreipinys?vardas=Eglė&pavarde=Kazlauskienė"
{"vardas":"Eglė","pavarde":"Kazlauskienė","lytis":"m",
"kreipinys":{"vardu":"Egle","pilnas":"Egle Kazlauskiene","oficialus":"Gerbiamoji ponia Kazlauskiene","laba_diena":"Laba diena, Egle"},"pastabos":[]}
Masinis linksniavimas: POST /masinis
Iki 500 vardų vienu kartu, 1 užklausa už kiekvieną vardą. Reikia rakto.
curl -X POST -H "X-Api-Key: vl_…" -H "Content-Type: application/json" \
-d '{"vardai":[{"vardas":"Jonas","pavarde":"Kazlauskas"},"Rūta Petraitytė",{"vardas":"Kim","lytis":"m"}]}' \
https://apibase.lt/api/vardai/v1/masinis
{"rezultatai":[{…},{…},{…}],"likutis":497}
Kreipinių patikra tekste: POST /tikrinti
Randa kreipinius („Laba diena, Jonas“, „Gerbiamas Ona …“, „Sveiki, Eglė“) ir tikrina vardo linksnį bei žodžio giminę. 1 užklausa už tekstą (iki 20 000 simbolių).
curl -X POST -H "X-Api-Key: vl_…" -H "Content-Type: application/json" \
-d '{"tekstas":"Gerbiamas Ona Petraitienė,\nsiunčiame sąskaitą."}' https://apibase.lt/api/vardai/v1/tikrinti
{"klaidos":[{"rasta":"Gerbiamas Ona Petraitienė","pataisyta":"Gerbiamoji Ona Petraitiene",
"paaiskinimas":"Moteriai — „Gerbiamoji“; vardas kreipinyje rašomas šauksmininku: …","lytis":"m"}],
"pataisytas":"Gerbiamoji Ona Petraitiene,\nsiunčiame sąskaitą.","rasta_kreipiniu":1}
Likutis: GET /raktas
Grąžina likutis, sunaudota, nupirkta ir pirkti – mokėjimo nuorodą šiam raktui. Kiekviename apmokamame atsakyme yra antraštė X-Likutis.
Klaidos ir limitai
400– blogi parametrai,401– blogas raktas,402– baigėsi likutis (atsakymepirkti),429– per daug užklausų.- Be rakto – 20 užklausų per dieną iš vieno IP (bandymui). Su raktu – iki 20 000 užklausų per valandą.
- Klaidos formatas:
{"klaida":"baigesi_likutis","pranesimas":"…"}.
MCP serveris
Adresas: https://apibase.lt/api/vardai/mcp (Streamable HTTP, be sesijos). Įrankiai: kreipinys, linksniuoti_varda, tikrinti_kreipinius. Raktas – Authorization: Bearer vl_…; be rakto – 20 iškvietimų per dieną.
// Claude Desktop, Cursor ir kt. (mcp.json)
{"mcpServers":{"lietuviski-vardai":{"type":"http","url":"https://apibase.lt/api/vardai/mcp",
"headers":{"Authorization":"Bearer vl_…"}}}}
# Claude Code
claude mcp add --transport http lietuviski-vardai https://apibase.lt/api/vardai/mcp --header "Authorization: Bearer vl_…"
Kaip linksniuojame ir šaltiniai
- Vardų ir pavardžių su -as šauksmininkas – -ai (Jonai, Kazlauskai), ne -e: VLKK konsultacija „Kreipiniai (pavardės)“, VLKK „Asmenvardžiai“.
- -is → -i (Kęstuti), -ys → -y (Stasy), -us → -au (Butkau), -ius → -iau (Pauliau) – tie patys VLKK šaltiniai. Kilmininke, naudininke ir įnagininke t → č, d → dž (Kęstučio, Gaidžio).
- Moters pavardė vyriška forma (Rasa Sutkus) nelinksniuojama: VLKK konsultacija.
- Užsienio vardai: VLKK rekomendacija dėl autentiškų asmenvardžių gramatinimo (nelinksniuojami, pvz., vardai su kirčiuota balse gale – Hugo).
- Linksnių lentelės: Vikižodynas ir Wiktionary (šauksmininkas – pagal VLKK, nes Vikižodyne kai kur nurodyta -e), Lithuanian declension.
- Testai: 190 pilnų linksnių lentelių ir dar 150 vardų, pavardžių, lyties ir tekstų atvejų. Mažiau tikri atvejai: vardai su -jas (Tobijas → Tobijau, pagal bendrinius žodžius: vėjas → vėjau) ir vyriškos pavardės su -ė (Gervė → Gerve).
Sąlygos ir privatumas
- Paslaugą teikia MB „Web studija“, įmonės kodas 306455709, Alaušo g. 1C, Vilnius, info@saitai.lt.
- Įvesti vardai ir tekstai apdorojami atsakymui ir neišsaugomi. Skaičiuojame tik užklausų kiekį. IP adresas saugomas tik kaip neatkuriama santrauka (limitams ir unikalių lankytojų skaičiui per savaitę).
- Rakto kūrimo metu saugome el. paštą – tik su raktu susijusiems pranešimams. Ištrinti galite parašę info@saitai.lt.
- Paketas – 20 € už 10 000 užklausų, užklausos nesibaigia. Mokėjimą tvarko Stripe, kortelės duomenų negauname. Nepanaudotą paketą per 14 dienų nuo pirkimo grąžiname, jei sunaudota mažiau nei 10 % užklausų.
- Linksniai generuojami pagal taisykles. Retais atvejais (reti ar užsienio vardai, neįprastos pavardės) rezultatas gali būti netikslus – svarbiuose dokumentuose patikrinkite. Pastebėję klaidą parašykite – ištaisysime.
In English
REST API and MCP server that declines Lithuanian first names and surnames into all 7 cases and returns the vocative for e-mail greetings (Jonas → “Laba diena, Jonai”, Kazlauskienė → “Gerbiamoji ponia Kazlauskiene”). Also checks greetings in Lithuanian text. Base URL https://apibase.lt/api/vardai/v1/, key in X-Api-Key. Free key: 500 requests; then €20 per 10,000 requests (no expiry). MCP: https://apibase.lt/api/vardai/mcp, tools kreipinys, linksniuoti_varda, tikrinti_kreipinius; 20 free calls/day without a key.