Skip to main content

Model Context Protocol server for Sealmetrics analytics - query traffic, conversions, and marketing data with AI assistants

Project description

Sealmetrics MCP Server

A Model Context Protocol (MCP) server that connects AI assistants like Claude to your Sealmetrics analytics data. Query traffic, conversions, and marketing performance using natural language.

Features

  • Traffic Analysis: Query traffic by source, medium, campaign, or country
  • Conversions: Get sales and conversion data with attribution
  • Microconversions: Track add-to-cart, signups, and other engagement events
  • Funnel Analysis: Analyze conversion funnel performance
  • ROAS Evolution: Track return on ad spend over time
  • Page Performance: Analyze page views and landing page effectiveness
  • Pixel Generation: Generate tracking pixels for Google Tag Manager

Installation

Using uvx (Recommended)

uvx sealmetrics-mcp

Using pip

pip install sealmetrics-mcp

Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sealmetrics": {
      "command": "uvx",
      "args": ["sealmetrics-mcp"],
      "env": {
        "SEALMETRICS_API_TOKEN": "your-api-token-here",
        "SEALMETRICS_ACCOUNT_ID": "your-account-id-here"
      }
    }
  }
}

Environment Variables

Variable Required Description
SEALMETRICS_API_TOKEN Yes* Your Sealmetrics API token (recommended)
SEALMETRICS_ACCOUNT_ID No Default account ID for queries
SEALMETRICS_EMAIL Yes* Email for login (alternative to token)
SEALMETRICS_PASSWORD Yes* Password for login (alternative to token)

*Either SEALMETRICS_API_TOKEN or both SEALMETRICS_EMAIL and SEALMETRICS_PASSWORD are required.

Available Tools

Tool Description
get_accounts List available Sealmetrics accounts
get_traffic_data Traffic by source, medium, campaign
get_conversions Sales and conversion data
get_microconversions Add-to-cart, signups, etc.
get_funnel_data Conversion funnel analysis
get_roas_evolution ROAS over time
get_pages_performance Page views and landing pages
generate_conversion_pixel Generate tracking pixel code

Example Queries

Once configured, you can ask Claude questions like:

  • "How much traffic did we get from Google Ads yesterday?"
  • "Show me conversions from organic search this month"
  • "What's our ROAS evolution for the last 30 days?"
  • "Which landing pages are performing best?"
  • "Generate a conversion pixel for newsletter signups"

Getting Your API Token

  1. Log in to your Sealmetrics dashboard
  2. Go to Settings > API
  3. Generate a new API token
  4. Copy the token to your Claude Desktop configuration

Support

License

MIT License - see LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sealmetrics_mcp-0.2.0.tar.gz (14.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sealmetrics_mcp-0.2.0-py3-none-any.whl (20.3 kB view details)

Uploaded Python 3

File details

Details for the file sealmetrics_mcp-0.2.0.tar.gz.

File metadata

  • Download URL: sealmetrics_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 14.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for sealmetrics_mcp-0.2.0.tar.gz
Algorithm Hash digest
SHA256 87d88301a57ed5dc349b7706b6282d377cb40da93ded4ce0a36a2374b1c361c9
MD5 e749ac1027972a9417b0d14fb2704c46
BLAKE2b-256 8614049c01a80f69479b27fb3d10397fac975bb51d46228da2cff3af2175ed17

See more details on using hashes here.

File details

Details for the file sealmetrics_mcp-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for sealmetrics_mcp-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 790bc056fd44a0329f0c418e3aec004b379879d8122f3e57b65a38b48cbc7422
MD5 b04a266c7c411e4d97ddea5740bb57b7
BLAKE2b-256 dd206e3d6112cb0bf782d8bd35fe7ae9edd97691d4500ed9fa7610d44839c8a1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page