MCP Tools

Complete reference for all tools available on the Artland MCP server.

artland_sync_artwork

Create or update an artwork.

Input:

{
  "title": "Composition in Blue",
  "creation_year": 2024,
  "medium": "Oil on canvas",
  "dimensions": "120 × 90 cm",
  "price": 45000,
  "currency": "EUR",
  "availability": "available",
  "description": "Part of the Chromatic Series...",
  "image_url": "https://gallery.example.com/artworks/composition-blue.jpg",
  "external_url": "https://gallery.example.com/artworks/composition-blue",
  "artist_name": "Maria Schmidt"
}

Example prompt: “Sync my latest artwork: ‘Composition in Blue’, oil on canvas, 120x90cm, 2024, by Maria Schmidt”

artland_list_artworks

List artworks for your entity.

Input:

{
  "page": 1,
  "limit": 50
}

Example prompt: “Show me all my artworks”

artland_sync_artist

Create or update a represented artist (gallery keys only).

Input:

{
  "name": "Maria Schmidt",
  "nationality": "German",
  "birth_year": 1985,
  "biography": "Contemporary abstract artist...",
  "external_url": "https://mariaschmidt.com"
}

Example prompt: “Add Maria Schmidt as a represented artist — German, born 1985”

artland_list_artists

List represented artists.

Input:

{
  "page": 1,
  "limit": 50
}

Example prompt: “List all my represented artists”

artland_sync_event

Create or update an event.

Input:

{
  "title": "Spring Exhibition",
  "event_type": "exhibition",
  "description": "Annual spring group show...",
  "location_city": "Zurich",
  "location_country": "CH",
  "start_date": "2026-04-15",
  "end_date": "2026-05-30",
  "external_url": "https://gallery.example.com/spring-2026",
  "image_url": "https://gallery.example.com/spring-hero.jpg",
  "ical_url": "https://gallery.example.com/calendar.ics"
}

Example prompt: “Create an exhibition: Spring Exhibition, April 15 – May 30 2026, in Zurich”

artland_list_events

List events.

Input:

{
  "page": 1,
  "limit": 50,
  "upcoming": true
}

Example prompt: “What upcoming events do I have?“

artland_get_profile

Get your entity profile.

Input: {} (no parameters)

Example prompt: “Show my Artland profile”

artland_update_profile

Update profile fields.

Input:

{
  "description": "Contemporary art gallery in Zurich...",
  "external_url": "https://gallery.example.com",
  "ical_url": "https://gallery.example.com/calendar.ics",
  "social_instagram": "https://instagram.com/gallery",
  "social_twitter": "https://x.com/gallery"
}

Example prompt: “Update my gallery description to mention we specialize in contemporary art”

artland_search

Search across all Artland entities.

Input:

{
  "q": "abstract",
  "type": "artists",
  "page": 1,
  "limit": 50
}

Example prompt: “Search Artland for abstract artists”

artland_get_changelog

Get recent changes for your entity.

Input:

{
  "page": 1,
  "limit": 100,
  "since": "2026-06-15T00:00:00Z"
}

Example prompt: “What changed in my Artland data this week?“

artland_get_sync_status

Get last sync timestamps per entity type.

Input: {} (no parameters)

Example prompt: “When was my data last synced?”