Enables execution of custom GraphQL queries against the Artsy API to retrieve specialized analytics data beyond the pre-built tools.
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
- Install deps
- Sync GraphQL schema:
- Configure Claude Desktop MCP settings:
- 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
Then launch the modelcontextprotocol
inspector:
Make sure the setup looks like the below, and (critical!) be sure to add correct Environment Variables
as seen in .env.example
:
Tools
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.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that allows Claude to interact with Linear's API for managing teams, issues, projects, and cycles.Last updated -182MIT License
- -securityFlicense-qualityA 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 -
- AsecurityAlicenseAqualityA 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 -19411ISC License
- -securityAlicense-qualityA 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 -36MIT License