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
- Log in to your Sealmetrics dashboard
- Go to Settings > API
- Generate a new API token
- Copy the token to your Claude Desktop configuration
Support
- Documentation: https://sealmetrics.com/docs
- Issues: https://github.com/sealmetrics/mcp-server/issues
- Email: support@sealmetrics.com
License
MIT License - see LICENSE file for details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
87d88301a57ed5dc349b7706b6282d377cb40da93ded4ce0a36a2374b1c361c9
|
|
| MD5 |
e749ac1027972a9417b0d14fb2704c46
|
|
| BLAKE2b-256 |
8614049c01a80f69479b27fb3d10397fac975bb51d46228da2cff3af2175ed17
|
File details
Details for the file sealmetrics_mcp-0.2.0-py3-none-any.whl.
File metadata
- Download URL: sealmetrics_mcp-0.2.0-py3-none-any.whl
- Upload date:
- Size: 20.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.13.1
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
790bc056fd44a0329f0c418e3aec004b379879d8122f3e57b65a38b48cbc7422
|
|
| MD5 |
b04a266c7c411e4d97ddea5740bb57b7
|
|
| BLAKE2b-256 |
dd206e3d6112cb0bf782d8bd35fe7ae9edd97691d4500ed9fa7610d44839c8a1
|