# La Ei - Complete AI/LLM Integration Documentation
# Romania's Leading Classified Ads Platform
# Generated: 2026-02-04T22:35:49+02:00
# Version: Full Documentation v1.0

================================================================================

## PLATFORM OVERVIEW

La Ei (https://laei.ro) is Romania's premier classified ads platform, serving
millions of users across the country. The platform facilitates buying, selling,
and exchanging goods and services in a secure, user-friendly environment.

### Key Statistics:
- Active Listings: 900,000+
- Registered Users: 2,000,000+
- Daily Visitors: 150,000+
- Categories: 14
- Cities Covered: 785
- Business Listings: 30,000+

================================================================================
## MODEL CONTEXT PROTOCOL (MCP) SERVER
================================================================================

### Connection Details:
- Endpoint: https://laei.ro/mcp
- Protocol: JSON-RPC 2.0
- Transport: HTTP/HTTPS (streamable)
- Authentication: API Key (Bearer token or URL parameter)
- Rate Limit: 100 requests/minute per IP
- Timeout: 30 seconds per request

### AVAILABLE MCP TOOLS - DETAILED DOCUMENTATION

#### 1. cauta-anunturi (Search Classified Ads)
Purpose: Search and filter classified ads with advanced criteria
Parameters:
  - query (string, optional): Search keywords
  - category_id (integer, optional): Category filter
  - city_id (integer, optional): Location filter
  - price_min (number, optional): Minimum price
  - price_max (number, optional): Maximum price
  - limit (integer, optional): Results limit (1-50, default: 10)
  - sort (string, optional): Sort order (recent/price_asc/price_desc/title)
Returns: Array of ads with title, description, price, location, URL

#### 2. detalii-anunt (Get Ad Details)
Purpose: Retrieve complete information about a specific ad
Parameters:
  - id (integer, required): Ad ID
Returns: Full ad details including images, contact info, custom fields

#### 3. obtine-categorii (Get Categories)
Purpose: Explore category hierarchy and structure
Parameters:
  - parent_id (integer, optional): Parent category ID
  - level (integer, optional): Depth level (1-5)
  - include_count (boolean, optional): Include ad counts
Returns: Category tree with IDs, names, and statistics

#### 4. obtine-locatii (Get Locations)
Purpose: Access geographic location data
Parameters:
  - type (string, required): countries/states/cities
  - country_code (string, optional): Country code (e.g., RO)
  - state_code (string, optional): State/county code
  - limit (integer, optional): Results limit (1-100)
  - include_count (boolean, optional): Include ad counts
Returns: Location data with hierarchical relationships

#### 5. statistici-anunturi (Get Statistics)
Purpose: Analyze trends and statistics
Parameters:
  - period (string, optional): today/week/month/year/all
  - category_id (integer, optional): Category filter
  - city_id (integer, optional): Location filter
  - include_trends (boolean, optional): Include trend analysis
  - include_price_stats (boolean, optional): Include pricing data
Returns: Statistical data, trends, and insights

#### 6. explorare-orase (Explore Cities)
Purpose: Comprehensive Romanian cities database exploration
Parameters:
  - action (string, required): overview/counties/top_cities/county_cities/city_details/search/geographic
  - county_code (string, optional): County code
  - city_id (integer, optional): City ID
  - search_term (string, optional): Search query
  - limit (integer, optional): Results limit
  - population_min (integer, optional): Minimum population
  - include_coordinates (boolean, optional): Include GPS coordinates
Returns: Detailed city and county information

================================================================================
## COMPLETE CATEGORY HIERARCHY WITH DESCRIPTIONS
================================================================================

### 135: Altele

### 46: Animale și Animale de Companie
Subcategories:
  - 51: Accesorii pentru Animale
  - 53: Alte Animale
  - 49: Câini
  - 50: Pești
  - 48: Pisici și Pui de Pisică
  - 47: Păsări
  - 52: Reptile

### 1: Automobile
Subcategories:
  - 8: Ambarcațiuni și Bărci
  - 3: Autobuze și Microbuze
  - 6: Camioane și Remorci
  - 4: Echipamente Grele
  - 2: Mașini
  - 5: Motociclete și Scutere
  - 7: Piese și Accesorii Auto

### 14: Electronică
Subcategories:
  - 19: Accesorii Calculator
  - 15: Accesorii și Consumabile pentru Electronică
  - 24: Camere Foto și Video
  - 29: Console de Jocuri
  - 22: Căști
  - 18: Echipamente Audio și Muzică
  - 17: Echipamente TV și DVD
  - 20: Hardware Calculator
  - 25: Imprimante și Scanere
  - 28: Jocuri Video
  - 16: Laptopuri și Calculatoare
  - 21: Monitoare Calculator
  - 23: Produse de Rețea
  - 26: Securitate și Supraveghere
  - 27: Software

### 122: Evenimente Locale
Subcategories:
  - 128: Ceremonii
  - 123: Concerte și Festivaluri
  - 129: Conferințe
  - 132: Evenimente de Familie
  - 127: Formare și Seminarii
  - 124: Networking și Întâlniri
  - 130: Nunți
  - 125: Sport și Activități în Aer Liber
  - 134: Toate Celelalte Evenimente
  - 126: Târguri și Convenții
  - 133: Viața de Noapte
  - 131: Zile de Naștere

### 62: Frumusețe și Bunăstare
Subcategories:
  - 69: Accesorii Tutun
  - 63: Baie și Corp
  - 65: Frumusețe Păr
  - 66: Machiaj
  - 72: Masaj Profesional
  - 64: Parfumuri
  - 70: Unelte și Accesorii
  - 71: Vitamine și Suplimente
  - 67: Wellness Sexual
  - 68: Îngrijire Piele

### 73: Locuri de Muncă
Subcategories:
  - 74: Agricultură - Mediu
  - 96: Alte Oferte de Muncă
  - 75: Asistență - Secretariat - Helpdesk
  - 76: Auto - Mecanic
  - 77: BTP - Construcții - Clădiri
  - 89: Babysitting - Muncă de Bonă
  - 86: Calculatoare - Internet - Telecomunicații
  - 79: Comercial - Locuri de Muncă în Vânzări
  - 78: Comerț - Servicii de Afaceri
  - 81: Conducere - Manager
  - 80: Contabilitate - Management - Finanțe
  - 82: Estetică - Păr - Frumusețe
  - 90: HR - Formare - Educație
  - 85: Independent - Freelance - Telemuncă
  - 87: Industrie, Producție și Inginerie
  - 84: Locuri de Muncă în Imobiliare
  - 83: Locuri de Muncă în Serviciul Public
  - 88: Marketing - Comunicare
  - 91: Medical - Sănătate - Social
  - 92: Securitate - Pază
  - 93: Servicii Casnice - Menaj
  - 95: Transport - Logistică
  - 94: Turism - Hoteluri - Restaurante - Petrecere

### 30: Mobilier și Electrocasnice
Subcategories:
  - 32: Antichități - Artă - Decorațiuni
  - 33: Electrocasnice
  - 34: Grădină
  - 35: Jucării - Jocuri - Figurine
  - 31: Mobilier - Vesela
  - 36: Vin și Gourmet - Rețete

### 54: Modă
Subcategories:
  - 57: Accesorii Vestimentare
  - 58: Bijuterii
  - 60: Ceasuri
  - 55: Genți
  - 61: Rochii de Mireasă și Accesorii
  - 56: Îmbrăcăminte
  - 59: Încălțăminte

### 136: Pagini Web

### 37: Proprietăți Imobiliare
Subcategories:
  - 39: Case și Apartamente de Vânzare
  - 38: Case și Apartamente de Închiriat
  - 44: Centre de Evenimente, Locații și Spații de Lucru
  - 43: Proprietăți Comerciale de Vânzare
  - 42: Proprietăți Comerciale de Închiriat
  - 41: Terenuri de Vânzare
  - 40: Terenuri de Închiriat
  - 45: Închiriere pe Termen Scurt

### 97: Servicii
Subcategories:
  - 113: Alte Servicii
  - 99: Carpooling
  - 98: Casting, Model, Fotograf
  - 112: Construcții - Renovări - Tâmplărie
  - 101: Destocking - Comercial
  - 102: Echipamente Industriale
  - 103: Estetică, Coafură
  - 104: Materiale și Echipamente Profesionale
  - 108: Meșteșugar, Depanare, Handyman
  - 100: Mutări, Depozitare Mobilier
  - 106: Prestări Servicii
  - 109: Servicii Informatice
  - 105: Servicii Organizare Evenimente
  - 110: Servicii Turism și Călătorii
  - 107: Sănătate, Frumusețe
  - 111: Traduceri, Redactare

### 9: Telefoane și Tablete
Subcategories:
  - 11: Accesorii pentru Telefoane Mobile și Tablete
  - 12: Ceasuri Inteligente și Trackere
  - 13: Tablete
  - 10: Telefoane Mobile

### 114: Învățare
Subcategories:
  - 116: Cursuri de Calculator
  - 115: Cursuri de Limbi Străine
  - 118: Formare Profesională
  - 119: Matematică, Fizică, Chimie
  - 117: Meditații, Lecții Private
  - 120: Muzică, Teatru, Dans
  - 121: Suport Școlar

================================================================================
## ROMANIAN CITIES BY COUNTY (JUDEȚ)
================================================================================

### {"en":"Alba"} (Code: RO.01)
Top Cities:
  - 765: Alba Iulia (Pop: 66,085)
  - 766: Aiud (Pop: 28,341)
  - 179: Sebeş (Pop: 27,246)
  - 561: Cugir (Pop: 24,734)
  - 694: Blaj (Pop: 20,371)
  - 315: Ocna Mureş (Pop: 15,316)
  - 3: Zlatna (Pop: 8,393)
  - 617: Câmpeni (Pop: 7,932)
  - 114: Teiuş (Pop: 7,112)
  - 428: Ighiu (Pop: 6,294)

### {"en":"Arad"} (Code: RO.02)
Top Cities:
  - 753: Arad (Pop: 169,065)
  - 214: Pecica (Pop: 12,804)
  - 156: Sântana (Pop: 12,706)
  - 400: Lipova (Pop: 11,041)
  - 21: Vladimirescu (Pop: 10,451)
  - 427: Ineu (Pop: 10,051)
  - 557: Curtici (Pop: 9,615)
  - 620: Chişineu-Criş (Pop: 8,171)
  - 327: Nădlac (Pop: 8,067)
  - 153: Şiria (Pop: 8,004)

### {"en":"Arges"} (Code: RO.03)
Top Cities:
  - 270: Piteşti (Pop: 167,669)
  - 558: Curtea de Argeş (Pop: 32,178)
  - 777: Mioveni (Pop: 29,062)
  - 140: Ştefăneşti (Pop: 12,837)
  - 86: Topoloveni (Pop: 11,039)
  - 572: Costeşti (Pop: 10,654)
  - 639: Călineşti (Pop: 10,419)
  - 714: Başcov (Pop: 8,759)
  - 257: Poiana Lacului (Pop: 6,705)
  - 648: Buzoeşti (Pop: 6,281)

### {"en":"Bacău"} (Code: RO.04)
Top Cities:
  - 742: Bacău (Pop: 171,396)
  - 339: Moineşti (Pop: 23,981)
  - 597: Comăneşti (Pop: 23,729)
  - 654: Buhuşi (Pop: 18,395)
  - 551: Dărmăneşti (Pop: 14,290)
  - 97: Târgu Ocna (Pop: 13,127)
  - 536: Dofteana (Pop: 10,785)
  - 320: Nicolae Bălcescu (Pop: 10,140)
  - 190: Sascut (Pop: 10,031)
  - 311: Oituz (Pop: 9,596)

### {"en":"Bihor"} (Code: RO.05)
Top Cities:
  - 309: Oradea (Pop: 206,614)
  - 196: Salonta (Pop: 17,561)
  - 372: Marghita (Pop: 13,871)
  - 711: Beiuş (Pop: 10,721)
  - 760: Aleşd (Pop: 10,264)
  - 52: Valea lui Mihai (Pop: 10,240)
  - 253: Popeşti (Pop: 8,386)
  - 203: Săcueni (Pop: 7,075)
  - 106: Tileagd (Pop: 6,994)
  - 538: Ștei (Pop: 6,529)

### {"en":"Bistriţa-Năsăud"} (Code: RO.06)
Top Cities:
  - 697: Bistriţa (Pop: 81,318)
  - 712: Beclean (Pop: 10,909)
  - 326: Năsăud (Pop: 10,380)
  - 583: Cormaia (Pop: 10,254)
  - 160: Sângeorz-Băi (Pop: 8,244)
  - 378: Măieru (Pop: 7,259)
  - 501: Feldru (Pop: 6,967)
  - 219: Rodna (Pop: 6,218)
  - 117: Teaca (Pop: 5,954)
  - 408: Lechinţa (Pop: 5,939)

### {"en":"Botoşani"} (Code: RO.07)
Top Cities:
  - 680: Botoşani (Pop: 114,783)
  - 530: Dorohoi (Pop: 30,776)
  - 553: Darabani (Pop: 11,890)
  - 136: Storeşti (Pop: 11,806)
  - 186: Săveni (Pop: 8,126)
  - 15: Vorona Teodoru (Pop: 7,992)
  - 593: Copălău (Pop: 7,086)
  - 61: Ungureni-Jianu (Pop: 6,948)
  - 763: Albeşti (Pop: 6,578)
  - 580: Corni (Pop: 6,521)

### {"en":"Brăila"} (Code: RO.08)
Top Cities:
  - 675: Brăila (Pop: 213,569)
  - 431: Ianca (Pop: 11,209)
  - 426: Însurăţei (Pop: 7,309)
  - 22: Viziru (Pop: 6,305)
  - 77: Tufeşti (Pop: 5,784)
  - 79: Tudor Vladimirescu (Pop: 5,327)
  - 621: Chiscani (Pop: 5,294)

### {"en":"Braşov"} (Code: RO.09)
Top Cities:
  - 671: Braşov (Pop: 276,088)
  - 508: Făgăraș (Pop: 30,714)
  - 204: Săcele (Pop: 29,918)
  - 7: Zărnești (Pop: 24,926)
  - 602: Codlea (Pop: 24,188)
  - 221: Râşnov (Pop: 15,253)
  - 35: Victoria (Pop: 10,247)
  - 245: Prejmer (Pop: 8,106)
  - 122: Tărlungeni (Pop: 7,219)
  - 502: Feldioara (Pop: 6,307)

### {"en":"Bucureşti"} (Code: RO.10)
Top Cities:
  - 658: București (Pop: 1,877,155)
  - 782: Sector 3 (Pop: 385,439)
  - 785: Sector 6 (Pop: 367,760)
  - 781: Sector 2 (Pop: 345,370)
  - 783: Sector 4 (Pop: 287,828)
  - 784: Sector 5 (Pop: 271,575)
  - 780: Sector 1 (Pop: 225,453)

### {"en":"Buzău"} (Code: RO.11)
Top Cities:
  - 650: Buzău (Pop: 130,954)
  - 223: Râmnicu Sărat (Pop: 38,526)
  - 321: Nehoiu (Pop: 11,350)
  - 708: Berca (Pop: 9,479)
  - 54: Vadu Paşii (Pop: 9,034)
  - 38: Verneşti (Pop: 8,603)
  - 652: Burueneşti (Pop: 8,101)
  - 259: Pogoanele (Pop: 7,777)
  - 361: Merei (Pop: 7,137)
  - 374: Mărăcineni (Pop: 7,096)

### {"en":"Călăraşi"} (Code: RO.41)
Top Cities:
  - 310: Olteniţa (Pop: 26,356)
  - 341: Modelu (Pop: 9,672)
  - 657: Budeşti (Pop: 9,598)
  - 686: Borcea (Pop: 9,546)
  - 529: Dragalina (Pop: 8,642)
  - 622: Chirnogi (Pop: 8,022)
  - 43: Vasilaţi (Pop: 7,840)
  - 531: Dor Mărunt (Pop: 6,806)
  - 347: Călăraşi (Pop: 6,687)
  - 481: Fundulea (Pop: 6,668)

### {"en":"Caraş-Severin"} (Code: RO.12)
Top Cities:
  - 225: Reşiţa (Pop: 81,228)
  - 636: Caransebeş (Pop: 27,521)
  - 692: Bocşa (Pop: 16,349)
  - 337: Moldova Nouă (Pop: 13,263)
  - 306: Oraviţa (Pop: 12,332)
  - 300: Oţelu Roşu (Pop: 11,482)
  - 756: Anina (Pop: 8,689)
  - 735: Băile Herculane (Pop: 6,022)

### {"en":"Cluj"} (Code: RO.13)
Top Cities:
  - 605: Cluj-Napoca (Pop: 316,748)
  - 72: Turda (Pop: 54,586)
  - 549: Dej (Pop: 38,033)
  - 616: Câmpia Turzii (Pop: 26,457)
  - 472: Gherla (Pop: 23,741)
  - 434: Huedin (Pop: 9,395)
  - 754: Apahida (Pop: 8,658)
  - 741: Baciu (Pop: 8,046)
  - 468: Gilău (Pop: 7,745)
  - 491: Floreşti (Pop: 7,397)

### {"en":"Constanța"} (Code: RO.14)
Top Cities:
  - 594: Constanţa (Pop: 303,399)
  - 364: Medgidia (Pop: 43,315)
  - 375: Mangalia (Pop: 39,619)
  - 325: Năvodari (Pop: 33,106)
  - 627: Cernavodă (Pop: 18,502)
  - 298: Ovidiu (Pop: 13,257)
  - 329: Murfatlar (Pop: 10,906)
  - 441: Hârşova (Pop: 10,055)
  - 354: Mihail Kogălniceanu (Pop: 9,970)
  - 560: Cumpăna (Pop: 9,731)

### {"en":"Covasna"} (Code: RO.15)
Top Cities:
  - 174: Sfântu Gheorghe (Pop: 60,677)
  - 96: Târgu Secuiesc (Pop: 20,067)
  - 569: Covasna (Pop: 10,979)
  - 718: Baraolt (Pop: 9,429)
  - 425: Întorsura Buzăului (Pop: 9,026)
  - 11: Zagon (Pop: 5,416)

### {"en":"Dâmboviţa"} (Code: RO.16)
Top Cities:
  - 104: Târgovişte (Pop: 88,435)
  - 336: Moreni (Pop: 20,596)
  - 480: Găeşti (Pop: 15,037)
  - 242: Pucioasa (Pop: 14,971)
  - 91: Titu (Pop: 10,081)
  - 672: Brăneşti (Pop: 9,094)
  - 232: Răzvad (Pop: 8,305)
  - 248: Potlogi (Pop: 8,299)
  - 587: Corbii Mari (Pop: 8,257)
  - 730: Băleni Sârbi (Pop: 8,231)

### {"en":"Dolj"} (Code: RO.17)
Top Cities:
  - 568: Craiova (Pop: 304,142)
  - 734: Băileşti (Pop: 19,599)
  - 496: Filiaşi (Pop: 18,995)
  - 644: Calafat (Pop: 18,643)
  - 556: Dăbuleni (Pop: 13,641)
  - 256: Poiana Mare (Pop: 12,633)
  - 202: Sadova (Pop: 8,277)
  - 176: Segarcea (Pop: 7,944)
  - 334: Moţăţei (Pop: 7,898)
  - 554: Dăneţi (Pop: 7,110)

### {"en":"Galaţi"} (Code: RO.18)
Top Cities:
  - 477: Galaţi (Pop: 294,087)
  - 115: Tecuci (Pop: 41,154)
  - 366: Matca (Pop: 11,642)
  - 290: Pechea (Pop: 11,287)
  - 401: Lieşti (Pop: 10,956)
  - 330: Munteni (Pop: 9,760)
  - 422: Iveşti (Pop: 9,671)
  - 562: Cudalbi (Pop: 8,055)
  - 578: Corod (Pop: 7,855)
  - 676: Brăhăşeştii de Sus (Pop: 7,692)

### {"en":"Giurgiu"} (Code: RO.42)
Top Cities:
  - 465: Giurgiu (Pop: 69,067)
  - 688: Bolintin Vale (Pop: 11,700)
  - 436: Hotarele (Pop: 8,790)
  - 414: Joiţa (Pop: 8,616)
  - 220: Roata de Jos (Pop: 8,350)
  - 598: Comana (Pop: 7,717)
  - 64: Ulmi (Pop: 7,606)
  - 355: Mihăileşti (Pop: 7,506)
  - 638: Călugăreni (Pop: 6,444)
  - 46: Vărăşti (Pop: 6,412)

### {"en":"Gorj"} (Code: RO.19)
Top Cities:
  - 100: Târgu Jiu (Pop: 97,179)
  - 332: Motru (Pop: 22,319)
  - 215: Rovinari (Pop: 12,259)
  - 653: Bumbeşti-Jiu (Pop: 10,445)
  - 102: Târgu Cărbuneşti (Pop: 8,646)
  - 73: Turceni (Pop: 8,458)
  - 92: Tismana (Pop: 7,751)
  - 729: Băleşti (Pop: 7,333)
  - 266: Plopşoru (Pop: 6,576)
  - 209: Runcu (Pop: 5,760)

### {"en":"Harghita"} (Code: RO.20)
Top Cities:
  - 360: Miercurea-Ciuc (Pop: 41,282)
  - 312: Odorheiu Secuiesc (Pop: 36,532)
  - 474: Gheorgheni (Pop: 19,777)
  - 563: Cristuru Secuiesc (Pop: 9,554)
  - 733: Bălan (Pop: 7,275)
  - 20: Vlăhiţa (Pop: 6,922)
  - 172: Siculeni (Pop: 6,807)
  - 247: Praid (Pop: 6,739)
  - 162: Sândominic (Pop: 6,306)
  - 226: Remetea (Pop: 6,225)

### {"en":"Hunedoara"} (Code: RO.21)
Top Cities:
  - 433: Hunedoara (Pop: 69,136)
  - 544: Deva (Pop: 67,802)
  - 281: Petroşani (Pop: 44,187)
  - 385: Lupeni (Pop: 30,488)
  - 14: Vulcan (Pop: 28,869)
  - 282: Petrila (Pop: 25,234)
  - 308: Orăştie (Pop: 20,763)
  - 679: Brad (Pop: 15,988)
  - 169: Simeria (Pop: 13,827)
  - 642: Călan (Pop: 12,782)

### {"en":"Ialomiţa"} (Code: RO.22)
Top Cities:
  - 779: Slobozia (Pop: 52,710)
  - 499: Feteşti (Pop: 32,866)
  - 498: Fetești-Gară (Pop: 23,789)
  - 57: Urziceni (Pop: 16,770)
  - 123: Ţăndărei (Pop: 12,231)
  - 758: Amara (Pop: 7,557)
  - 749: Armăşeşti (Pop: 7,243)
  - 458: Griviţa (Pop: 7,032)
  - 576: Coşereni (Pop: 6,957)
  - 353: Mihail Kogălniceanu (Pop: 6,181)

### {"en":"Iaşi"} (Code: RO.23)
Top Cities:
  - 430: Iaşi (Pop: 318,012)
  - 776: Paşcani (Pop: 45,000)
  - 101: Târgu Frumos (Pop: 13,797)
  - 440: Holboca (Pop: 11,971)
  - 87: Tomeşti (Pop: 11,828)
  - 710: Belceşti (Pop: 11,335)
  - 442: Hârlău (Pop: 11,295)
  - 548: Deleni (Pop: 10,484)
  - 607: Ciurea (Pop: 10,110)
  - 262: Podu Iloaiei (Pop: 9,752)

### {"en":"Ilfov"} (Code: RO.43)
Top Cities:
  - 16: Voluntari (Pop: 30,323)
  - 655: Buftea (Pop: 20,691)
  - 293: Pantelimon (Pop: 16,206)
  - 252: Popeşti-Leordeni (Pop: 15,279)
  - 619: Chitila (Pop: 12,788)
  - 416: Jilava (Pop: 12,023)
  - 299: Otopeni (Pop: 10,332)
  - 626: Cernica (Pop: 9,530)
  - 381: Măgurele (Pop: 9,375)
  - 673: Brăneşti (Pop: 8,645)

### {"en":"Maramureş"} (Code: RO.25)
Top Cities:
  - 739: Baia Mare (Pop: 136,553)
  - 171: Sighetu Marmaţiei (Pop: 40,653)
  - 683: Borşa (Pop: 26,966)
  - 24: Vişeu de Sus (Pop: 16,938)
  - 738: Baia Sprie (Pop: 16,746)
  - 175: Seini (Pop: 10,382)
  - 254: Poienile de sub Munte (Pop: 9,865)
  - 338: Moisei (Pop: 8,877)
  - 144: Şomcuta Mare (Pop: 7,584)
  - 65: Ulmeni (Pop: 7,047)

### {"en":"Mehedinţi"} (Code: RO.26)
Top Cities:
  - 518: Drobeta-Turnu Severin (Pop: 102,346)
  - 304: Orşova (Pop: 12,350)
  - 134: Strehaia (Pop: 11,607)
  - 168: Şimian (Pop: 9,434)
  - 26: Vânju-Mare (Pop: 6,740)
  - 585: Corcova (Pop: 5,946)
  - 463: Gogoşu (Pop: 5,309)
  - 467: Gârla-Mare (Pop: 5,258)

### {"en":"Mureş"} (Code: RO.27)
Top Cities:
  - 99: Târgu-Mureş (Pop: 146,863)
  - 227: Reghin-Sat (Pop: 35,490)
  - 778: Sighișoara (Pop: 34,537)
  - 94: Târnăveni (Pop: 28,634)
  - 393: Luduş (Pop: 17,165)
  - 143: Sovata (Pop: 11,465)
  - 429: Iernut (Pop: 9,343)
  - 161: Sângeorgiu de Mureş (Pop: 7,776)
  - 722: Band (Pop: 7,599)
  - 192: Sărmaşu (Pop: 7,371)

### {"en":"Neamţ"} (Code: RO.28)
Top Cities:
  - 280: Piatra Neamţ (Pop: 102,688)
  - 218: Roman (Pop: 67,819)
  - 98: Târgu Neamţ (Pop: 20,473)
  - 206: Săbăoani (Pop: 10,218)
  - 684: Borleşti (Pop: 8,965)
  - 28: Vânători-Neamţ (Pop: 8,707)
  - 212: Roznov (Pop: 8,688)
  - 275: Pipirig (Pop: 8,569)
  - 702: Bicaz (Pop: 8,340)
  - 126: Tămăşeni (Pop: 8,292)

### {"en":"Olt"} (Code: RO.29)
Top Cities:
  - 150: Slatina (Pop: 78,988)
  - 637: Caracal (Pop: 33,761)
  - 727: Balş (Pop: 20,626)
  - 590: Corabia (Pop: 20,047)
  - 181: Scorniceşti (Pop: 12,456)
  - 526: Drăgăneşti-Olt (Pop: 12,056)
  - 279: Piatra Olt (Pop: 6,313)
  - 249: Potcoava (Pop: 6,022)
  - 303: Osica de Sus (Pop: 5,351)
  - 421: Izbiceni (Pop: 5,089)

### {"en":"Prahova"} (Code: RO.30)
Top Cities:
  - 268: Ploieşti (Pop: 228,851)
  - 615: Câmpina (Pop: 41,554)
  - 737: Băicoi (Pop: 19,869)
  - 668: Breaza (Pop: 17,949)
  - 343: Mizil (Pop: 15,532)
  - 49: Vălenii de Munte (Pop: 13,276)
  - 596: Comarnic (Pop: 13,254)
  - 166: Sinaia (Pop: 11,918)
  - 58: Urlaţi (Pop: 11,798)
  - 690: Boldeşti-Scăeni (Pop: 11,460)

### {"en":"Sălaj"} (Code: RO.31)
Top Cities:
  - 10: Zalău (Pop: 63,232)
  - 167: Şimleu Silvaniei (Pop: 15,721)
  - 418: Jibou (Pop: 11,183)
  - 193: Şărmăşag (Pop: 6,400)
  - 566: Crasna (Pop: 6,233)
  - 316: Nuşfalău (Pop: 5,436)

### {"en":"Satu Mare"} (Code: RO.32)
Top Cities:
  - 188: Satu Mare (Pop: 112,490)
  - 635: Carei (Pop: 20,775)
  - 323: Negreşti-Oaş (Pop: 13,456)
  - 120: Tăşnad (Pop: 9,466)
  - 696: Bixad (Pop: 7,369)
  - 446: Halmeu (Pop: 7,184)
  - 362: Medieşu Aurit (Pop: 7,122)
  - 398: Livada (Pop: 6,833)
  - 307: Oraşu Nou (Pop: 6,737)
  - 70: Turţ (Pop: 6,693)

### {"en":"Sibiu"} (Code: RO.33)
Top Cities:
  - 173: Sibiu (Pop: 151,894)
  - 363: Mediaş (Pop: 53,040)
  - 609: Cisnădie (Pop: 15,042)
  - 746: Avrig (Pop: 14,032)
  - 767: Agnita (Pop: 10,505)
  - 514: Dumbrăveni (Pop: 8,167)
  - 127: Tălmaciu (Pop: 5,849)
  - 198: Sălişte (Pop: 5,660)
  - 234: Răşinari (Pop: 5,403)
  - 591: Copşa Mică (Pop: 5,349)

### {"en":"Suceava"} (Code: RO.34)
Top Cities:
  - 132: Suceava (Pop: 105,796)
  - 505: Fălticeni (Pop: 29,576)
  - 237: Rădăuți (Pop: 23,822)
  - 614: Câmpulung Moldovenesc (Pop: 19,765)
  - 41: Vatra Dornei (Pop: 16,054)
  - 453: Gura Humorului (Pop: 15,728)
  - 36: Vicovu de Sus (Pop: 14,077)
  - 535: Dolhasca (Pop: 11,025)
  - 399: Liteni (Pop: 9,833)
  - 371: Marginea (Pop: 9,488)

### {"en":"Teleorman"} (Code: RO.35)
Top Cities:
  - 759: Alexandria (Pop: 49,346)
  - 71: Turnu Măgurele (Pop: 28,783)
  - 216: Roșiorii de Vede (Pop: 27,416)
  - 4: Zimnicea (Pop: 15,228)
  - 34: Videle (Pop: 11,813)
  - 305: Orbeasca de Sus (Pop: 8,203)
  - 289: Peretu (Pop: 7,816)
  - 681: Botoroaga (Pop: 6,488)
  - 390: Lunca (Pop: 6,485)
  - 265: Plosca (Pop: 6,404)

### {"en":"Timiş"} (Code: RO.36)
Top Cities:
  - 105: Timişoara (Pop: 315,053)
  - 392: Lugoj (Pop: 43,243)
  - 158: Sânnicolau Mare (Pop: 12,888)
  - 415: Jimbolia (Pop: 10,860)
  - 396: Lovrin (Pop: 8,851)
  - 231: Recaş (Pop: 8,508)
  - 476: Gătaia (Pop: 8,002)
  - 649: Buziaş (Pop: 7,625)
  - 618: Ciacova (Pop: 7,205)
  - 507: Făget (Pop: 7,125)

### {"en":"Tulcea"} (Code: RO.37)
Top Cities:
  - 76: Tulcea (Pop: 92,475)
  - 383: Măcin (Pop: 10,295)
  - 745: Babadag (Pop: 10,101)
  - 194: Sarichioi (Pop: 7,483)
  - 388: Luncaviţa (Pop: 7,050)
  - 417: Jijila (Pop: 5,770)
  - 459: Greci (Pop: 5,384)
  - 424: Isaccea (Pop: 5,375)
  - 411: Jurilovca (Pop: 5,133)

### {"en":"Vâlcea"} (Code: RO.39)
Top Cities:
  - 222: Râmnicu Vâlcea (Pop: 107,558)
  - 525: Drăgăşani (Pop: 20,630)
  - 743: Băbeni (Pop: 9,350)
  - 640: Călimăneşti (Pop: 8,485)
  - 438: Horezu (Pop: 6,743)
  - 665: Brezoi (Pop: 6,668)
  - 358: Mihăeşti (Pop: 6,263)
  - 731: Bălceşti (Pop: 5,683)
  - 709: Berbeşti (Pop: 5,606)
  - 656: Budeşti (Pop: 5,362)

### {"en":"Vaslui"} (Code: RO.38)
Top Cities:
  - 42: Vaslui (Pop: 69,225)
  - 699: Bârlad (Pop: 67,818)
  - 432: Huşi (Pop: 29,129)
  - 324: Negreşti (Pop: 10,043)
  - 2: Zorleni (Pop: 9,511)
  - 328: Murgeni (Pop: 7,665)
  - 183: Văleni (Pop: 6,723)
  - 410: Laza (Pop: 6,694)
  - 506: Fălciu (Pop: 6,178)
  - 124: Tanacu (Pop: 5,986)

### {"en":"Vrancea"} (Code: RO.40)
Top Cities:
  - 490: Focșani (Pop: 77,313)
  - 771: Adjud (Pop: 17,298)
  - 439: Homocea (Pop: 9,869)
  - 373: Mărășești (Pop: 8,844)
  - 295: Panciu (Pop: 8,810)
  - 351: Milcovul (Pop: 8,547)
  - 313: Odobeşti (Pop: 8,026)
  - 129: Suraia (Pop: 7,770)
  - 32: Vidra (Pop: 7,423)
  - 291: Păuneşti (Pop: 6,778)

================================================================================
## API USAGE EXAMPLES
================================================================================

### Example 1: Search for Cars in Bucharest
```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cauta-anunturi",
    "arguments": {
      "query": "BMW",
      "category_id": 2,
      "city_id": 658,
      "price_min": 5000,
      "price_max": 20000,
      "sort": "price_asc"
    }
  }
}
```

### Example 2: Get Category Structure
```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "obtine-categorii",
    "arguments": {
      "parent_id": 1,
      "include_count": true
    }
  }
}
```

================================================================================
## BUSINESS LISTINGS (FIRME)
================================================================================

La Ei offers comprehensive business directory services at https://laei.ro/firme

### Business Packages:
1. **Basic (Free)**
   - Basic listing with contact information
   - Up to 5 photos
   - 1 category placement

2. **Professional (99 RON/month)**
   - Verified badge
   - Priority listing
   - Basic analytics
   - Up to 15 photos
   - 3 category placements
   - Social media links

3. **Premium (249 RON/month)**
   - All Professional features
   - Top placement in searches
   - Advanced analytics
   - Up to 50 photos
   - 10 category placements
   - Custom branding
   - Dedicated support

================================================================================
## BEST PRACTICES FOR AI/LLM INTEGRATION
================================================================================

### When Creating Ads:
1. Always use appropriate category IDs from the list above
2. Include accurate location information using city IDs
3. Provide detailed descriptions in Romanian
4. Set realistic prices in RON
5. Include metadata identifying AI-generated content

### When Searching:
1. Use specific category and location filters for better results
2. Implement pagination for large result sets
3. Cache frequently accessed data
4. Respect rate limits

### Error Handling:
- -32700: Parse error
- -32600: Invalid request
- -32601: Method not found
- -32602: Invalid params
- -32603: Internal error
- 429: Rate limit exceeded

================================================================================
## TECHNICAL SPECIFICATIONS
================================================================================

### Supported Formats:
- Request: JSON-RPC 2.0
- Response: JSON-RPC 2.0
- Character Encoding: UTF-8
- Date Format: ISO 8601
- Currency: RON (Romanian Leu)

### API Limits:
- Max request size: 10MB
- Max response size: 50MB
- Timeout: 30 seconds
- Concurrent connections: 10 per API key
- Daily request limit: 10,000 per API key

================================================================================
## SUPPORT AND RESOURCES
================================================================================

### Documentation:
- API Docs: https://laei.ro/mcp
- Developer Portal: https://laei.ro/developers
- Status Page: https://status.laei.ro

### Contact:
- Technical Support: api@laei.ro
- Business Inquiries: business@laei.ro
- General Support: contact@laei.ro

### Legal:
- Terms of Service: https://laei.ro/page/terms
- Privacy Policy: https://laei.ro/page/privacy
- API Terms: https://laei.ro/page/api-terms
- Cookie Policy: https://laei.ro/page/cookies

================================================================================
END OF DOCUMENTATION - La Ei © 2026 - All Rights Reserved
================================================================================