MCP Overview

Artland provides an MCP (Model Context Protocol) server that lets AI assistants interact with your Artland data using natural language.

What is MCP?

MCP is an open protocol that allows AI models to use external tools. Instead of writing code or curl commands, you can ask an AI assistant to sync your artworks, check your catalog, or update your profile — and it calls the Artland API for you.

How It Works

Your AI Assistant (Claude, Cursor, etc.)
        │
        ▼
   MCP Client  ──→  Artland MCP Server  ──→  Artland API
        │
        ▼
   Tool Results

The MCP server exposes 11 tools that map directly to REST endpoints:

Tool	REST Equivalent
`artland_sync_artwork`	`POST /v1/artworks`
`artland_list_artworks`	`GET /v1/artworks`
`artland_sync_artist`	`POST /v1/artists`
`artland_list_artists`	`GET /v1/artists`
`artland_sync_event`	`POST /v1/events`
`artland_list_events`	`GET /v1/events`
`artland_get_profile`	`GET /v1/profile`
`artland_update_profile`	`PUT /v1/profile`
`artland_search`	`GET /v1/search`
`artland_get_changelog`	`GET /v1/changelog`
`artland_get_sync_status`	`GET /v1/sync/status`

Server Endpoints

SSE:  https://api.artland.com/v1/mcp/sse
POST: https://api.artland.com/v1/mcp/message

Authentication

The MCP server uses the same API keys as the REST API. Pass your key in the connection headers:

{
  "headers": {
    "Authorization": "Bearer *** **[MCP Tools](/mcp/tools)** for detailed input schemas and examples.
- **[Client Setup](/mcp/client-setup)** for configuration guides.