MCP Tests

🚀 Artsy Analytics MCP Server POC

This is a Model Context Protocol server that offers Artsy partner analytics tools for Claude Desktop. It is built with modelcontextprotocol/typescript-sdk.

🚀 Quick Start

This server provides a variety of analytics tools for Artsy partners. You can use these tools to gain insights into partner activities, sales performance, content performance, and audience demographics.

✨ Features

Core Analytics

• get_partner_activity_stats: Provides an overview of partner activity, including pageviews and inquiries.
• get_partner_sales_stats: Offers sales performance metrics and trends.
• get_partner_artworks_published_stats: Analyzes artwork publishing data.
• get_partner_audience_stats: Presents audience metrics and visitor counts.
• get_partner_inquiries_stats: Analyzes inquiry volume and response data.
• get_complete_partner_analytics: Offers a comprehensive analytics dashboard.
• get_partner_modern_pageviews: Provides enhanced pageview analytics with time series data.
• get_partner_time_series_analytics: Offers time series data for pageviews or artworks.
• get_partner_sales_time_series: Analyzes sales data with revenue tracking.
• get_partner_inquiry_time_series: Analyzes inquiry trends with response times.

Content Performance

• get_partner_top_artworks: Lists the top-performing artworks by views.
• get_partner_top_content: Lists the top content, including artworks, shows, artists, and viewing rooms.

Audience Insights

• get_partner_visitor_demographics: Breaks down visitors by country, device, and referral source.
• custom_graphql_query: Allows you to execute custom GraphQL queries.

📦 Installation

Install Bun

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

Install Dependencies

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 Examples

Basic Usage

You can 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?"

🔧 Technical Details

Development

During development, you can run the following commands:

bun dev

# Generate GraphQL types from schema
bun gql

Then, launch the modelcontextprotocol inspector:

bunx @modelcontextprotocol/inspector

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