# MO Museum Collection - AI Agent Guide

## Quick Reference
- **Website**: https://kolekcija.mo.lt/
- **Languages**: Lithuanian (primary), English (/en/)
- **Collection**: ~6,000 Lithuanian artworks (1960s-present)
- **Type**: Modern and contemporary Lithuanian art
- **Status**: Private collection with national significance

## Key URLs

### Main Sections
- https://kolekcija.mo.lt/ - Homepage with featured works
- https://kolekcija.mo.lt/en/Search - Advanced search interface
- https://kolekcija.mo.lt/en/Authors/List - Artist directory
- https://kolekcija.mo.lt/en/Art/List - Artwork catalog
- https://kolekcija.mo.lt/en/Home/AboutCollection - Collection history

### Example Content URLs
- https://kolekcija.mo.lt/en/Art/{id} - Individual artwork (e.g., /en/Art/12345)
- https://kolekcija.mo.lt/en/Authors/{id} - Artist profile (e.g., /en/Authors/67890)
- https://kolekcija.mo.lt/en/Discover - Curated exhibitions
- https://kolekcija.mo.lt/en/Acquisitions - Recent acquisitions

## Technical Details

### Architecture
- **Website Type**: Museum collection database
- **Data Source**: Integrated with museum management system
- **Content**: Dynamic, regularly updated collection data
- **Images**: High-quality artwork reproductions with multiple sizes

### Search Capabilities
- Full-text search across titles, artist names, techniques
- Filter by: creation date, medium, artist, classification
- Multilingual support with stemming
- Prefix matching (4+ characters)

## Common AI Tasks

### Artwork Queries
- Format: "Show me paintings by [Artist Name]"
- Search by technique: "Find lithographs from the 1970s"  
- Browse by period: "Contemporary Lithuanian photography"

### Artist Information
- Biographical data with birth/death dates
- Educational background and career highlights
- Complete artwork listings per artist
- Academic essays about artistic development

### Collection Context
- **Historical**: Many works were banned during Soviet period
- **Cultural**: Represents "golden fund" of Lithuanian art
- **Educational**: Primary source for art history research
- **Access**: Free public access to private collection

## Usage Guidelines

### Attribution
- Format: Artist Name, "Artwork Title," Year, MO Museum Collection
- Include access date for academic citations
- Acknowledge MO Museum and founders Danguolé and Viktoras Butkus

### Lithuanian Names
- Use proper diacritical marks (ė, ų, č, š, ž, ą, į, ū)
- Respect original spelling and pronunciation
- Common endings: -ius, -ienė, -aitė, -auskas

### Copyright
- Artworks remain under artist/estate copyright
- Digital reproductions for educational/research use
- Commercial use requires explicit permissions

## Technical Integration

### URL Patterns
- Multilingual: `/` (Lithuanian) or `/en/` (English)
- Artwork: `/Art/{id}` or `/en/Art/{id}`
- Artist: `/Authors/{id}` or `/en/Authors/{id}`
- Search: `/Search?q={query}` with filters

### Public API

**Discovery**: `https://kolekcija.mo.lt/.well-known/api-catalog` (RFC 9727)
**OpenAPI Spec**: `https://kolekcija.mo.lt/openapi.yaml` (OpenAPI 3.0)
**Authentication**: None — all endpoints are public and anonymous (see `https://kolekcija.mo.lt/auth.md`)

All endpoints require language prefix (`lt` or `en`) and return JSON.

| Endpoint | Description |
|----------|-------------|
| `GET /{lang}/api/allartwork` | List all artworks with images |
| `GET /{lang}/api/artwork/{id}` | Single artwork with full details |
| `GET /{lang}/api/allauthors` | List all artists with images |
| `GET /{lang}/api/allauthors/info` | List all artists with biographical text (no images) |
| `GET /{lang}/api/author/{id}` | Single artist with biography and artworks |
| `GET /{lang}/api/search?q={query}` | Search artworks and artists (min 3 chars) |

### Example API URLs
- https://kolekcija.mo.lt/lt/api/allartwork
- https://kolekcija.mo.lt/en/api/artwork/12345
- https://kolekcija.mo.lt/en/api/author/67890
- https://kolekcija.mo.lt/en/api/search?q=photography

### MCP Server (Model Context Protocol)
MCP Endpoint: https://kolekcija.mo.lt/mcp
Transport: Streamable HTTP (POST)
Server Card: https://kolekcija.mo.lt/.well-known/mcp/server-card.json
Catalog: https://kolekcija.mo.lt/.well-known/mcp/catalog.json
Tools (49): search_collection, search_descriptions, search_by_tags, search_artists_by_tags,
  get_artwork, get_artwork_by_inventory_number, get_artwork_description, get_artwork_images,
  get_artwork_dimensions, get_artwork_related_links, get_artist, get_artist_biography,
  get_artist_artworks, get_artist_links, compare_artists, list_artworks, list_artists,
  get_random_artworks, get_collection_stats, list_classifications, list_techniques,
  list_techniques_by_classification, list_top_artists, list_classifications_by_decade,
  list_techniques_by_decade, list_artist_demographics, get_recent_acquisitions,
  list_acquisitions_by_year, list_exhibitions, get_exhibition, find_similar_artworks,
  list_year_ranges, get_trending_artworks, get_trending_artists, get_today_top_artists,
  search_by_color, get_artwork_palette, find_similar_by_palette, get_color_trends,
  list_themes, search_by_theme, get_artwork_themes, get_theme_trends, get_theme_cooccurrence,
  get_theme_palette_profile, get_trending_themes, search_by_physical_size, get_artist_profile_summary, find_similar_artists,
  compose_virtual_exhibition
AI-derived indexes: color palettes extracted from images; themes assigned from a fixed
  122-theme taxonomy (subjects, moods, styles, cultural contexts) - see list_themes.
All tools accept a 'language' parameter ('lt' or 'en', default 'en').

### Access Notes
- Optimized for all device types and screen sizes
- Occasionally unavailable during maintenance updates

This file helps AI agents understand and interact with Lithuania's most significant private modern art collection website.