Skip to main content
The Model Context Protocol (MCP) is an open standard for connecting AI applications to external systems—think of it as a USB-C port for AI. Our Analytics MCP server gives your AI assistants direct access to Topsort’s advertising analytics and catalog APIs.
Looking for documentation access instead? Check out our Documentation MCP Server for AI-assisted API integration guidance.

​
What You Can Do

By connecting to Topsort’s Analytics MCP server, AI assistants can:
  • Analyze advertising performance - Query real-time metrics like CTR, CVR, ROAS, CPC, and ad spend across campaigns or marketplaces
  • Monitor campaign health - Check budget utilization, bidding behavior, quality scores, and pacing in real-time
  • Compare performance over time - Run week-over-week, month-over-month, or custom period comparisons to identify trends and anomalies
  • Benchmark against industry - Compare campaign metrics against category benchmarks (retail, pharmacy, travel, etc.)
  • Visualize insights - Generate line, bar, and pie charts from any analytics data for easy interpretation
  • Get Topsort guidance - Answer questions about API integration, troubleshooting, and platform best practices
All queries can be scoped to a specific vendor, ensuring advertisers only access their own data while marketplace operators can view aggregate insights.

​
Quick Start

Our Analytics MCP server is available at: 
https://mcp-server.api.topsort.ai/mcp
This MCP server requires authentication. Contact your Topsort sales representative to request an API key with MCP Server access.

​
Authentication

​
Marketplace Authentication

All requests must include a valid API key in the headers: 
{
  "mcpServers": {
    "topsort-analytics": {
      "url": "https://mcp-server.api.topsort.ai/mcp",
      "headers": {
        "X-API-Key": "MPS_xxxx"
      }
    }
  }
}

​
Vendor ID Filtering

Tool results can be filtered for specific vendors by including the Vendor ID in the request header. This restricts the scope of all tools, preventing data leakage across vendors: 
{
  "mcpServers": {
    "topsort-analytics": {
      "url": "https://mcp-server.api.topsort.ai/mcp",
      "headers": {
        "X-API-Key": "MPS_xxxx",
        "X-Vendor-Id": "1111-2222-3333-4444-55555"
      }
    }
  }
}

​
Tool Filtering

Tags enable fine-grained access control over which tools are available to different clients. Each tool can be annotated with one or more tags, and clients are assigned their own set of tags. When retrieving tools, the system filters the list by checking for any overlap between the client’s tags and each tool’s required tags—a client only needs one matching tag to gain access.

​
Integration Guides

ChatGPT

Connect ChatGPT to Topsort analytics

Claude Desktop

Configure Claude Desktop with authentication

Postman

Test the MCP server with Postman

​
ChatGPT

ChatGPT supports remote MCP servers for Plus and Team subscribers.
1

Open ChatGPT Settings

Navigate to chat.openai.com and click your profile icon, then select Settings.
2

Access Connections

Click on Connections or Integrations in the settings sidebar.
3

Add MCP Server

Click Add Connection and enter:
  • Name: Topsort Analytics
  • Server URL: https://mcp-server.api.topsort.ai/mcp
  • Transport Type: http
  • Headers: Add X-API-Key with your API key

​
Claude Desktop

Claude Desktop provides comprehensive local MCP support.
1

Open Claude Desktop Settings

  • macOS: Click Claude in the menu bar → Settings
  • Windows: Click File → Settings
2

Navigate to Developer Tab

Click on the Developer tab in the left sidebar.
3

Edit MCP Configuration

Click Edit Config and add:
{
  "mcpServers": {
    "topsort-analytics": {
      "type": "http",
      "url": "https://mcp-server.api.topsort.ai/mcp",
      "headers": {
        "X-API-Key": "MPS_xxxx"
      }
    }
  }
}
For vendor-scoped access, add the X-Vendor-Id header as shown in the Vendor ID Filtering section.
4

Restart Claude Desktop

Save the configuration and restart Claude Desktop.

​
Postman

You can test the Analytics MCP server using Postman’s MCP support.
1

Open Postman

Launch Postman and navigate to Settings → MCP Servers.
2

Add New Server

Click Add Server and configure:
  • Name: Topsort Analytics
  • URL: https://mcp-server.api.topsort.ai/mcp
3

Configure Headers

Add the required headers:
  • X-API-Key: Your Topsort API key
  • X-Vendor-Id: (Optional) Vendor ID for scoped access
4

Test Connection

Click Test Connection to verify the server is responding correctly.

​
Troubleshooting

​
Connection Issues

  • Verify the URL is correct: https://mcp-server.api.topsort.ai/mcp
  • Ensure your API key is valid and has MCP Server access
  • Check your internet connection
  • Restart your MCP client application

​
Authentication Errors

  • Confirm your API key starts with MPS_
  • Verify the X-API-Key header is correctly formatted
  • Contact your Topsort sales representative if your key is rejected

​
Server Not Responding

  • Verify the transport type is set to http
  • Check if your firewall or VPN is blocking the connection
  • Check our status page for any service disruptions

​
Learn More