⚡Model Context Protocol (MCP) Serveris

Prijunkite AI asistentus prie Lietuvos adresų registro

Sujunkite Cursor, Claude Desktop, Google Antigravity ar kitus AI agentus su oficialia Lietuvos pašto kodų ir adresų baze realiu laiku per saugų nuotolinį protokolą.

Nuotolinis SSE srautasAtvira prieiga (be API raktų)800 000+ pastatų ir pašto kodųTik nuotolinis (Remote-Only)

🚀 Greitasis prijungimas prie AI klientų

Pasirinkite savo AI asistentą ir įklijuokite paruoštą konfigūraciją.

Atidarykite Cursor nustatymus (Settings → Features → MCP) arba sukurkite failą .cursor/mcp.json savo projekto šakniniame kataloge ir įklijuokite žemiau esančią konfigūraciją:
.cursor/mcp.json arba Cursor Settings → Features → MCP
{
  "mcpServers": {
    "adresuok-lt": {
      "url": "https://adresuok.lt/api/mcp"
    }
  }
}

⚙️ Techninės specifikacijos ir protokolas

Nuotolinio serverio parametrai, saugumas ir palaikomi transportai.

Prieigos taškas (Endpoint)
https://adresuok.lt/api/mcp

Palaiko Server-Sent Events (SSE) srautą (GET) ir JSON-RPC 2.0 žinučių siuntimą (POST).

Autentifikacija (Security)
Vieša / Nereikia API raktų

Serveris prieinamas be autorizacijos žetonų ar išankstinės registracijos.

Užklausų limitas (Rate Limiting)
60 užklausų / minutę vienam IP

Viršijus limitą grąžinamas HTTP 429 statusas su Retry-After antrašte.

Architektūra
Griežtai nuotolinis (Remote-Only)

Nereikalauja duomenų bazės atsisiuntimo; visi atsakymai generuojami realiu laiku iš VĮ Registrų centro indekso.

🛠️ Teikiami MCP įrankiai (Tools)

Visi 6 įrankiai, kuriuos jūsų AI asistentas gali išsikviesti automatiškai.

search_addressAdresų paieška laisvu tekstu

Ieško Lietuvos adresų pagal laisvą tekstą, gatvę, namo numerį ar gyvenvietę. Grąžina iki N geriausiai atitinkančių adresų su pašto kodais ir reitingo balais.

Įvesties parametrai (Input Arguments):
ParametrasTipasPrivalomasAprašymas
querystringTaipPaieškos frazė (pvz., "Gedimino pr. 9", "Savanorių Kaunas")
limitnumberNeMaksimalus rezultatų skaičius (numatytasis: 10, maks: 50)
city_filterstringNePapildomas filtras pagal miestą ar savivaldybę
Pavyzdinė užklausa modeliui: „Rask adresą Gedimino pr. 9 Vilniuje ir pateik jo pašto kodą.“
lookup_postal_codePaieška pagal 5 skaitmenų pašto kodą
validate_and_normalize_addressAdreso validavimas ir VLKK normalizavimas
get_address_detailsPilna hierarchinė adreso informacija
list_administrative_divisionsAdministracinių vienetų sąrašas
format_postal_labelSiuntos etiketės formavimas (VLKK)

📚 Teikiami MCP resursai ir šablonai

Papildomi duomenų šaltiniai ir paruošti nurodymai AI asistentams.

📁MCP Resursai (Resources)

  • address://stats

    Lietuvos adresų registro statistika ir indekso būsena.

  • address://counties

    Visų 10 Lietuvos apskričių sąrašas su kodais.

  • address://municipalities

    Visų 60 Lietuvos savivaldybių sąrašas.

  • address://building/{code}

    Konkretaus pastato duomenys pagal unikalų AOB kodą.

  • address://postal-code/{code}

    Visi pastatai ir gatvės pagal 5 skaitmenų pašto kodą.

💬MCP Šablonai (Prompts)

  • verify-customer-address

    Išanalizuoja kliento laisvo teksto žinutę, ištraukia adreso elementus, patikrina registrą ir pasiūlo oficialų patikslintą adresą bei taisyklingą pašto kodą.

  • format-courier-dispatch

    Paruošia standartizuotą siuntos gavėjo duomenų rinkinį Lietuvos Pašto, LP Express, Omniva ar DPD kurjerių sistemoms pagal VLKK taisykles.

❓ Dažniausiai užduodami klausimai (MCP DUK)

Atsakymai į klausimus apie serverio veikimą, saugumą ir pajungimą.

Kas yra Model Context Protocol (MCP)?
Model Context Protocol (MCP) – tai atviras standartas, leidžiantis dirbtinio intelekto modeliams (LLM) ir agentams saugiai pasiekti išorinius duomenų šaltinius ir įrankius tiesiogiai pokalbio metu be papildomo programavimo.
Kodėl paslauga teikiama tik nuotoliniu (Remote-Only) režimu?
Lietuvos adresų registras susideda iš daugiau nei 800 000 pastatų įrašų ir nuolat atnaujinamas. Nuotolinis MCP serveris užtikrina, kad jūsų AI agentai visada dirbtų su naujausiais valstybinio registro duomenimis ir nereikalautų didelių vietinių SQLite duomenų bazių atsisiuntimo.
Ar reikalingas API prieigos raktas (Bearer Token)?
Ne, Adresuok.lt MCP serveris yra viešas ir atviras. Prisijungimui nereikia jokių autorizacijos žetonų, API raktų ar išankstinės registracijos – pakanka nurodyti nuotolinį serverio URL savo AI įrankyje.
Kokie taikomi užklausų limitai (Rate Limiting)?
Numatytasis limitas yra 60 užklausų per minutę vienam IP adresui. Viršijus limitą, serveris grąžina HTTP 429 statusą su „Retry-After“ antrašte, nurodančia, po kelių sekundžių galima pakartoti užklausą.