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

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

Sąlygos ir privatumas

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.