Skip to main content
Glama

Artsy Analytics MCP Server

by damassi

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:

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

A Model Context Protocol server that provides Artsy partner analytics tools for Claude Desktop, allowing users to query gallery metrics, sales data, audience insights, and content performance through natural language.

  1. Available Tools
    1. Core Analytics
    2. Content Performance
    3. Audience Insights
  2. Setup
    1. Usage
      1. Development

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.
          Last updated -
          18
          2
          MIT License
        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that allows Claude to make API requests on your behalf, providing tools for testing various APIs including HTTP requests and OpenAI integrations without sharing your API keys in the chat.
          Last updated -
          • Linux
          • Apple
        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol server that allows AI assistants like Claude to integrate with Printify's print-on-demand platform, enabling product creation, management, and AI-generated design uploads through natural language commands.
          Last updated -
          19
          4
          11
          ISC License
          • Linux
          • Apple
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables AI assistants like Claude to track events, page views, user signups, set user properties, and track revenue in Amplitude analytics.
          Last updated -
          3
          6
          MIT License

        View all related MCP servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/damassi/mcp-tests'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server