Artsy Analytics MCP Server POC

Model Context Protocol server providing Artsy partner analytics tools for Claude Desktop. Built with modelcontextprotocol/typescript-sdk.

Available Tools

Core Analytics

• get_partner_activity_stats - Partner activity overview with pageviews and inquiries
• get_partner_sales_stats - Sales performance metrics and trends
• get_partner_artworks_published_stats - Artwork publishing analytics
• get_partner_audience_stats - Audience metrics and visitor counts
• get_partner_inquiries_stats - Inquiry volume and response analytics
• get_complete_partner_analytics - Comprehensive analytics dashboard
• get_partner_modern_pageviews - Enhanced pageview analytics with time series
• get_partner_time_series_analytics - Time series data for pageviews or artworks
• get_partner_sales_time_series - Sales analytics with revenue tracking
• get_partner_inquiry_time_series - Inquiry trends with response times

Content Performance

• get_partner_top_artworks - Top-performing artworks by views
• get_partner_top_content - Top content (artworks, shows, artists, viewing rooms)

Audience Insights

• get_partner_visitor_demographics - Visitor breakdowns by country, device, referral
• custom_graphql_query - Execute custom GraphQL queries

Setup

• Install Bun

curl -fsSL https://bun.sh/install | bash

• Install deps

git clone https://github.com/damassi/mcp-tests.git
cd mcp-tests
bun install

• Sync GraphQL schema:

bun sync-schema

• Configure Claude Desktop MCP settings:

code ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "artsy-analytics": {
      "command": "/Users/<user-name>/.bun/bin/bun",
      "args": ["/path/to/mcp/src/mcp-server.ts"],
      "env": {
        "CLAUDE_DESKTOP": "true",
        "METAPHYSICS_ENDPOINT": "your_endpoint",
        "USER_ID": "your_user_id",
        "X_ACCESS_TOKEN": "your_token"
      }
    }
  }
}

• Restart Claude Desktop

Usage

Ask Claude questions like:

• "Show visitor demographics for pace-gallery"
• "Get sales trends for hauser-wirth over 16 weeks"
• "What are the top artworks for gagosian-gallery?"

Development

When developing, can run

bun dev

# Generate GraphQL types from schema
bun gql

Then launch the modelcontextprotocol inspector:

bunx @modelcontextprotocol/inspector

Make sure the setup looks like the below, and (critical!) be sure to add correct Environment Variables as seen in .env.example:

<img width="1512" height="828" alt="Image" src="https://github.com/user-attachments/assets/f33ce877-eedc-473c-a5a4-cf05637d619b" />